
Servidor HTTP(S) de borde ligero y proxy inverso con SSL automático, descubrimiento Docker/Consul, autenticación por ruta, limitación de velocidad y conmutación por error basada en comprobaciones de salud.
Reproxy es un servidor HTTP(s) de borde / proxy inverso simple que soporta varios proveedores (docker, estático, archivo, catálogo de consul). Uno o más proveedores suministran información sobre el servidor solicitado, la URL solicitada, la URL de destino y la URL de verificación de estado. Se distribuye como un único binario o como un contenedor docker.
El servidor (host) puede establecerse como FQDN, es decir, s.example.com, * (comodín) o una regex. La coincidencia exacta tiene prioridad, por lo que si hay dos reglas con servidores example.com y example\.(com|org), una petición a example.com/some/url coincidirá con la primera. La url solicitada puede ser una regex, por ejemplo ^/api/(.*), y la url de destino puede tener grupos coincidentes de la regex, es decir, http://d.example.com:8080/$1. Para el ejemplo anterior, http://s.example.com/api/something?foo=bar se redirigirá a http://d.example.com:8080/something?foo=bar.
Los nombres de servidor exactos y *.example.com coinciden con el host sin distinguir mayúsculas y minúsculas e ignoran un punto final, por lo que Admin.Example.com y admin.example.com. coinciden con una regla admin.example.com. Los servidores regex coinciden tal como se escriben, así que añade (?i) cuando no deba importar el uso de mayúsculas y minúsculas. Las regex de ruta coinciden con la ruta de la petición escapada, donde un espacio es %20 y ü es %C3%BC, mientras que los prefijos de recursos estáticos pueden escribirse como texto plano. Las regex de ruta distinguen mayúsculas y minúsculas: cuando una ruta protegida se sitúa delante de un upstream que trata las rutas sin distinguir mayúsculas y minúsculas, añade (?i) a esa ruta.
Por conveniencia, las peticiones con la / final y sin grupos regex se expanden a /(.*), y los destinos en esos casos se expanden a /$1. Es decir, /api/ -> http://127.0.0.1/service se traducirá a ^/api/(.*) -> http://127.0.0.1/service/$1.
Antes de la coincidencia de rutas, reproxy rechaza con 400 una petición cuya ruta decodificada contenga un segmento . o .., barras repetidas (//), un ; o una barra invertida. Se permite una única barra final.
La sustitución de host está soportada en la URL de destino. Por ejemplo, /files/${host} se reemplazará con el nombre del host coincidente. También se puede usar $host (sin llaves).
Los grupos de un servidor regex se pueden usar en la URL de destino como ${host.1}, ${host.2} y así sucesivamente (se requieren las llaves). Por ejemplo, el servidor ^([^.]+)\.example\.com$ con la ruta ^/(.*)$ y el destino https://${host.1}.foo.com/$1 redirige http://aaaa.example.com/some a https://aaaa.foo.com/some. $1, $2 siguen refiriéndose a los grupos de la ruta. Un grupo faltante se reemplaza con una cadena vacía, y lo mismo ocurre con cualquier ${host.N} para un servidor exacto, * o *.example.com, ya que estos no tienen grupos. Los valores de host se insertan tal cual, sin escape de URL, así que mantén los grupos del servidor estrictos: ancla la regex con ^ y $, y captura solo lo que puede contener una etiqueta de host, es decir, ([a-z0-9-]+) en lugar de (.*), que también coincidiría con .. de un host como ...example.com. Antes de la coincidencia de rutas, reproxy rechaza las cabeceras Host que contengan caracteres no permitidos por la validación de cabeceras de host HTTP o que contengan %, devolviendo 400. Cuando un token de host sigue directamente a un grupo de ruta, escribe el grupo con llaves, es decir, ${1}${host.1}, ya que $1aaaa se leería como un grupo llamado 1aaaa.
Se admiten tanto HTTP como HTTPS. Para HTTPS, se puede usar un certificado estático así como certificados ACME automatizados (Let's Encrypt). Se puede usar un servidor de assets opcional para servir archivos estáticos. Iniciar reproxy requiere al menos un proveedor definido. El resto de parámetros son estrictamente opcionales y tienen valores predeterminados sensatos.
Ejemplos:
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 se distribuye como un pequeño binario autocontenido así como una imagen docker. Tanto el binario como la imagen admiten múltiples arquitecturas y múltiples sistemas operativos, incluidos linux_x86_64, linux_arm64, linux_arm, macos_x86_64, macos_arm64, windows_x86_64 y windows_arm. También proporcionamos paquetes deb y rpm tanto para arm64 como para x86.
brew install umputun/apps/reproxydocker pull umputun/reproxy o docker pull ghcr.io/umputun/reproxy.La última versión estable tiene la etiqueta docker :vX.Y.Z (con el alias :latest) y el master actual tiene la etiqueta :master.
Las reglas de proxy son suministradas por varios proveedores. Actualmente incluidos: file, docker, static y consul-catalog. Cada proveedor puede definir múltiples reglas de enrutamiento tanto para solicitudes proxificadas como para estáticos (assets). El usuario puede establecer múltiples proveedores al mismo tiempo.
Consulta ejemplos de varios proveedores en examples