library/odoo

Odoo Docker 镜像使用指南

快速参考

维护与支持

• 维护者：Odoo
• 获取帮助：可通过 Docker 社区 Slack、Server Fault、Unix & Linux 或 Stack Overflow 提问

支持的标签及对应 Dockerfile

以下是当前支持的镜像标签及其 Dockerfile 链接：

• 19.0-20251008, 19.0, 19, latest
• 18.0-20251008, 18.0, 18
• 17.0-20251008, 17.0, 17

快速参考（续）

• 提交 issue：Odoo Docker 仓库 issue 页面
• 支持的架构（更多信息）：
  amd64、arm64v8、ppc64le
• 镜像工件详情：可在 repo-info 仓库的 repos/odoo/ 目录（历史记录）查看（包括元数据、传输大小等）。
• 镜像更新：通过 official-images 仓库的 library/odoo 标签 或 文件（历史记录）跟踪。
• 本文档来源：docs 仓库的 odoo/ 目录（历史记录）

什么是 Odoo？

Odoo（前身为 OpenERP）是一套开源业务应用套件，采用 Python 开发，基于 LGPL 许可证发布。该套件覆盖从网站/电商到制造、库存、会计等全业务流程，且各模块无缝集成，是目前功能覆盖最全面的企业软件之一。全球有超过 200 万用户使用 Odoo，涵盖从单人小微企业到 30 万用户的大型企业。

官网：[***]

如何使用此镜像

使用 Odoo 镜像需配合运行中的 PostgreSQL 服务器。

1. 启动 PostgreSQL 服务器

先运行 PostgreSQL 容器，设置数据库用户、密码和初始数据库：

console
$ docker run -d -e POSTGRES_USER=odoo -e POSTGRES_PASSWORD=odoo -e POSTGRES_DB=postgres --name db postgres:15

2. 启动 Odoo 实例

通过 --link 连接到 PostgreSQL 容器（容器别名必须为 db，Odoo 才能自动识别）：

console
$ docker run -p 8069:8069 --name odoo --link db:db -t odoo

启动后，访问 `[***] 即可打开 Odoo。

3. 停止与重启

• 停止 Odoo：
  CODE_TOKEN_2
• 重启 Odoo（保留之前的配置）：
  CODE_TOKEN_3

4. 使用命名卷持久化数据

默认情况下，Odoo 的文件存储（如附件）位于容器内部，删除容器会丢失数据。推荐使用 命名卷 持久化数据：

持久化 Odoo 数据

CODE_TOKEN_4

• odoo-data 为命名卷，即使删除容器也会保留数据，下次启动时可复用。
• 挂载路径 /var/lib/odoo 需与 Odoo 配置文件中的 data_dir 一致。

持久化 PostgreSQL 数据

同理，为 PostgreSQL 数据目录挂载命名卷，避免数据库丢失：
CODE_TOKEN_5

5. 自定义配置

覆盖默认配置文件

Odoo 默认配置文件位于 /etc/odoo/odoo.conf，可通过挂载本地配置文件覆盖：
CODE_TOKEN_6

配置文件模板参考：官方模板（已包含 Docker 环境必要参数）。

直接传递命令行参数

在命令末尾添加 -- 后接 Odoo 参数，例如过滤数据库：
CODE_TOKEN_7

6. 挂载自定义插件

将本地插件目录挂载到容器的 /mnt/extra-addons，Odoo 会自动加载：
CODE_TOKEN_8

注意：即使没有官方企业版镜像，也可通过此方式挂载 Odoo Enterprise 模块。

7. 运行多个 Odoo 实例

通过映射不同主机端口，可启动多个 Odoo 实例（均连接同一 PostgreSQL）：
CODE_TOKEN_9

注意：若主机端口与容器端口不同（如 8070:8069），需在 Odoo 中设置 Settings->Parameters->System Parameters（需开启开发者模式），将 web.base.url 设为容器端口（如 127.0.0.1:8069），否则邮件、报表功能可能异常。

8. 环境变量配置

通过环境变量自定义 PostgreSQL 连接信息（无需修改配置文件）：

示例：连接自定义 PostgreSQL 服务器
CODE_TOKEN_10

9. Docker Compose 示例

使用 compose.yaml 简化多容器管理，以下是常见场景配置。

基础配置

CODE_TOKEN_11

自定义数据库 credentials

CODE_TOKEN_12

完整配置（含数据持久化、自定义插件和配置）

CODE_TOKEN_13

启动命令：在 compose.yaml 所在目录执行
CODE_TOKEN_14

如何升级镜像

Odoo 镜像每日更新（同步 nightly 版本）。以下步骤适用于同一主版本内的升级（如从 17.0 旧版本升级到 17.0 最新版本），跨主版本升级需参考 Odoo 官方升级文档 或 OpenUpgrade 项目。

升级步骤

1. 假设旧实例名为 old-odoo，需保留其文件存储（Odoo 16.0+ 附件默认存储在 /var/lib/odoo/filestore/）。
2. 启动新实例时，通过 --volumes-from 复用旧实例的文件存储：
   CODE_TOKEN_15

许可证

镜像中 Odoo 软件的许可证信息见 Odoo 源码仓库 LICENSE 文件。
Docker 镜像可能包含基础系统（如 Bash）及依赖软件，其许可证可能不同。更多信息可参考 repo-info 仓库的 odoo/ 目录。

使用前请确保遵守所有软件的许可证要求。