注意：这是 odoo 镜像 的 arm64v8 架构构建的“按架构”仓库——更多信息，请参见镜像文档中的“非 amd64 架构？”和***镜像常见问题中的“Git 中镜像源已更改，该怎么办？”。

快速参考

-** 维护者 **：
Odoo

-** 获取帮助 **：
Docker 社区 Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应的 Dockerfile 链接

• 19.0-20251008, 19.0, 19, latest

• 18.0-20251008, 18.0, 18

• 17.0-20251008, 17.0, 17

快速参考（续）

-** 问题反馈 ：
[*]

-** 支持的架构 **：(更多信息)
amd64、arm64v8、ppc64le

-** 镜像 artifact 详情 **：
repo-info 仓库的 repos/odoo/ 目录（历史记录）
（镜像元数据、传输大小等）

-** 镜像更新 **：
official-images 仓库的 library/odoo 标签
official-images 仓库的 library/odoo 文件（历史记录）

-** 本描述的来源 **：
docs 仓库的 odoo/ 目录（历史记录）

什么是 Odoo？

Odoo（前身为 OpenERP）是一套开源业务应用套件，采用 Python 编写并以 LGPL 许可证发布。该应用套件涵盖所有业务需求，从网站/电商到制造、库存和会计，所有功能无缝集成。这是首次有软件编辑器实现如此全面的功能覆盖。Odoo 是全球安装量最大的业务软件，全球有 200 万用户使用，从小型企业（1 名用户）到大型企业（30 万名用户）不等。

[***]

!logo

如何使用本镜像

本镜像需要运行中的 PostgreSQL 服务器。

启动 PostgreSQL 服务器

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

启动 Odoo 实例

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

运行 Postgres 的容器别名必须为 db，Odoo 才能连接到 Postgres 服务器。

停止和重启 Odoo 实例

console
$ docker stop arm64v8/odoo
$ docker start -a arm64v8/odoo

使用命名卷保留数据

按上述方式创建 Odoo 容器时，Odoo 文件存储位于容器内部。若容器被删除，文件存储也会丢失。防止此问题的推荐方法是使用 Docker 命名卷。

console
$ docker run -v odoo-data:/var/lib/odoo -d -p 8069:8069 --name odoo --link db:db -t arm64v8/odoo

使用上述命令，名为 odoo-data 的卷即使在容器删除后也会保留，并且可以通过相同命令重新使用。

作为卷挂载点的路径 /var/lib/odoo 必须与配置文件或 CLI 参数中的 Odoo data_dir 匹配。

注意，同样的原则适用于 Postgresql 容器，也可以使用命名卷在容器删除时保留数据库。因此，数据库容器可以这样启动（在 Odoo 容器之前）：

console
$ docker run -d -v odoo-db:/var/lib/postgresql/data -e POSTGRES_USER=odoo -e POSTGRES_PASSWORD=odoo -e POSTGRES_DB=postgres --name db postgres:15

停止和重启 PostgreSQL 服务器

当 PostgreSQL 服务器重启时，链接到该服务器的 Odoo 实例也必须重启，因为服务器地址已更改，链接会中断。

重启 PostgreSQL 服务器不会影响已创建的数据库。

使用自定义配置运行 Odoo

服务器的默认配置文件（位于 /etc/odoo/odoo.conf）可以在启动时通过卷覆盖。假设自定义配置位于 /path/to/config/odoo.conf，则：

console
$ docker run -v /path/to/config:/etc/odoo -p 8069:8069 --name odoo --link db:db -t arm64v8/odoo

请使用此配置模板编写自定义配置，因为我们已为在 Docker 容器中运行 Odoo 设置了一些参数。

也可以直接在命令行中指定 Odoo 参数。这些参数必须在命令行中的 -- 关键字后给出，如下所示：

console
$ docker run -p 8069:8069 --name odoo --link db:db -t arm64v8/odoo -- --db-filter=odoo_db_.*

挂载自定义插件

可以将自定义 Odoo 插件挂载到 Odoo 容器的 /mnt/extra-addons 目录：

console
$ docker run -v /path/to/addons:/mnt/extra-addons -p 8069:8069 --name odoo --link db:db -t arm64v8/odoo

注意：尽管没有***的 Odoo Enterprise Docker 镜像，但可以通过上述方法挂载 Enterprise 模块。

运行多个 Odoo 实例

console
$ docker run -p 8070:8069 --name odoo2 --link db:db -t arm64v8/odoo
$ docker run -p 8071:8069 --name odoo3 --link db:db -t arm64v8/odoo

注意：若要正常使用邮件和报表功能，当主机和容器端口不同（例如 8070 和 8069）时，必须在 Odoo 中设置 设置->参数->系统参数（需要技术特性），将 web.base.url 设置为容器端口（例如 127.0.0.1:8069）。

环境变量

通过以下环境变量可以轻松连接到 PostgreSQL 服务器：

• HOST：PostgreSQL 服务器地址。若使用 PostgreSQL 容器，设置为容器名称。默认为 db。
• PORT：PostgreSQL 服务器监听端口。默认为 5432。
• USER：Odoo 用于连接的 PostgreSQL 角色。若使用 PostgreSQL 容器，设置为与 POSTGRES_USER 相同的值。默认为 odoo。
• PASSWORD：Odoo 用于连接的 PostgreSQL 角色密码。若使用 PostgreSQL 容器，设置为与 POSTGRES_PASSWORD 相同的值。默认为 odoo。

Docker Compose 示例

最简单的 compose.yaml 文件如下：

yml
services:
  web:
    image: arm64v8/odoo:17.0
    depends_on:
      - db
    ports:
      - "8069:8069"
  db:
    image: postgres:15
    environment:
      - POSTGRES_DB=postgres
      - POSTGRES_PASSWORD=odoo
      - POSTGRES_USER=odoo

若默认 PostgreSQL 凭据不适用，可以调整环境变量：

yml
services:
  web:
    image: arm64v8/odoo:17.0
    depends_on:
      - mydb
    ports:
      - "8069:8069"
    environment:
      - HOST=mydb
      - USER=odoo
      - PASSWORD=myodoo
  mydb:
    image: postgres:15
    environment:
      - POSTGRES_DB=postgres
      - POSTGRES_PASSWORD=myodoo
      - POSTGRES_USER=odoo

最后一个示例展示如何：

• 挂载位于 ./addons 的自定义插件
• 使用位于 .config/odoo.conf 的自定义配置文件
• 为 Odoo 和 PostgreSQL 数据目录使用命名卷
• 使用名为 odoo_pg_pass 的 secrets 文件，其中包含两个服务共享的 PostgreSQL 密码

yml
services:
  web:
    image: arm64v8/odoo:17.0
    depends_on:
      - db
    ports:
      - "8069:8069"
    volumes:
      - odoo-web-data:/var/lib/odoo
      - ./config:/etc/odoo
      - ./addons:/mnt/extra-addons
    environment:
      - PASSWORD_FILE=/run/secrets/postgresql_password
    secrets:
      - postgresql_password
  db:
    image: postgres:15
    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
    secrets:
      - postgresql_password
volumes:
  odoo-web-data:
  odoo-db-data:

secrets:
  postgresql_password:
    file: odoo_pg_pass

要启动 Odoo 实例，请进入包含上述示例 compose.yaml 文件的目录，然后运行：

console
docker compose up -d

如何升级本镜像

Odoo 镜像会定期更新以使用最新版本（每个 Odoo 版本的新构建每晚生成）。请注意，以下内容是关于从同一主版本的旧版本升级到最新版本，而主版本之间的升级是更复杂的过程，需要详细的迁移脚本（参见 Odoo 升级页面 或旨在编写这些脚本的 社区项目）。

假设你从名为 old-odoo 的 Odoo 实例创建了数据库，并且想要从名为 new-odoo 的新 Odoo 实例访问此数据库（例如，因为你刚下载了更新的 Odoo 镜像）。

默认情况下，Odoo 16.0+ 使用文件存储（位于 /var/lib/odoo/filestore/）存储附件。你应通过运行以下命令在新 Odoo 实例中恢复此文件存储：

console
$ docker run --volumes-from old-odoo -p 8070:8069 --name new-odoo --link db:db -t arm64v8/odoo

许可证

查看本镜像中包含的软件的许可证信息。

与所有 Docker 镜像一样，这些镜像可能还包含其他软件，这些软件可能采用其他许可证（例如基础发行版中的 Bash 等，以及主要软件的任何直接或间接依赖项）。

一些能够自动检测到的额外许可证信息可能位于 repo-info 仓库的 odoo/ 目录 中。

对于任何预构建镜像的使用，镜像用户有责任确保对本镜像的任何使用符合其中包含的所有软件的相关许可证。