禅道忘记密码如何重置？

Question

禅道忘记密码后如何重置管理员密码？这是用户在使用禅道项目管理系统时常遇到的问题。当管理员账户密码遗忘且无法通过邮箱找回时，系统将无法正常登录和管理。常见场景包括测试环境未配置邮件服务，或生产环境中管理员离职导致账户锁定。此时需通过数据库直连或命令行工具重置密码。但操作过程中易出现因加密方式（如md5加盐）不熟悉而导致重置失败，或修改后仍无法登录的问题。此外，不同版本禅道（如zentao系列）的用户表结构略有差异，直接SQL修改存在风险。因此，如何安全、准确地重置密码成为运维人员关注的重点。

Answer 1

一、禅道密码重置的背景与核心挑战

禅道（Zentao）作为国内广泛使用的开源项目管理工具，集成了需求管理、任务跟踪、缺陷管理与测试用例等功能。在实际运维过程中，管理员账户（通常是admin）拥有最高权限，一旦密码遗忘且无法通过邮箱找回（如测试环境未配置SMTP服务或原管理员离职），系统将陷入“管理真空”状态。

传统密码找回机制依赖邮件验证，但在内网测试环境或安全策略限制下常不可用。此时需绕过前端界面，直接干预后端数据存储层实现密码重置。然而，禅道自7.0版本起采用md5(密码 + salt)加盐哈希机制存储密码，若不了解其加密逻辑，直接写入明文或简单MD5值将导致登录失败。

此外，不同版本禅道的数据库表结构存在差异：早期版本使用zt_user表，而新版可能涉及zt_account或字段命名变化（如password vs passwd），盲目执行SQL易引发兼容性问题。

二、密码加密机制深度解析

禅道采用双重安全策略保护用户密码：

1. 加盐哈希：每个用户拥有独立salt字段，密码加密公式为 md5(md5(明文密码) + salt)。
2. 动态salt生成：salt通常为8位随机字符串，由系统注册时生成并存入数据库。

示例计算过程如下：

明文密码: "123456"
第一步 MD5: md5("123456") = "e10adc3949ba59abbe56e057f20f883e"
假设 salt = "abcd1234"
拼接: "e10adc3949ba59abbe56e057f20f883e" + "abcd1234"
第二步 MD5: md5("e10adc3949ba59abbe56e057f20f883eabcd1234") = "5e9d5b5a3f8c7a4b2c1d6e7f8a9b0c1d"
最终存入数据库的 passwd 值即为此结果。
    

三、通用密码重置操作流程

以下步骤适用于大多数禅道版本（建议先备份数据库）：

步骤	操作内容	命令/说明
1	登录数据库	mysql -u root -p zentao_db
2	查看用户表	SELECT id,account,salt,passwd FROM zt_user WHERE account='admin';
3	生成新密码哈希	使用PHP脚本或在线工具生成符合规则的密文
4	更新密码字段	UPDATE zt_user SET passwd='生成的密文' WHERE account='admin';
5	清空登录失败记录	UPDATE zt_user SET failedLogin=0, lockedUntil=0 WHERE account='admin';
6	重启Web服务	systemctl restart apache2 或对应服务

四、自动化脚本辅助重置

为避免手动计算错误，可编写PHP脚本自动完成加密过程：

<?php
$plainPassword = 'newpassword123';
$salt = 'your_salt_from_db'; // 从数据库获取admin用户的salt值

$firstMd5 = md5($plainPassword);
$combined = $firstMd5 . $salt;
$finalPasswd = md5($combined);

echo "Generated passwd: " . $finalPasswd . "\n";
?>
    

运行该脚本后，将输出结果填入数据库更新语句中，确保加密一致性。

五、版本差异与风险规避策略

不同禅道版本的主要差异点如下：

• 禅道 8.x ~ 12.x：表名为zt_user，字段为account, passwd, salt
• 禅道 15+：引入微服务架构，部分认证迁移至zentao-account模块，需检查OAuth配置
• MySQL vs SQLite：部分集成包使用SQLite，连接方式为sqlite3 /data/zentao/db/zentaopms.db

推荐操作前执行：

# 备份数据库
mysqldump -u root -p zentao_db > zentao_backup_$(date +%F).sql
    

六、高级场景处理：无Salt恢复模式

当无法获取原始salt时（如误删记录），可采用强制重置方案：

1. 插入一条新的admin记录，并指定可控的salt值；
2. 或将passwd和salt字段同时置为空，触发系统重置逻辑。

Mermaid流程图展示决策路径：

graph TD
    A[忘记管理员密码] --> B{能否访问数据库?}
    B -- 是 --> C[查询zt_user表中admin的salt]
    B -- 否 --> D[检查是否有备份或日志]
    C --> E[使用PHP脚本生成新passwd]
    E --> F[执行UPDATE语句]
    F --> G[清除锁定状态]
    G --> H[尝试登录]
    H --> I[成功?]
    I -- 是 --> J[完成]
    I -- 否 --> K[检查版本兼容性/加密逻辑]
    K --> L[重新验证salt与hash流程]