参考来源与致谢
- 引用来源:Odoo10配置文件odoo.conf详解
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
Odoo 10 服务端启动时读取配置文件 odoo.conf,用于集中定义模块路径、数据库连接、日志、监听端口、工作进程等运行参数。以下场景适合调整该文件:迁移服务器后需要重新指定路径;数据库与 Odoo 分离部署;需要开启反向代理模式;需要限制单请求资源占用;需要把日志写入文件并按天轮转。修改前应确认当前 Odoo 版本与部署方式,参数名称与默认值可能随版本变化,具体以对应版本官方文档为准。
准备与风险 #
- 备份现有
odoo.conf,并记录当前服务启动命令与工作目录。 - 在测试环境先行验证,确认无误后再变更生产环境。
- 配置文件中的数据库口令、管理员口令等敏感项应通过权限受控的文件或环境变量管理,不要写入公开仓库。
- 错误参数可能导致服务无法启动、数据库连接失败或附件目录指向错误,进而影响业务数据。
- 修改
data_dir前必须确认新目录可写,并评估历史附件与会话数据的迁移方式。
处理步骤 #
- 定位配置文件。常见位置为 Odoo 安装目录下的
server/odoo.conf,或由启动脚本通过-c参数指定。确认实际路径后再编辑。 - 编辑前复制备份,例如保存为
odoo.conf.bak。 - 按需调整以下通用参数,路径与地址使用占位符替换:
[options]
; 模块查找路径,多个目录用英文逗号分隔
addons_path = [模块目录1],[模块目录2]
; 数据目录,存放会话与附件
data_dir = [数据目录]
; 数据库连接
db_host = [数据库主机地址]
db_port = 5432
db_user = [数据库用户名]
db_name = [数据库名]
db_maxconn = 64
; 监听与代理
xmlrpc_port = 8069
longpolling_port = 8072
proxy_mode = False
; 日志
logfile = [日志文件路径]
log_level = info
log_handler = :INFO
logrotate = False
; 工作进程
workers = None
max_cron_threads = 2
; 其他
list_db = True
timezone = [时区]
- 保存文件,检查缩进与分隔符。参数值不要加多余引号,布尔值按版本要求填写。
- 重启 Odoo 服务使配置生效。重启属于影响业务的操作,应安排在维护窗口并提前通知。
验证方法 #
- 查看服务状态与启动日志,确认无配置解析错误。
- 访问 Web 界面,确认登录、模块加载与附件读取正常。
- 检查日志文件是否按预期生成,日志级别是否符合预期。
- 确认数据库连接数、监听端口与反向代理转发均正常。
- 如启用了工作进程,观察并发请求下服务是否稳定。
回退建议 #
若验证失败,立即停止服务,用备份文件覆盖当前配置,再重启服务。若涉及 data_dir 变更,需同时恢复原数据目录指向。回退后确认数据库与附件访问恢复正常,再分析失败原因。不要在未备份的情况下反复修改生产配置。
常见问题 #
- 服务启动报配置错误:检查参数名拼写、分隔符与布尔值写法。
- 模块未加载:确认
addons_path是否包含全部模块目录。 - 附件无法访问:确认
data_dir指向正确且服务账号有读写权限。 - 数据库连接失败:核对主机、端口、用户名与数据库名,确认数据库服务可达。
- 日志未生成:确认
logfile路径存在且可写,日志级别设置合理。 - 反向代理下地址异常:按部署方式评估是否开启
proxy_mode。
提示:不同版本对参数的支持范围与默认值存在差异,生产变更前请查阅对应版本官方文档,并在测试环境验证。
