---
title: Odoo 主密码重置与修改操作指南
description: 面向企业 IT 运维，说明 Odoo 主密码（admin_passwd）的作用、图形界面修改方式、命令行重置与哈希替换流程，并给出备份、验证、回退与常见问题处理建议。
url: "https://www.lanever.com/docs/odoo-%e4%b8%bb%e5%af%86%e7%a0%81%e9%87%8d%e7%bd%ae%e4%b8%8e%e4%bf%ae%e6%94%b9%e6%93%8d%e4%bd%9c%e6%8c%87%e5%8d%97/"
updated: "2026-10-12"
category: Odoo
---

# Odoo 主密码重置与修改操作指南

> **参考来源与致谢**
>
>
>
> - **引用来源：**[How to Reset or Change Your Odoo Master Password - Knowledgebase - SolaDrive](https://www.soladrive.com/support/knowledgebase/4831/How-to-Reset-or-Change-Your-Odoo-Master-Password.html)
> - **原作者：**原页面署名作者或发布机构（剪藏记录未保存可核验的个人署名）
> - **感谢词：**感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写，并非原文转载；如权利人需要更正署名或来源信息，请联系本站。

## 适用场景

Odoo 主密码（配置项 `admin_passwd`）用于保护数据库管理页面，例如创建、复制、删除、备份和还原数据库。以下情况需要修改或重置主密码：

- 已知当前主密码，需要定期轮换。
- 主密码遗失，无法进入数据库管理页面。
- 运维交接或安全审计要求更换凭据。

本文仅讨论主密码，不涉及数据库用户密码或管理员登录密码。不同 Odoo 版本在配置项名称、服务名和哈希方案上可能存在差异，操作前请查阅对应版本文档确认。

## 准备与风险

- 确认 Odoo 配置文件路径，常见为 `/etc/odoo.conf` 或 `/etc/odoo/odoo.conf`，以实际部署为准。
- 确认 Odoo 服务名称，例如 `odoo`、`odoo13` 等，使用 `systemctl status [服务名]` 核对。
- 修改前备份配置文件，例如复制为 `[配置文件].bak`，并记录当前 `admin_passwd` 行内容。
- 建议先在测试环境验证流程，再在生产环境执行。
- 重启服务会短暂中断用户访问，应安排在维护窗口。
- 主密码属于敏感凭据，禁止写入工单、聊天记录或明文文档。

> 涉及配置文件修改和服务重启属于有影响操作。务必先完成备份，并确认可在失败时恢复原文件。

## 处理步骤

### 方式一：图形界面修改已知主密码

1. 浏览器访问 `[外部链接已移除]`，端口默认通常为 `8069`。
2. 点击设置主密码入口。
3. 输入当前主密码与新主密码，提交保存。
4. 若页面未出现该入口，说明当前实例可能未启用数据库管理页面，需改用命令行方式。

### 方式二：命令行重置遗忘的主密码

1. 通过 SSH 登录服务器。
2. 备份配置文件：`sudo cp [配置文件] [配置文件].bak`。
3. 编辑配置文件：`sudo nano [配置文件]`。
4. 找到以 `admin_passwd` 开头的行，在该行行首添加分号 `;` 将其注释。
5. 保存退出，重启服务：`sudo systemctl restart [服务名]`。
6. 再次访问数据库管理页面，按提示设置新的主密码。

### 方式三：命令行直接替换主密码哈希

1. 切换到 Odoo 运行用户：`sudo su [Odoo运行用户]`。
2. 激活虚拟环境：`source [虚拟环境路径]/bin/activate`。
3. 进入 Python：`python3`。
4. 生成哈希：`from passlib.context import CryptContext`，随后执行 `print(CryptContext(schemes=['pbkdf2_sha512']).encrypt('[新主密码]'))`。
5. 复制输出的哈希字符串，退出 Python 与当前用户。
6. 编辑配置文件，将 `admin_passwd` 的值替换为新哈希。
7. 保存退出并重启服务。

哈希方案与可用模块随版本变化，若上述方案不可用，请查阅对应版本文档确认推荐做法。

## 验证方法

- 访问数据库管理页面，确认可正常进入且旧密码失效。
- 使用新主密码执行一次只读操作，例如查看数据库列表，确认鉴权通过。
- 检查服务日志，确认重启后无配置解析错误。
- 确认其他依赖该配置的自动化任务未受影响。

## 回退建议

- 若新密码无法生效，停止服务并恢复备份配置文件。
- 重启服务，确认恢复原有访问能力。
- 排查配置语法、缩进、引号及哈希格式是否正确。
- 回退后重新评估流程，必要时在测试环境复现。

## 常见问题

- 数据库管理页面无法访问：检查服务状态、监听端口与反向代理配置。
- 修改后仍提示旧密码：确认修改的是当前生效的配置文件，并已重启服务。
- 哈希替换后登录失败：确认哈希完整复制，未混入换行或多余空格。
- 多实例环境：每个实例有独立配置文件，需分别处理。
- 容器化部署：配置可能通过环境变量或挂载文件注入，修改方式不同，请查阅对应部署文档。
