camptocamp/odoo-nginx

docker-odoo-nginx

镜像概述和主要用途

docker-odoo-nginx是一个包含与Odoo应用配合运行的Nginx配置文件的Docker镜像。其配置适用于Odoo 8.0至12.0及更高版本，可直接用于Nginx代理Odoo的部署场景。

核心功能和特性

• 内置适配Odoo的Nginx配置，支持多版本Odoo（8.0至12.0及以上）
• 可自定义Odoo主机名、长轮询端口及代理缓存大小
• 支持HTTP访问控制规则配置（允许/拒绝特定IP）
• 支持对特定路径进行基于密码的访问限制（HTACCESS）
• 提供Odoo pdfcontent问题解决方案
• 支持设置所有Cookie的Secure属性以增强安全性

使用场景和适用范围

适用于需要通过Nginx代理Odoo应用的部署环境，尤其适合需要自定义Nginx配置（如访问控制、缓存策略、长轮询设置）的场景，可满足不同版本Odoo的代理需求。

配置说明

Odoo主机名

默认配置：Nginx代理到名为"odoo"的主机。
修改方式：通过环境变量NGX_ODOO_HOST指定自定义主机名。

Odoo长轮询端口

默认配置：使用8072端口作为长轮询端口。
修改方式：通过环境变量NGX_ODOO_LONGPOLLING_PORT指定自定义端口。

代理缓存大小

默认配置：代理缓存大小为10m。
修改方式：通过环境变量NGX_CACHE_SIZE指定自定义缓存大小（如"20m"）。

Odoo长轮询URL根路径端口

默认配置：长轮询URL根路径绑定8072端口。
修改方式：通过环境变量NGX_ODOO_LONGPOLLING指定自定义端口。

Odoo pdfcontent问题处理

问题描述：部分场景下pdfjs无法正确计算byte_content。
默认行为：Nginx禁用相关设置以解决此问题（详情：https://github.com/camptocamp/docker-odoo-nginx/pull/29%EF%BC%89%E3%80%82
修改方式：通过环境变量NGX_ODOO_PDFCONTENT启用原始设置。

HTTP访问控制

配置方式：通过环境变量NGX_HTTP_ACCESS设置多行访问规则，示例：

deny 192.168.1.1;
allow 192.168.1.0/24;
deny all;

HTACCESS访问限制

步骤1：指定受限制路径

通过环境变量NGX_ODOO_EXTRA_LOCATION定义需要限制的路径，支持单个或多个路径：

• 单个路径示例：['/products/catalog']
• 多个路径示例：['/products/catalog','/stock/locations']

步骤2：配置用户密码

1. 安装htpasswd工具（包含在apache2-utils包中）：

   sudo apt-get install apache2-utils
   

2. 生成密码哈希（语法：htpasswd -nb <用户名> <密码>）：

   htpasswd -nb vrenaville camptocamp
   

3. 将生成结果（如vrenaville:$apr1$lDdea9Jt$DAJQG0W1s4JEuuVQQxiur.）设置到环境变量NGX_HTPASSWD。

安全Cookie设置

配置方式：将环境变量NGX_ODOO_SECURE_COOKIES设置为1，可使所有Cookie添加Secure属性。