Pular para o conteúdo principal

Como usar o ONLYOFFICE Docs atrás de um servidor proxy

Introdução​

ONLYOFFICE Docs funciona como aplicativo online e frequentemente precisa ser integrado em redes internas. Muitas redes usam diferentes servidores web como proxy para determinados propósitos hoje. Assim, é importante tornar o ONLYOFFICE Docs funcional atrás do proxy. Os servidores web mais difundidos são NGINX e Apache, cuja popularidade é causada por sua flexibilidade, velocidade e poder. Outro servidor web bem conhecido é o HAProxy, que foi originalmente projetado para funcionar como um balanceador de carga. O Træfik também é um proxy reverso e balanceador de carga moderno e popular. Este artigo oferece exemplos de configuração prontos para executar o ONLYOFFICE Docs atrás desses quatro servidores proxy.

Para tornar o ONLYOFFICE Docs acessível para hosts do lado do cliente, você precisa configurar cabeçalhos HTTP encaminhados. Seu objetivo é manter informações sobre o cliente enquanto a solicitação vai para o servidor através do proxy. Você precisa configurar dois tipos de cabeçalhos HTTP: X-Forwarded-Proto e X-Forwarded-Host. O cabeçalho X-Forwarded-Proto é um cabeçalho padrão de fato para identificar o protocolo (HTTP ou HTTPS) que um cliente usou para se conectar ao proxy ou balanceador de carga. O X-Forwarded-Host é um cabeçalho padrão para identificar o host original solicitado pelo cliente no cabeçalho de solicitação HTTP Host.

Pode haver três cenários principais quando você precisa configurar o proxy. Aqui estão os exemplos de como isso pode ser realizado.

Cenário comum (proxy para servidor local)​

Este cenário é usado quando você precisa simplesmente redirecionar o tráfego de saída para o servidor local:

Proxy para servidor local

Aqui estão as configurações prontas para proxy:

Proxy HTTPS para HTTP​

Este cenário é usado quando você precisa proteger a conexão para que todas as solicitações sejam automaticamente redirecionadas para HTTPS:

Proxy HTTPS para HTTP

Aqui estão as configurações prontas para proxy:

Caminho virtual​

Este é um cenário adequado quando você precisa mapear algum diretório em seu host para o caminho especificado no servidor web:

Proxy para um caminho virtual

Aqui estão as configurações prontas para proxy: