
Serveur HTTP(S) de périphérie léger et proxy inverse avec SSL automatique, découverte Docker/Consul, authentification par route, limitation de débit, et basculement basé sur les vérifications de santé.
Reproxy est un serveur HTTP(s) de périphérie / proxy inverse simple prenant en charge divers fournisseurs (docker, static, file, consul catalog). Un ou plusieurs fournisseurs fournissent des informations sur le serveur demandé, l'URL demandée, l'URL de destination et l'URL de vérification de l'état. Il est distribué sous forme de binaire unique ou de conteneur docker.
Le serveur (hôte) peut être défini comme un FQDN, c'est-à-dire s.example.com, * (attrape-tout) ou une regex. La correspondance exacte est prioritaire, donc s'il existe deux règles avec les serveurs example.com et example\.(com|org), une requête vers example.com/some/url correspondra à la première. L'URL demandée peut être une regex, par exemple ^/api/(.*), et l'URL de destination peut contenir des groupes correspondants à la regex, c'est-à-dire http://d.example.com:8080/$1. Pour l'exemple ci-dessus, http://s.example.com/api/something?foo=bar sera proxifié vers http://d.example.com:8080/something?foo=bar.
Les noms de serveur exacts et *.example.com correspondent au host sans tenir compte de la casse et ignorent un point final, donc Admin.Example.com et admin.example.com. correspondent à une règle admin.example.com. Les serveurs regex correspondent tels qu'écrits, donc ajoutez (?i) lorsque la casse ne doit pas compter. Les regex de route correspondent au chemin de requête échappé, où un espace est %20 et ü est %C3%BC, tandis que les préfixes d'actifs statiques peuvent être écrits en texte brut. Les regex de route sont sensibles à la casse : lorsqu'une route protégée se trouve devant un upstream qui traite les chemins sans tenir compte de la casse, ajoutez (?i) à cette route.
Pour plus de commodité, les requêtes avec le / final et sans groupes regex sont étendues à /(.*), et les destinations dans ces cas sont étendues à /$1. C'est-à-dire que /api/ -> http://127.0.0.1/service sera traduit en ^/api/(.*) -> http://127.0.0.1/service/$1.
Avant la correspondance des routes, reproxy rejette avec un code 400 une requête dont le chemin décodé contient un segment . ou .., des barres obliques répétées (//), un ; ou une barre oblique inverse. Une seule barre oblique finale est autorisée.
La substitution d'hôte est prise en charge dans l'URL de destination. Par exemple, /files/${host} sera remplacé par le nom d'hôte correspondant. $host (sans accolades) peut également être utilisé.
Les groupes d'une regex de serveur peuvent être utilisés dans l'URL de destination sous la forme ${host.1}, ${host.2}, etc. (les accolades sont obligatoires). Par exemple, le serveur ^([^.]+)\.example\.com$ avec la route ^/(.*)$ et la destination https://${host.1}.foo.com/$1 fait proxy de http://aaaa.example.com/some vers https://aaaa.foo.com/some. $1, $2 continuent de faire référence aux groupes de la route. Un groupe manquant est remplacé par une chaîne vide, tout comme n'importe quel ${host.N} pour un serveur exact, * ou *.example.com, car ceux-ci n'ont pas de groupes. Les valeurs d'hôte sont insérées telles quelles, sans échappement d'URL, donc gardez les groupes de serveur stricts : ancrez la regex avec ^ et $, et ne capturez que ce qu'un label d'hôte peut contenir, c'est-à-dire ([a-z0-9-]+) plutôt que (.*), qui correspondrait aussi à .. d'un hôte comme ...example.com. Avant la correspondance de route, reproxy rejette les en-têtes Host contenant des caractères non autorisés par la validation des en-têtes d'hôte HTTP ou contenant %, en renvoyant 400. Lorsqu'un jeton d'hôte suit directement un groupe de route, écrivez le groupe avec des accolades, c'est-à-dire ${1}${host.1}, car $1aaaa serait lu comme un groupe nommé 1aaaa.
HTTP et HTTPS sont pris en charge. Pour HTTPS, un certificat statique peut être utilisé ainsi que des certificats ACME automatisés (Let's Encrypt). Un serveur d'assets optionnel peut être utilisé pour servir des fichiers statiques. Le démarrage de reproxy nécessite au moins un provider défini. Le reste des paramètres est strictement optionnel et dispose de valeurs par défaut raisonnables.
Exemples :
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 est distribué sous forme d'un petit binaire autonome ainsi que d'une image docker. Le binaire et l'image prennent en charge plusieurs architectures et plusieurs systèmes d'exploitation, notamment linux_x86_64, linux_arm64, linux_arm, macos_x86_64, macos_arm64, windows_x86_64 et windows_arm. Nous fournissons également des paquets deb et rpm pour arm64 et x86.
brew install umputun/apps/reproxydocker pull umputun/reproxy ou docker pull ghcr.io/umputun/reproxy.La dernière version stable possède le tag docker :vX.Y.Z (avec l'alias :latest) et le master actuel possède le tag :master.