用途：该技能用于搭建 Odoo 的 Docker 部署环境，覆盖本地开发与生产部署（VPS、AWS、DigitalOcean 等），也可用于排查 Odoo 容器启动失败或数据库连接错误，以及为现有部署添加带 SSL 的反向代理。
主要能力：生成可直接运行的 docker-compose.yml 与 odoo.conf，包含 PostgreSQL 服务、持久化卷（postgres-data、odoo-web-data）、自定义模块挂载（./addons 到 /mnt/extra-addons）、环境变量注入密码、Odoo 端口 8069 与长轮询端口 8072，以及内部 Docker 网络。odoo.conf 支持 workers、max_cron_threads、内存与超时限制等参数调优。
使用方式：提及 @odoo-docker-deployment 并描述部署场景即可生成配置；描述容器错误可获得诊断与修复建议。常用命令包括 docker compose up -d、docker compose logs -f odoo、docker compose restart odoo、docker compose down，以及用 pg_dump 备份数据库、用 odoo -d odoo --update my_module --stop-after-init 更新模块。
最佳实践：密钥放入 .env 并用 ${VAR} 引用；用 depends_on 配合 PostgreSQL 健康检查；Nginx 前置做 SSL 终止；workers 设为 (CPU 核数 × 2) + 1；不要公开 5432 端口；生产环境固定镜像标签如 odoo:17.0。
限制：仅覆盖自托管 Docker 部署，不涉及 Odoo.sh；多容器水平扩展所需的共享 filestore（NFS 或兼容 S3 存储）未包含；不提供 Nginx 配置模板；升级基础镜像后需重新确认 addons_path。