Odoo Docker镜像文档

1. 镜像概述和主要用途

Odoo Docker镜像是基于官方Odoo开源企业资源规划（ERP）和客户关系管理（CRM）平台构建的容器化部署方案。该镜像旨在简化Odoo的安装、配置和运行流程，通过容器化技术确保环境一致性、隔离性和可移植性，适用于开发、测试、演示及小型生产环境。

Odoo集成了销售、采购、库存、会计、人力资源等企业管理模块，Docker镜像则进一步降低了其部署门槛，用户无需手动配置依赖（如Python环境、数据库等），可快速启动完整的Odoo服务。

2. 核心功能和特性

• 官方兼容：基于Odoo官方源码构建，支持最新稳定版本（如16.0、17.0等），确保功能完整性和安全性。
• 环境隔离：通过Docker容器隔离Odoo运行环境，避免与主机系统依赖冲突。
• 快速部署：无需手动安装Python库、PostgreSQL等依赖，一键启动服务。
• 可扩展性：支持挂载自定义模块、配置文件和数据卷，便于功能扩展和数据持久化。
• 多版本支持：提供不同Odoo版本的镜像标签（如16.0、17.0），适配不同用户需求。
• 轻量级：基于Alpine或Debian slim基础镜像，优化镜像体积，减少资源占用。

3. 使用场景和适用范围

3.1 开发环境

快速搭建本地开发环境，隔离不同项目的Odoo版本和依赖，支持模块开发调试。

3.2 测试环境

验证Odoo新版本功能、自定义模块兼容性或配置变更，测试完成后可快速销毁容器，不影响主机环境。

3.3 小型生产部署

适用于中小企业或团队，通过Docker Compose管理Odoo与PostgreSQL容器，简化运维流程。

3.4 演示和培训

快速启动临时Odoo实例，用于产品演示、员工培训或教学场景，降低部署成本。

4. 详细使用方法和配置说明

4.1 前提条件

• 已安装Docker Engine（20.10+）和Docker Compose（v2+）。
• 主机需联网（用于拉取镜像和依赖）。
• 若使用本地数据库，需确保PostgreSQL版本与Odoo兼容（如Odoo 16推荐PostgreSQL 14）。

4.2 基本使用（docker run命令）

通过docker run直接启动Odoo容器（需提前准备PostgreSQL数据库，或使用外部数据库）。

4.2.1 连接外部PostgreSQL

docker run -d \
  --name odoo \
  -p 8069:8069 \  # 映射Odoo默认端口（HTTP）
  -e ODOO_DB_HOST=192.168.1.100 \  # 外部PostgreSQL主机IP/域名
  -e ODOO_DB_PORT=5432 \          # PostgreSQL端口（默认5432）
  -e ODOO_DB_USER=odoo \          # 数据库用户名
  -e ODOO_DB_PASSWORD=odoo_db_pass \  # 数据库密码
  -e ODOO_DB_NAME=odoo_prod \     # 数据库名称（若不存在将自动创建）
  -v odoo_data:/var/lib/odoo \    # 挂载数据卷（持久化Odoo数据）
  odoo:17.0  # 指定镜像版本（如17.0）

4.3 使用Docker Compose部署

推荐通过Docker Compose管理Odoo与PostgreSQL容器，简化多容器协作。

4.3.1 创建docker-compose.yml文件

version: '3.8'

services:
  odoo:
    image: odoo:17.0
    container_name: odoo
    restart: always
    ports:
      - "8069:8069"  # HTTP端口
      - "8072:8072"  # 长轮询端口（可选，用于实时通知）
    environment:
      - ODOO_DB_HOST=db  # 数据库服务名（与PostgreSQL服务名一致）
      - ODOO_DB_PORT=5432
      - ODOO_DB_USER=odoo  # 数据库用户名（需与PostgreSQL配置一致）
      - ODOO_DB_PASSWORD=odoo_db_pass  # 数据库密码
      - ODOO_ADMIN_PASSWORD=admin_pass  # Odoo管理员密码（首次登录使用）
      - LOG_LEVEL=info  # 日志级别（debug/info/warn/error）
    volumes:
      - odoo_data:/var/lib/odoo  # Odoo数据持久化
      - ./addons:/mnt/extra-addons  # 挂载自定义模块目录（本地路径）
      - ./config:/etc/odoo  # 挂载自定义配置文件（可选）
    depends_on:
      - db  # 依赖PostgreSQL服务，确保数据库先启动

  db:
    image: postgres:14  # Odoo 17推荐PostgreSQL 14（版本需匹配）
    container_name: odoo_db
    restart: always
    environment:
      - POSTGRES_USER=odoo  # 数据库用户名（需与Odoo配置一致）
      - POSTGRES_PASSWORD=odoo_db_pass  # 数据库密码
      - POSTGRES_DB=postgres  # 初始数据库名称（Odoo会自动创建目标库）
    volumes:
      - postgres_data:/var/lib/postgresql/data  # 数据库数据持久化
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U odoo"]  # 健康检查：验证数据库是否就绪
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  odoo_data:  # Odoo数据卷（自动创建）
  postgres_data:  # PostgreSQL数据卷（自动创建）

4.3.2 启动服务

在docker-compose.yml所在目录执行：

docker-compose up -d  # 后台启动服务

4.3.3 停止服务

docker-compose down  # 停止并删除容器（数据卷保留）
# 如需删除数据卷（谨慎操作）：docker-compose down -v

4.4 环境变量说明

Odoo容器支持通过环境变量配置核心参数，常用变量如下：

4.5 持久化数据

为避免容器销毁后数据丢失，需挂载以下目录作为数据卷：

4.6 自定义配置

若需修改Odoo核心配置（如SMTP邮件服务器、日志路径等），可通过挂载自定义odoo.conf文件实现：

1. 在主机创建配置文件（如./config/odoo.conf），内容示例：

   [options]
   admin_passwd = Admin@2024  # 管理员密码（优先级高于环境变量）
   db_host = db
   db_port = 5432
   db_user = odoo
   db_password = odoo_db_pass
   logfile = /var/log/odoo/odoo.log  # 日志路径
   addons_path = /usr/lib/python3/dist-packages/odoo/addons,/mnt/extra-addons  # 模块路径（默认+自定义）
   smtp_server = smtp.example.com  # SMTP服务器
   smtp_port = 587
   smtp_user = ***
   smtp_password = smtp_pass
   

2. 在docker-compose.yml中挂载该文件：

   volumes:
     - ./config/odoo.conf:/etc/odoo/odoo.conf  # 直接挂载单个配置文件
   

4.7 扩展与模块管理

4.7.1 安装自定义模块

将自定义模块（.zip或解压后的文件夹）放入主机./addons目录（需与/mnt/extra-addons挂载路径对应），然后在Odoo后台「应用」→「应用商店」→「更新应用列表」，即可看到并安装模块。

4.7.2 安装官方模块

通过Odoo后台「应用」搜索模块名称（如“销售管理”），点击「安装」即可自动下载并启用。

5. Docker部署方案示例

5.1 单容器快速启动（连接外部数据库）

docker run -d \
  --name odoo_demo \
  -p 8069:8069 \
  -e ODOO_DB_HOST=10.0.0.5 \
  -e ODOO_DB_PORT=5432 \
  -e ODOO_DB_USER=demo_user \
  -e ODOO_DB_PASSWORD=demo_pass \
  -e ODOO_DB_NAME=demo_db \
  -e ODOO_ADMIN_PASSWORD=demo_admin \
  -v odoo_demo_data:/var/lib/odoo \
  odoo:17.0

5.2 完整Docker Compose生产示例（含SSL和备份）

version: '3.8'

services:
  odoo:
    image: odoo:17.0
    restart: always
    ports:
      - "80:8069"    # HTTP端口（可通过Nginx反向代理SSL）
      - "443:8072"   # HTTPS端口（需配置SSL证书）
    environment:
      - ODOO_DB_HOST=db
      - ODOO_DB_PORT=5432
      - ODOO_DB_USER=odoo_prod
      - ODOO_DB_PASSWORD=ProdPass@2024
      - ODOO_DB_NAME=odoo_prod
      - ODOO_ADMIN_PASSWORD=Admin@Prod2024
      - LOG_LEVEL=warn
      - ODOO_SSL=True
      - WORKERS=8  # 假设主机为4核CPU
    volumes:
      - odoo_data:/var/lib/odoo
      - ./addons:/mnt/extra-addons
      - ./config:/etc/odoo
      - ./ssl:/etc/odoo/ssl  # 挂载SSL证书（如fullchain.pem、privkey.pem）
      - ./backups:/var/backups/odoo  # 备份目录
    depends_on:
      db:
        condition: service_healthy

  db:
    image: postgres:14
    restart: always
    environment:
      - POSTGRES_USER=odoo_prod
      - POSTGRES_PASSWORD=ProdPass@2024
      - POSTGRES_DB=postgres
    volumes:
      - postgres_data:/var/lib/postgresql/data
      - ./db_backups:/var/backups/postgres  # 数据库备份目录
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U odoo_prod"]
      interval: 10s
      timeout: 5s
      retries: 5

  # 可选：添加定时备份服务（如使用postgres-backup容器）
  db_backup:
    image: prodrigestivill/postgres-backup-local
    restart: always
    depends_on:
      - db
    environment:
      - POSTGRES_HOST=db
      - POSTGRES_USER=odoo_prod
      - POSTGRES_PASSWORD=ProdPass@2024
      - POSTGRES_DB=odoo_prod
      - BACKUP_DIR=/backups
      - BACKUP_SUFFIX=-%Y%m%d_%H%M%S
      - BACKUP_KEEP_DAYS=7  # 保留7天备份
    volumes:
      - ./db_backups:/backups

volumes:
  odoo_data:
  postgres_data:

6. 常见问题与注意事项

• 数据库版本兼容：Odoo 16需PostgreSQL 12-14，Odoo 17需PostgreSQL 14-16，版本不匹配会导致启动失败。
• 数据备份：定期备份odoo_data和postgres_data卷，避免数据丢失。
• 性能优化：生产环境建议根据CPU核心数调整WORKERS参数（公式：WORKERS = 2×CPU核心数 + 1）。
• 模块冲突：自定义模块需与Odoo版本兼容，建议在测试环境验证后再部署到生产。
• 安全加固：避免使用默认密码，限制数据库容器网络访问（如仅允许Odoo容器连接）。