llacroix/odoo
llacroix
支持Odoo 8.0至最新版本的Docker镜像，提供统一配置、自动PostgreSQL连接处理、额外插件支持等增强功能，简化Odoo部署与运行。
6 次收藏下载次数: 0状态：社区镜像维护者：llacroix仓库类型：镜像最近更新：3 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
llacroix/odoo Docker镜像文档
镜像概述
本镜像为原始Odoo Docker仓库的分支项目，提供了诸多改进，如所有Odoo项目的统一配置。支持Odoo 8.0至最新版本，通过模板生成Dockerfile以兼容Python 2和Python 3环境的Odoo版本。
核心功能与特性
PostgreSQL连接管理
- 从ODOO_RC文件或命令行参数加载环境变量，结合
.pgpass文件实现安全的PostgreSQL连接 - 启动前自动尝试连接PostgreSQL，支持重试机制（可通过
PGRETRY和PGRETRYTIME配置） - 默认禁用明文密码传递，需设置
I_KNOW_WHAT_IM_DOING=TRUE才能使用PGPASSWORD
主密码管理
- 自动生成默认主密码，避免新实例默认无密码的安全风险
- 支持通过Docker Swarm Secrets设置主密码（读取
master_password秘密文件） - 自动加密主密码并保存到
ODOO_RC配置文件（Odoo 10+支持）
额外插件支持
- 自动识别
/addons/*目录下的requirements.txt并通过pip安装Python依赖 - 自动安装
/addons/*目录下apt-packages.txt中定义的Debian软件包（基于Ubuntu Bionic）
服务器级模块支持
- 通过模块manifest中的
"server_wide": True属性定义服务器级模块 - 服务器级模块无需安装即可加载，适用于多数据库环境的全局功能
使用场景
- 企业Odoo应用部署（支持多版本）
- 开发环境快速搭建
- 多数据库实例管理
- 定制化Odoo插件开发与测试
使用方法
拉取镜像
以Odoo 13为例：
bashdocker pull docker.xuanyuan.run/llacroix/odoo:13
基本运行
bashdocker run -it docker.xuanyuan.run/llacroix/odoo:13 odoo --db_host [数据库主机]
带额外插件运行
bashdocker run -it -v /本地插件路径:/addons/插件目录 docker.xuanyuan.run/llacroix/odoo:13 --db_host [数据库主机]
环境变量配置
| 变量名 | 定义 |
|---|---|
PGHOST | PostgreSQL主机名/IP |
PGUSER | PostgreSQL连接用户 |
PGDATABASE | 连接的数据库名 |
PGPASSWORD | 连接密码（需配合I_KNOW_WHAT_IM_DOING=TRUE使用） |
I_KNOW_WHAT_IM_DOING | 启用危险配置的触发开关 |
PGRETRY | 连接重试次数 |
PGRETRYTIME | 连接重试间隔时间 |
ODOO_SKIP_POSTGRES_WAIT | 跳过PostgreSQL等待 |
ODOO_RC | Odoo配置文件路径 |
MASTER_PASSWORD | 主密码定义 |
DEPLOYMENT_AREA | 容器部署区域标识（如测试/生产环境） |
ODOO_VERSION | 镜像中的Odoo版本（如13.0） |
ODOO_RELEASE | 镜像中的Odoo发布版本（如20191020） |
ODOO_BASE_PATH | pip安装的Odoo插件基础路径 |
ODOO_DISABLED_MODULES | 逗号分隔的核心模块列表（从路径中移除） |
RESET_ACCESS_RIGHTS | 设置为TRUE在启动时重置访问权限（默认禁用） |
ODOO_EXTRA_PATHS | 逗号分隔的额外插件路径（不在/addons下） |
ODOO_EXCLUDED_PATHS | 逗号分隔的排除路径（及其子目录） |
构建新镜像
通过deploy.py脚本基于versions.toml文件生成Dockerfile：
生成配置（不构建镜像）
bashpython deploy.py --verbose --no-push --no-build-image -a -o .
生成并推送到镜像仓库
bashpython deploy.py --verbose --registry index.docker.io --repository llacroix/odoo -a -o .
构建特定版本（本地测试）
bashpython deploy.py --verbose --no-push -v 14.0 -o .
警告
本项目仍在积极开发中，更新镜像可能导致功能中断。建议在生产环境更新前先在测试环境验证。
已实现功能
- 提供稳定镜像（基于旧版Odoo）和每日更新的nightly标签
- PostgreSQL连接等待机制，防止Odoo启动时挂起
- Odoo 8至13版本的统一配置，兼容openerp/odoo命名差异
- 以odoo用户运行，预配置阶段使用sudo并自动移除权限
- 部署区域标识，支持监控分类
- PostgreSQL环境变量配置与
.pgpass文件支持 - Ubuntu Bionic依赖修复
- 基于
/addons/*目录和环境变量自动构建插件路径 - 符合OCI镜像规范的标签改进
- 服务器级模块自动检测
- 统一的部署/构建脚本
- Dockerfile自动生成（替代手动维护）
更多相关 Docker 镜像与资源
以下是 llacroix/odoo 相关的常用 Docker 镜像，适用于 不同场景 等不同场景：
- library/odoo Docker 镜像说明（Odoo ERP 系统，开源企业管理平台）
- bitnamicharts/odoo Docker 镜像说明（Bitnami Odoo ERP 图表栈，适合企业资源计划与 CRM）
- mintsystem/odoo Docker 镜像说明（Odoo ERP 社区打包（mintsystem），适合企业资源计划部署）
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull llacroix/odoo:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"