Doodba Copier Template 常见问题解答与技术指南

前言

Doodba Copier Template 是一个用于快速构建 Odoo 开发环境的项目模板，基于 Docker 容器化技术。本文将针对该模板使用过程中的常见问题进行详细解答，并提供专业的技术指导。

自定义模板相关问题

能否使用私有模板？

是的，通过 Copier 工具可以同时使用公共模板和私有模板。建议为每个模板使用独立的答案文件以避免混淆：

# 首次复制时
copier --answers-file .copier-answers.private.yml copy 私有模板地址 .

# 更新时
copier --answers-file .copier-answers.private.yml update .

这种分离管理的方式可以确保不同模板的配置不会相互干扰。

环境配置问题

能否将开发环境用于生产？

技术上可行但不推荐。开发环境(devel.yaml)缺少生产环境所需的安全配置和优化参数，长期运行可能存在稳定性风险。

如何配置 POS/IoT 盒子服务？

POS 盒子开发需要特殊硬件支持，模板默认不包含相关配置。但可以通过以下方式模拟测试环境：

1. 添加 USB 工具依赖(usbutils)
2. 安装 Python 依赖(evdev和netifaces)
3. 创建特权容器，加载硬件驱动模块
4. 配置端口映射(如8070)

具体实现可参考文档中的示例补丁。注意这只能用于基础功能测试，无法完全替代真实硬件环境。

网络与代理配置

如何设置全局反向代理？

推荐使用 Traefik 作为统一入口，文档提供了三个版本的配置示例：

1. Traefik v1：基础配置，支持自动HTTPS重定向
2. Traefik v2：增强错误处理，支持中间件
3. Traefik v3：新增数据库直连支持

核心功能包括：

• 自动HTTPS重定向(80→443)
• Let's Encrypt证书自动管理
• Docker服务自动发现
• 安全增强的socket代理

启动命令：

docker compose -p inverseproxy -f inverseproxy.yaml up -d

如何允许外部访问特定服务？

使用tecnativa/whitelist镜像可以创建服务白名单。这在需要访问外部API(如Google Fonts)时特别有用。

开发相关问题

如何为外部仓库(如OCA)开发？

推荐工作流程：

1. 创建专门开发子项目
2. 在addons.yaml中添加目标仓库
3. 正常开发并提交PR
4. 在生产环境repos.yaml中引用该PR

如何修改报表字体？

默认使用Liberation字体，修改方式：

1. 在apt.txt添加字体包
2. 或通过build.d自定义安装脚本
3. 通过构建参数指定默认字体：
   • FONT_MONO：等宽字体
   • FONT_SANS：无衬线字体
   • FONT_SERIF：衬线字体

报表资源加载问题

确保设置系统参数report.url为http://localhost:8069，这样报表生成时能正确加载静态资源。

测试与质量保证

如何进行CI测试？

项目内置/qa目录提供测试基础设施，配合专用QA工具可实现：

• 自动化测试
• 质量检查
• 持续集成

测试失败时，截图和录屏会保存在指定位置，便于问题排查。

故障排查

数据库未初始化错误

通常是因为PostgreSQL服务未就绪或连接配置错误。检查：

1. 数据库容器是否正常运行
2. 连接参数是否正确
3. 网络配置是否允许访问

调试器连接问题

JavaScript调试常见问题：

1. 连接拒绝：检查调试端口是否开放
2. 浏览器扩展不可见：确保使用正确配置文件启动
3. 断点不生效：检查源映射配置

XML格式化问题

pre-commit可能会自动格式化XML文件。如需保留原格式，可以：

1. 临时跳过pre-commit
2. 配置格式化规则例外
3. 使用版本控制恢复更改

模板升级问题

升级失败处理

旧版模板升级时可能遇到：

1. Prettier格式化失败：手动修复格式冲突
2. pre-commit安装失败：清理旧配置后重试
3. Copier回答无效：检查并更新答案文件格式

建议升级前备份重要修改，并分阶段验证各组件兼容性。

结语

Doodba Copier Template 提供了高度集成的Odoo开发环境，通过本文的解决方案可以快速解决大部分使用问题。对于特殊需求，项目保持开放态度，欢迎基于实际场景提出改进建议。