
Server HTTP(S) leggero perimetrale e reverse proxy con SSL automatico, discovery Docker/Consul, autenticazione per route, limitazione del tasso e failover basato su health check.
Reproxy è un semplice server HTTP(s) edge / reverse proxy che supporta vari provider (docker, static, file, consul catalog). Uno o più provider forniscono informazioni sul server richiesto, sull'URL richiesto, sull'URL di destinazione e sull'URL di health check. È distribuito come singolo binario o come container docker.
Il server (host) può essere impostato come FQDN, ad esempio s.example.com, * (catch all) o una regex. La corrispondenza esatta ha la priorità, quindi se ci sono due regole con server example.com e example\.(com|org), una richiesta a example.com/some/url corrisponderà alla prima. L'URL richiesto può essere una regex, ad esempio ^/api/(.*), e l'URL di destinazione può contenere gruppi corrispondenti alla regex, ad esempio http://d.example.com:8080/$1. Per l'esempio precedente http://s.example.com/api/something?foo=bar verrà inoltrato tramite proxy a http://d.example.com:8080/something?foo=bar.
I nomi server esatti e *.example.com corrispondono all'host senza distinzione tra maiuscole e minuscole e ignorano un punto finale, quindi Admin.Example.com e admin.example.com. corrispondono a una regola admin.example.com. I server regex corrispondono così come sono scritti, quindi aggiungi (?i) quando il caso non deve contare. Le regex delle rotte corrispondono al percorso della richiesta con escape, dove uno spazio è %20 e ü è %C3%BC, mentre i prefissi degli asset statici possono essere scritti come testo semplice. Le regex delle rotte sono sensibili al caso: quando una rotta protetta si trova davanti a un upstream che tratta i percorsi senza distinzione tra maiuscole e minuscole, aggiungi (?i) a quella rotta.
Per comodità, le richieste con / finale e senza gruppi regex vengono espanse a /(.*), e le destinazioni in quei casi vengono espanse a /$1. Ad esempio, /api/ -> http://127.0.0.1/service verrà tradotto in ^/api/(.*) -> http://127.0.0.1/service/$1.
Prima della corrispondenza delle rotte, reproxy rifiuta con 400 una richiesta il cui percorso decodificato contiene un segmento . o .., slash ripetuti (//), un ; o un backslash. È consentito un singolo slash finale.
La sostituzione dell'host è supportata nell'URL di destinazione. Ad esempio, /files/${host} verrà sostituito con il nome dell'host corrispondente. È possibile utilizzare anche $host (senza parentesi graffe).
I gruppi di un server regex possono essere usati nell'URL di destinazione come ${host.1}, ${host.2} e così via (le parentesi graffe sono obbligatorie). Ad esempio, il server ^([^.]+)\.example\.com$ con route ^/(.*)$ e destinazione https://${host.1}.foo.com/$1 inoltra http://aaaa.example.com/some a https://aaaa.foo.com/some. $1, $2 continuano a riferirsi ai gruppi della route. Un gruppo mancante viene sostituito con una stringa vuota, e lo stesso vale per qualsiasi ${host.N} per un server esatto, * o *.example.com, poiché questi non hanno gruppi. I valori dell'host vengono inseriti così come sono, senza escaping URL, quindi mantieni i gruppi del server rigorosi: ancora la regex con ^ e $, e cattura solo ciò che può contenere un'etichetta host, cioè ([a-z0-9-]+) invece di (.*), che corrisponderebbe anche a .. da un host come ...example.com. Prima della corrispondenza delle route, reproxy rifiuta gli header Host contenenti caratteri non consentiti dalla validazione degli header host HTTP o contenenti %, restituendo 400. Quando un token host segue direttamente un gruppo di route, scrivi il gruppo con le parentesi graffe, cioè ${1}${host.1}, poiché $1aaaa verrebbe letto come un gruppo chiamato 1aaaa.
Sono supportati sia HTTP che HTTPS. Per HTTPS, è possibile utilizzare un certificato statico così come i certificati ACME automatizzati (Let's Encrypt). È possibile utilizzare un server opzionale per gli asset per servire file statici. L'avvio di reproxy richiede almeno un provider definito. Il resto dei parametri è strettamente opzionale e ha default sensati.
Esempi:
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.comReproxy è distribuito come un piccolo binario autonomo così come come immagine docker. Sia il binario che l'immagine supportano più architetture e più sistemi operativi, inclusi linux_x86_64, linux_arm64, linux_arm, macos_x86_64, macos_arm64, windows_x86_64 e windows_arm. Forniamo anche pacchetti deb e rpm sia per arm64 che per x86.
brew install umputun/apps/reproxydocker pull umputun/reproxy o docker pull ghcr.io/umputun/reproxy.L'ultima versione stabile ha il tag docker :vX.Y.Z (con alias :latest) e il master corrente ha il tag :master.
Le regole di proxy sono fornite da vari provider. Attualmente inclusi - file, docker, static e consul-catalog. Ogni provider può definire più regole di routing sia per le richieste inoltrate che per gli asset statici. L'utente può impostare più provider contemporaneamente.
Consulta esempi di vari provider in examples