Nginx + Docker 极简部署 Odoo16 支持 HTTPS 避坑指南

Nginx + Docker 极简部署 Odoo16 支持 HTTPS

在生产环境使用 Odoo 官方 Docker 镜像部署 odoo16，使用 Nginx 作为反向代理，并支持 Https协议，记录遇到的问题，作为避坑指南，最后推荐一个免费的符合OpenAPI规范的接口模块。

环境

• centos7
• docker V23
• nginx
• https 证书
• Odoo 模块

Docker 部署 Odoo16

1. 安装 docker 及 docker compose (非 docker-compose 无下划线)

yum install -y yum-utils
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

2. 启动 docker：sudo systemctl start docker
3. 测试 docker： docker run hello-world

坑：Odoo 16.0 附件默认存储到文件系统 (~/.local/share/Odoo 本次安装时是在该目录) ，但docker 中设置的 volume 默认为 /var/lib/odoo/，若升级或删除镜像会导致附件丢失, 日志报错：exceptions.CacheMiss，无法加载部分js。可以在odoo.conf 中设置为 data_dir = /var/lib/odoo。或设置 odoo 系统参数 ir_attachment.location 为 db-storage 将附件存储到数据库。
4. 目录结构

参考模板：https://github.com/khoibv/odoo-projects

├── addons						-- 要安装的 odoo 模块             
│   ├── muk_web_theme			-- 主题模块
│   └── requirements.txt		-- 额外安装的依赖 Python包
├── config
│   └── odoo.conf				-- odoo 系统运行参数
├── .env			            -- docker 环境变量，设置容器名称、Odoo 版本
├── docker-compose.yml			-- docker 
├── odoo_pg_pass				-- 数据库密码文件
└── restart.sh                  -- 脚本，pull 代码 重启容器等

5. 拉取并创建 Odoo 镜像：docker compose up -d 启动了 Odoo 及 Postgresql 服务
6. 查看运行日志：docker logs -f --tail 2000 <容器名>
7. 进入镜像交互操作：docker exec -it <容器名> /bin/bahs
   • cd /mnt/extra-addons 实际进入的是 addons，将本地文件夹映射到 docker 容器
   • 在容器中安装新增依赖：
     pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
8. 重启Odoo：
   docker compose restart web web 是docker-compose.yml中的配置
9. docker-compose.yml 文件配置说明：（非完整配置）

services:
  web:
    image: "odoo:${VERSION}" #下载.env中配置的 Odoo 镜像版本
    container_name: "${APP:-myodoo}-odoo-v${VERSION}" # 容器名
    ports:
      - "${VERSION}069:8069"  # 将 odoo 默认 8069 端口映射到 docker 容器外部访问
      - "${VERSION}072:8072" # websocket 实时聊天 端口
    volumes:
      - "odoo-web-data:/var/lib/odoo" # 创建 docker 数据卷，Odoo 生成的 web 数据，如附件等，需要与 Odoo 配置一致，删除容器数据不丢失
      - "./v${VERSION}/config/odoo.conf:/etc/odoo/odoo.conf" # 本地文件映射到 docker
      - "./v${VERSION}/addons:/mnt/extra-addons" # 本地 Odoo 模块映射到 Docker 中，可以被 Odoo 发现安装

  db:
    image: postgres:14 # 数据库镜像版本
    environment:
      - POSTGRES_DB=postgres
      - POSTGRES_PASSWORD_FILE=/run/secrets/postgresql_password # 使用文件指定密码
      - POSTGRES_USER=odoo # 数据库用户名
      - PGDATA=/var/lib/postgresql/data/pgdata
    volumes:
      - odoo-db-data:/var/lib/postgresql/data/pgdata # 创建 docker 数据卷存放数据库的数据，升级容器防止数据丢失
    secrets:
      - postgresql_password
secrets:
  postgresql_password:
    file: odoo_pg_pass # 存放数据库密码字符串的本地文件

Odoo 运行参数

[options]
addons_path = /mnt/extra-addons
data_dir = /var/lib/odoo
admin_passwd = odoo
; http_port = 8069		   -- 默认值
; longpolling_port = 8072  -- 默认值
; 代理模式，必须有反向代理服务
proxy_mode = True
dbfilter = <过滤数据库，支持正则>
db_user = <数据库用户名>
db_password = <数据库密码>
db_port = 5432

坑：LiveChat 实时聊天及通知不可用，查看日志 websocket 报错： websocket.py KeyError: 'socket'。
原因： 在多进程模式下，会启动一个监听 gevent port（默认8072） 的 LiveChat worker 进程，但客户端无法连接。
方案：需要使用反向代理把 /websocket 开头的请求重定向到gevent端口。
nginx 配置示例：

# Redirect websocket requests to odoo gevent port
 location /websocket {
	proxy_pass http://127.0.0.1:8072;
	proxy_set_header Upgrade $http_upgrade;
	proxy_set_header Connection $connection_upgrade;
	proxy_set_header X-Forwarded-Host $host;
	proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
	proxy_set_header X-Forwarded-Proto $scheme;
	proxy_set_header X-Real-IP $remote_addr;
}

默认是 workers = 0 为多线程模式，无法充分发挥多核CPU优势，开启代理模式时 nginx 报错 ‘connect() failed (111: Connection refused) while connecting to upstream’，无法实时推送接收消息。修改：workers = 推荐 (#CPU * 2) + 1

Nginx 配置说明（HTTPS）

首先在 /etc/odoo.conf 中开启代理模式:

proxy_mode = True

Nginx配置说明： (仅 server 部分，省略 http 等)

...
# http -> https 将 http 请求转为 https
server {
  listen 80;
  server_name odoo.mycompany.com;
  rewrite ^(.*) https://$host$1 permanent;
}

server {
  listen 443 ssl;
  server_name www.mycompany.com;

  # Add Headers for odoo proxy mode
  proxy_set_header X-Forwarded-Host $host;
  ...

  # SSL 证书，可从云厂商申请免费测试版，放到对应目录下
  ssl_certificate /etc/ssl/nginx/server.crt;
  ssl_certificate_key /etc/ssl/nginx/server.key;
  ...

  # log 确认已存在 nginx 文件夹： `/var/log/nginx`
  access_log /var/log/nginx/odoo.access.log;
  error_log /var/log/nginx/odoo.error.log;

  # 重定向 websocket 请求到 odoo gevent 端口
  location /websocket {
    proxy_pass http://127.0.0.1:8072;
		...
  }

  # 重定向其他请求
  location / {
    proxy_redirect off;
    proxy_pass http://127.0.0.1:8069; # 与 docker 设置一致 
  }
...
}

修改 Odoo 其他配置

坑：图片无法展示，浏览器报错：

Mixed Content: The page at 'https://' was loaded over HTTPS, but requested an insecure resource 'http://'. This request has been blocked; the content must be served over HTTPS.

通过 ssh 密钥对实现免密登录

可用于git 免密拉代码或登录远程服务器。核心在于客户机与远程服务机的配置，一台机器既可为服务端也可以为客户端。

客户端机器：使用指定的私钥访问服务器。

1. 通过 ssh-add ~/.ssh/<私钥文件> 临时指定私钥
2. 写入配置文件 .ssh/config:

Host <host_name>
  HostName <ip>
  PreferredAuthentications publickey
  User <root>
  IdentityFile ~/.ssh/<私钥文件>

注意：不添加到 config 文件, 新打开终端, 可能报错：git Permission denied (publickey)

远程机器：
添加公钥到~/.ssh/authorized_keys: 存放可远程免密登录的用户公钥，每行一个
云主机：需要到控制台添加密钥对并绑定到服务器。

测试：ssh -i 私钥文件 username@ip 或 ssh <host_name>

结果展示

参考

1. Nginx配置详解
2. Odoo官网Https配置说明
3. Odoo Docker 镜像
4. Docker及config 配置模板
5. Centos 安装 Docker

推荐模块

可生成生成符合OpenAPI规范的接口
自动记录接口调用日志
配置字段及权限
https://apps.odoo.com/apps/modules/16.0/openapi/

前端分页列表查询示例：

	let params = {
    kwargs: {
      domain: [['is_published', '=', true]],
      //可以查询关联表的字段, *2m 返回列表[{}], m2o返回对象
      fields: ['id', 'name', 'tag_ids/name', 'published_date', 'view_count', 'author_id/name'],
      limit: 10,
      offset: 0,
    }
  }
  const model = 'blog.post'
  const url = `/${model}/call/search_read_nested`
  const res = await CommonApi.queryList(url, params)