Cuando proxy_mode está habilitado, Odoo toma la dirección del cliente del encabezado X-Forwarded-For, pero solo confía en un proxy: siempre toma la última dirección del encabezado. Detrás de más de un proxy inverso (por ejemplo, un balanceador de carga en la nube delante de un controlador de ingress), esa dirección es uno de tus propios proxies, no el cliente.
Este módulo te permite configurar en cuántos proxies confía Odoo. Odoo entonces usa la dirección añadida por tu proxy más externo, que es el cliente real.
Esto afecta a todos los lugares que usan la dirección del cliente, por ejemplo el registro de acceso, el registro de inicio de sesión, el tiempo de espera de inicio de sesión tras intentos fallidos, reCAPTCHA y los visitantes del sitio web.
Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.
auto_awesome Qué hace este módulo
Generado por IA a partir del código · Odoo 16.0Permite a los administradores indicar a Odoo cuántos proxies inversos hay delante de él, de modo que se use la dirección IP real del cliente en lugar de una dirección de proxy interna cuando hay varios proxies encadenados.
Este módulo cambia cómo Odoo determina la dirección IP del cliente cuando se ejecuta detrás de proxies inversos. Por defecto Odoo confía solo en un proxy y toma la última dirección del encabezado X-Forwarded-For; detrás de dos o más proxies esa dirección pertenece a uno de tus propios proxies, no al visitante.
El número de proxies de confianza se lee al iniciar el servidor desde la variable de entorno ODOO_TRUSTED_PROXIES, o desde una opción trusted_proxies en una sección [proxy_trusted_hops] del archivo de configuración (o de la configuración de server_environment cuando ese módulo está instalado). Si no se establece nada, el valor permanece en 1, que es el comportamiento estándar de Odoo.
- Si el valor no es un número entero positivo, se registra un error y Odoo vuelve a confiar solo en un proxy.
- Cuando el valor es mayor que 1, se indica a Odoo que confíe en ese número de proxies para la dirección del cliente reenviada, el protocolo y el host.
No hay nuevos menús, pantallas ni modelos: el módulo solo ajusta la capa del servidor web. El efecto es visible en todos los lugares donde se usa la dirección del cliente, como los registros de acceso, los registros de inicio de sesión, el tiempo de espera de inicio de sesión tras intentos fallidos, reCAPTCHA y el seguimiento de visitantes del sitio web. El cambio surte efecto cuando se inicia el servidor de Odoo, por lo que es necesario reiniciar después de cambiar la configuración.
Depende de
Texto generado por IA (DeepSeek) al leer el código de la versión 16.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 1 confirmada, 8 sin información de 9 versiones.
Fuentes · Odoo 16.0
Confirmado el 2026-11-03 en la rama 16.0 de OCA/server-tools.
terminal Instalación y uso
Documentación de OCA · Odoo 16.0Instalación
Fuente · Odoo 16.0No tienes que instalar este módulo en una base de datos. Añádelo a la lista server_wide_modules para que esté activo en cuanto arranque el servidor:
server_wide_modules = base,web,proxy_trusted_hopsConfiguración
Fuente · Odoo 16.0Establece el número de proxies inversos delante de Odoo, ya sea con la variable de entorno ODOO_TRUSTED_PROXIES o en una sección [proxy_trusted_hops] del archivo de configuración de Odoo:
[options]
proxy_mode = True
[proxy_trusted_hops]
trusted_proxies = 2La variable de entorno tiene prioridad sobre el archivo de configuración. Cuando el módulo server_environment está en la ruta de addons, la sección se lee a través de él, por lo que también puede provenir de sus archivos de entorno; el archivo de configuración de Odoo sigue estando incluido allí.
Como en el propio Odoo, la cabecera solo se usa cuando proxy_mode está habilitado y la petición contiene una cabecera X-Forwarded-Host.
Con trusted_proxies = N, Odoo usa la N-ésima dirección desde el final de la cabecera X-Forwarded-For. Si la cabecera contiene menos direcciones que esa, Odoo conserva la dirección del proxy de conexión.
Advertencia de seguridad: el cliente puede enviar su propia cabecera X-Forwarded-For, y los proxies solo añaden su entrada a ella. Nunca establezcas un valor superior al número de proxies que realmente añaden una entrada: de lo contrario, el cliente decide qué dirección ve Odoo y puede, por ejemplo, eludir el tiempo de espera del inicio de sesión. Cada proxy debe añadir su entrada a la cabecera.
Comprueba el registro del servidor al iniciar:
INFO ? odoo.addons.proxy_trusted_hops.patch: Trusting 2 proxies for the X-Forwarded-For header.Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Uso.
Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versión.
Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.