参考来源与致谢
- 引用来源:How to Reset or Change Your Odoo Master Password – Knowledgebase – SolaDrive
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
Odoo 主密码(配置项 admin_passwd)用于保护数据库管理页面,例如创建、复制、删除、备份和还原数据库。以下情况需要修改或重置主密码:
- 已知当前主密码,需要定期轮换。
- 主密码遗失,无法进入数据库管理页面。
- 运维交接或安全审计要求更换凭据。
本文仅讨论主密码,不涉及数据库用户密码或管理员登录密码。不同 Odoo 版本在配置项名称、服务名和哈希方案上可能存在差异,操作前请查阅对应版本文档确认。
准备与风险 #
- 确认 Odoo 配置文件路径,常见为
/etc/odoo.conf或/etc/odoo/odoo.conf,以实际部署为准。 - 确认 Odoo 服务名称,例如
odoo、odoo13等,使用systemctl status [服务名]核对。 - 修改前备份配置文件,例如复制为
[配置文件].bak,并记录当前admin_passwd行内容。 - 建议先在测试环境验证流程,再在生产环境执行。
- 重启服务会短暂中断用户访问,应安排在维护窗口。
- 主密码属于敏感凭据,禁止写入工单、聊天记录或明文文档。
涉及配置文件修改和服务重启属于有影响操作。务必先完成备份,并确认可在失败时恢复原文件。
处理步骤 #
方式一:图形界面修改已知主密码 #
- 浏览器访问
[外部链接已移除],端口默认通常为8069。 - 点击设置主密码入口。
- 输入当前主密码与新主密码,提交保存。
- 若页面未出现该入口,说明当前实例可能未启用数据库管理页面,需改用命令行方式。
方式二:命令行重置遗忘的主密码 #
- 通过 SSH 登录服务器。
- 备份配置文件:
sudo cp [配置文件] [配置文件].bak。 - 编辑配置文件:
sudo nano [配置文件]。 - 找到以
admin_passwd开头的行,在该行行首添加分号;将其注释。 - 保存退出,重启服务:
sudo systemctl restart [服务名]。 - 再次访问数据库管理页面,按提示设置新的主密码。
方式三:命令行直接替换主密码哈希 #
- 切换到 Odoo 运行用户:
sudo su [Odoo运行用户]。 - 激活虚拟环境:
source [虚拟环境路径]/bin/activate。 - 进入 Python:
python3。 - 生成哈希:
from passlib.context import CryptContext,随后执行print(CryptContext(schemes=['pbkdf2_sha512']).encrypt('[新主密码]'))。 - 复制输出的哈希字符串,退出 Python 与当前用户。
- 编辑配置文件,将
admin_passwd的值替换为新哈希。 - 保存退出并重启服务。
哈希方案与可用模块随版本变化,若上述方案不可用,请查阅对应版本文档确认推荐做法。
验证方法 #
- 访问数据库管理页面,确认可正常进入且旧密码失效。
- 使用新主密码执行一次只读操作,例如查看数据库列表,确认鉴权通过。
- 检查服务日志,确认重启后无配置解析错误。
- 确认其他依赖该配置的自动化任务未受影响。
回退建议 #
- 若新密码无法生效,停止服务并恢复备份配置文件。
- 重启服务,确认恢复原有访问能力。
- 排查配置语法、缩进、引号及哈希格式是否正确。
- 回退后重新评估流程,必要时在测试环境复现。
常见问题 #
- 数据库管理页面无法访问:检查服务状态、监听端口与反向代理配置。
- 修改后仍提示旧密码:确认修改的是当前生效的配置文件,并已重启服务。
- 哈希替换后登录失败:确认哈希完整复制,未混入换行或多余空格。
- 多实例环境:每个实例有独立配置文件,需分别处理。
- 容器化部署:配置可能通过环境变量或挂载文件注入,修改方式不同,请查阅对应部署文档。
