
reproxy v1.7.1
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.
- Terminación SSL automática con Let's Encrypt
- Soporte de certificados SSL proporcionados por el usuario
- Reglas de proxy simples pero flexibles
- Proveedor de reglas de proxy estático, por línea de comandos
- Proveedor de reglas de proxy dinámico, basado en archivos
- Proveedor Docker con descubrimiento automático
- Proveedor Consul Catalog con descubrimiento por etiquetas de servicio
- Soporte para múltiples hosts (virtuales)
- Compresión de tráfico opcional
- Control de acceso opcional basado en IP
- Autenticación básica por ruta
- Límites de tamaño y tiempos de espera definidos por el usuario
- Distribución como binario único
- Distribución como contenedor Docker
- Servidor de recursos estáticos integrado con modo opcional "compatible con SPA"
- Soporte para reglas de redirección
- Limitador opcional para la actividad general así como para la actividad del usuario
- Verificación de estado en vivo y fail-over/balanceo de carga
- Servidor de administración con información de rutas y métricas de prometheus
- Soporte de plugins vía RPC para implementar funcionalidad personalizada
- Registro opcional tanto con Apache Log Format como con informes simplificados en stdout.
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:
- con un proveedor estático:
reproxy --static.enabled --static.rule="*,example.com/api/(.*),https://api.example.com/$1" - con descubrimiento automático de docker:
reproxy --docker.enabled --docker.auto - como contenedor docker:
docker up -p 80:8080 umputun/reproxy --docker.enabled --docker.auto - con SSL automático:
docker up -p 80:8080 -p 443:8443 umputun/reproxy --docker.enabled --docker.auto --ssl.type=auto --ssl.fqdn=example.com
Instalación
Reproxy 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.
- para una distribución binaria, descarga el archivo adecuado en la sección de releases
- para usuarios de Homebrew:
brew install umputun/apps/reproxy - contenedor docker disponible en Docker Hub así como en Github Container Registry. Es decir,
docker pull umputun/reproxyodocker 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.
Proveedores
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