Se você deseja veicular conteúdo de vários serviços ou vários servidores do mesmo domínio, você pode configurar seu servidor da Web para atuar como um proxy reverso. Os serviços (muitas vezes chamados de servidor backend ou servidor de aplicação ) não precisam necessariamente ser acessados ​​diretamente do cliente, é comum que apenas o servidor web que realmente atende o cliente seja alcançável diretamente. Também é possível ter esquemas ou protocolos diferentes (http, https, ajp, ...) entre cliente e servidor e entre servidor e backend.

Client ---[https]---> Server ---[http]---> backend:8080
                       |
                       |---[direct]---> files from document root
                       `---[http]---> localhost:4000

Exemplos

• https://example.com/ -> servido diretamente do servidor web
• https://example.com/jenkins/ -> proxy para um servidor diferente acessível a partir do servidor web
• https://api.example.com/ -> proxy para um serviço com uma porta diferente no mesmo host

O proxy reverso pode ser configurado como diretórios virtuais ou como subdomínios.

Configuração de exemplo para Apache

Você precisa carregar os módulos apache necessários para poder usá-lo como proxy reverso. Estes são pelo menos:

• procurador
• proxy_http

Para mais protocolos, você precisará habilitar mais módulos.

Você pode habilitar os módulos com distribuições baseadas em Debian/Ubuntu como esta:

sudo a2enmod proxy proxy_http

Com distribuições baseadas em RedHat/CentOS, você precisará encontrar os arquivos de configuração adequados /etc/httpd/e habilitar os módulos manualmente.

Uma configuração para os exemplos acima pode ser assim:

<VirtualHost *:443>
  ServerName example.com
  DocumentRoot /var/www/html
  
  # SSL options left out for simplicity
  
  ProxyRequests         Off
  ProxyPreserveHost     On
  ProxyPass               /jenkins/ http://192.168.42.18:8080/
  ProxyPassReverse        /jenkins/ http://192.168.42.18:8080/
</VirtualHost>

<VirtualHost *:443>
  ServerName api.example.com
  DocumentRoot /var/www/html
  
  # SSL options left out for simplicity

  ProxyRequests         Off
  ProxyPreserveHost     On
  ProxyPass               / http://localhost:4000/
  ProxyPassReverse        / http://localhost:4000/
</VirtualHost>

Configuração de exemplo para nginx

server {
  listen 443;
  server_name example.com;
  root /var/www/html;
  
  # SSL options left out for simplicity

  location /jenkins/ {
    proxy_pass http://192.168.42.18:8080/;
  }
}

server {
  listen 443;
  server_name api.example.com;
  
  # SSL options left out for simplicity
  
  location / {
    proxy_pass http://localhost:4000/;
  }
}

Configuração de back-end

Uma coisa a ter em mente é que o servidor de back-end deve ser configurado de acordo. Se, por exemplo, o Jenkins estiver configurado para atender a solicitações com a URL http://192.168.42.18:8080/, ele usará essa URL base para caminhos para arquivos CSS, JS e de imagem, resultando em muitos erros 404 ou tempos limite e um servidor inoperante. Ele deve ser configurado com a URL do proxy https://example.com/jenkins/como URL base para que funcione.

Outros back-ends exigem uma configuração semelhante. Este é o método preferencial para resolver problemas com URLs apontando para o servidor back-end em vez do servidor front-end. Se por algum motivo não for possível alterar a configuração do servidor back-end, você pode configurar o servidor front-end para reescrever o HTML antes de servi-lo ao cliente.

No entanto, isso deve ser visto como um método de último recurso, pois adiciona carga desnecessária ao servidor front-end.

Apache

Com o Apache você pode usar o módulo mod_proxy_html. Este módulo fornece a diretiva ProxyHTMLURLMap, que você pode usar para reescrever a resposta.

ProxyPass               /jenkins/ http://192.168.42.18:8080/
ProxyPassReverse        /jenkins/ http://192.168.42.18:8080/
SetOutputFilter proxy-html # make sure the output is filtered by proxy-html
ProxyHTMLURLMap http://192.168.42.18:8080/ https://example.com/jenkins/
ProxyHTMLExtended On       # by default only HTML output is filtered

Isso deve reescrever todas as ocorrências da URL do servidor local na resposta com a URL publichostname.

nginx

Com o nginx, um resultado semelhante pode ser obtido com o ngx_http_sub_module :

  location /jenkins/ {
    proxy_pass http://192.168.42.18:8080/;
    sub_filter '<a href="http://192.168.42.18:8080/'  '<a href="https://$host/jenkins/';
    sub_filter_once on;
  }