
Servidor HTTP(S) de borda leve e proxy reverso com SSL automático, descoberta Docker/Consul, autenticação por rota, limitação de taxa e failover baseado em verificação de integridade.
Reproxy é um servidor HTTP(s) de borda simples / proxy reverso que suporta vários provedores (docker, estático, arquivo, catálogo consul). Um ou mais provedores fornecem informações sobre o servidor solicitado, a URL solicitada, a URL de destino e a URL de verificação de integridade. É distribuído como um único binário ou como um contêiner docker.
O servidor (host) pode ser definido como FQDN, ou seja, s.example.com, * (catch all) ou uma regex. A correspondência exata tem prioridade, então se houver duas regras com servidores example.com e example\.(com|org), a requisição para example.com/some/url corresponderá à primeira. A URL solicitada pode ser uma regex, por exemplo ^/api/(.*), e a URL de destino pode conter grupos correspondentes da regex, ou seja, http://d.example.com:8080/$1. Para o exemplo acima, http://s.example.com/api/something?foo=bar será encaminhado para http://d.example.com:8080/something?foo=bar.
Nomes de servidor exatos e *.example.com correspondem ao host sem diferenciar maiúsculas de minúsculas e ignoram um ponto final, então Admin.Example.com e admin.example.com. correspondem a uma regra admin.example.com. Servidores regex correspondem conforme escritos, então adicione (?i) quando maiúsculas e minúsculas não devem importar. As regexes de rota correspondem ao caminho da requisição escapado, onde um espaço é %20 e ü é %C3%BC, enquanto prefixos de assets estáticos podem ser escritos como texto simples. As regexes de rota diferenciam maiúsculas de minúsculas: quando uma rota protegida fica na frente de um upstream que trata caminhos sem diferenciar maiúsculas de minúsculas, adicione (?i) a essa rota.
Por conveniência, requisições com a barra final / e sem grupos regex são expandidas para /(.*), e os destinos nesses casos são expandidos para /$1. Ou seja, /api/ -> http://127.0.0.1/service será traduzido para ^/api/(.*) -> http://127.0.0.1/service/$1.
Antes da correspondência de rotas, o reproxy rejeita com 400 uma requisição cujo caminho decodificado contenha um segmento . ou .., barras repetidas (//), um ; ou uma barra invertida. Uma única barra final é permitida.
A substituição de host é suportada na URL de destino. Por exemplo, /files/${host} será substituído pelo nome do host correspondido. $host (sem chaves) também pode ser usado.
Grupos de um servidor regex podem ser usados na URL de destino como ${host.1}, ${host.2} e assim por diante (chaves obrigatórias). Por exemplo, o servidor ^([^.]+)\.example\.com$ com a rota ^/(.*)$ e o destino https://${host.1}.foo.com/$1 faz proxy de http://aaaa.example.com/some para https://aaaa.foo.com/some. $1, $2 continuam se referindo aos grupos da rota. Um grupo ausente é substituído por uma string vazia, e o mesmo ocorre com qualquer ${host.N} para um servidor exato, * ou *.example.com, pois estes não possuem grupos. Os valores de host são inseridos como estão, sem escape de URL, portanto mantenha os grupos do servidor restritos: ancore a regex com ^ e $, e capture apenas o que um rótulo de host pode conter, ou seja, ([a-z0-9-]+) em vez de (.*), que também corresponderia a .. de um host como ...example.com. Antes da correspondência de rotas, o reproxy rejeita cabeçalhos Host contendo caracteres não permitidos pela validação de cabeçalho de host HTTP ou contendo %, retornando 400. Quando um token de host segue diretamente um grupo de rota, escreva o grupo com chaves, ou seja, ${1}${host.1}, pois $1aaaa seria lido como um grupo chamado 1aaaa.
Tanto HTTP quanto HTTPS são suportados. Para HTTPS, certificado estático pode ser usado, bem como certificados ACME automatizados (Let's Encrypt). Um servidor de assets opcional pode ser usado para servir arquivos estáticos. Iniciar o reproxy requer pelo menos um provider definido. O restante dos parâmetros é estritamente opcional e possui padrões sensatos.
Exemplos:
reproxy --static.enabled --static.rule="*,example.com/api/(.*),https://api.example.com/$1"reproxy --docker.enabled --docker.autodocker up -p 80:8080 umputun/reproxy --docker.enabled --docker.autodocker up -p 80:8080 -p 443:8443 umputun/reproxy --docker.enabled --docker.auto --ssl.type=auto --ssl.fqdn=example.comO Reproxy é distribuído como um pequeno binário autocontido, bem como uma imagem docker. Tanto o binário quanto a imagem suportam múltiplas arquiteturas e múltiplos sistemas operacionais, incluindo linux_x86_64, linux_arm64, linux_arm, macos_x86_64, macos_arm64, windows_x86_64 e windows_arm. Também fornecemos pacotes deb e rpm para arm64 e x86.
brew install umputun/apps/reproxydocker pull umputun/reproxy ou docker pull ghcr.io/umputun/reproxy.A versão estável mais recente possui a tag docker :vX.Y.Z (com o alias :latest) e o master atual possui a tag :master.
Regras de proxy fornecidas por vários providers. Atualmente incluídos - file, docker, static e consul-catalog. Cada provider pode definir múltiplas regras de roteamento tanto para requisições proxiadas quanto para estáticos (assets). O usuário pode definir múltiplos providers ao mesmo tempo.
Veja exemplos de vários providers em examples