
Leichter HTTP(S)-Edge-Server und Reverse-Proxy mit automatischem SSL, Docker/Consul-Erkennung, routenspezifischer Authentifizierung, Ratenbegrenzung und gesundheitscheckbasiertem Failover.
Reproxy ist ein einfacher Edge-HTTP(s)-Server / Reverse-Proxy, der verschiedene Provider unterstützt (docker, static, file, consul catalog). Ein oder mehrere Provider liefern Informationen über den angeforderten Server, die angeforderte URL, die Ziel-URL und die Health-Check-URL. Es wird als einzelne Binärdatei oder als Docker-Container verteilt.
Der Server (Host) kann als FQDN, z. B. s.example.com, als * (Catch-all) oder als Regex festgelegt werden. Exakte Übereinstimmungen haben Vorrang. Gibt es also zwei Regeln mit den Servern example.com und example\.(com|org), so trifft eine Anfrage an example.com/some/url auf erstere zu. Die angeforderte URL kann ein Regex sein, zum Beispiel ^/api/(.*), und die Ziel-URL kann durch Regex übereinstimmende Gruppen enthalten, z. B. http://d.example.com:8080/$1. Für das obige Beispiel wird http://s.example.com/api/something?foo=bar an http://d.example.com:8080/something?foo=bar weitergeleitet.
Exakte Server-Namen und *.example.com-Namen stimmen ohne Beachtung der Groß-/Kleinschreibung mit dem Host überein und ignorieren einen abschließenden Punkt. Daher treffen Admin.Example.com und admin.example.com. auf eine Regel für admin.example.com zu. Regex-Server werden exakt wie geschrieben abgeglichen; fügen Sie (?i) hinzu, wenn die Groß-/Kleinschreibung keine Rolle spielen soll. Routen-Regexes werden mit dem escapten Anfragepfad abgeglichen, wobei ein Leerzeichen %20 und ü %C3%BC entspricht, während Präfixe für statische Assets als Klartext geschrieben werden können. Routen-Regexes sind case-sensitiv: Wenn eine geschützte Route vor einem Upstream liegt, der Pfade ohne Beachtung der Groß-/Kleinschreibung behandelt, fügen Sie dieser Route (?i) hinzu.
Der Einfachheit halber werden Anfragen mit abschließendem / und ohne Regex-Gruppen zu /(.*) erweitert, und Ziele werden in diesen Fällen zu /$1 erweitert. D. h. /api/ -> http://127.0.0.1/service wird zu ^/api/(.*) -> http://127.0.0.1/service/$1 übersetzt.
Vor dem Routenabgleich lehnt reproxy eine Anfrage mit 400 ab, deren dekodierter Pfad ein .- oder ..-Segment, doppelte Schrägstriche (//), ein ; oder einen Backslash enthält. Ein einzelner abschließender Schrägstrich ist zulässig.
Die Host-Substitution wird in der Ziel-URL unterstützt. Zum Beispiel wird /files/${host} durch den übereinstimmenden Hostnamen ersetzt. $host (ohne geschweifte Klammern) kann ebenfalls verwendet werden.
Gruppen eines Regex-Servers können in der Ziel-URL als ${host.1}, ${host.2} und so weiter verwendet werden (geschweifte Klammern erforderlich). Zum Beispiel leitet der Server ^([^.]+)\.example\.com$ mit der Route ^/(.*)$ und dem Ziel https://${host.1}.foo.com/$1 die Anfrage http://aaaa.example.com/some an https://aaaa.foo.com/some weiter. $1, $2 beziehen sich weiterhin auf die Routengruppen. Eine fehlende Gruppe wird durch eine leere Zeichenkette ersetzt, ebenso wie jedes ${host.N} bei einem exakten, *- oder *.example.com-Server, da diese keine Gruppen haben. Host-Werte werden unverändert eingefügt, ohne URL-Escaping, daher sollten Server-Gruppen eng gefasst werden: Verankern Sie den Regex mit ^ und $ und erfassen Sie nur, was ein Host-Label enthalten darf, d. h. ([a-z0-9-]+) statt (.*), was auch .. aus einem Host wie ...example.com treffen würde. Vor dem Routenabgleich lehnt reproxy Host-Header ab, die Zeichen enthalten, die von der HTTP-Host-Header-Validierung nicht erlaubt sind, oder die % enthalten, und gibt 400 zurück. Wenn ein Host-Token direkt auf eine Routengruppe folgt, schreiben Sie die Gruppe mit geschweiften Klammern, d. h. ${1}${host.1}, da $1aaaa als Gruppe namens 1aaaa gelesen würde.
Sowohl HTTP als auch HTTPS werden unterstützt. Für HTTPS kann sowohl ein statisches Zertifikat als auch ein automatisiertes ACME-Zertifikat (Let's Encrypt) verwendet werden. Ein optionaler Assets-Server kann zum Ausliefern statischer Dateien verwendet werden. Der Start von reproxy erfordert mindestens einen definierten Provider. Die übrigen Parameter sind streng optional und haben sinnvolle Standardwerte.
Beispiele:
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 wird als kleines eigenständiges Binary sowie als Docker-Image vertrieben. Sowohl das Binary als auch das Image unterstützen mehrere Architekturen und mehrere Betriebssysteme, darunter linux_x86_64, linux_arm64, linux_arm, macos_x86_64, macos_arm64, windows_x86_64 und windows_arm. Wir stellen außerdem sowohl arm64- als auch x86-deb- und rpm-Pakete bereit.
brew install umputun/apps/reproxydocker pull umputun/reproxy oder docker pull ghcr.io/umputun/reproxy.Die neueste stabile Version hat das Docker-Tag :vX.Y.Z (mit dem Alias :latest) und der aktuelle Master hat das Tag :master.
Proxy-Regeln werden von verschiedenen Providern bereitgestellt. Derzeit enthalten sind file, docker, static und consul-catalog. Jeder Provider kann mehrere Routing-Regeln sowohl für proxied Requests als auch für statische (Assets) definieren. Der Benutzer kann mehrere Provider gleichzeitig festlegen.