- 出于安全考虑:定期更换数据库密码是良好的安全习惯。
- 服务器环境变更:从本地环境迁移到云服务器,或数据库服务(如 MySQL/MariaDB)的 root 密码被修改。
- 忘记密码:不常见,但有可能发生。
更改密码主要涉及两个步骤:

(图片来源网络,侵删)
- 修改数据库本身的密码。
- 更新 DedeCMS 配置文件中存储的密码。
下面我将为您提供详细的图文步骤指南。
核心步骤概览
- 登录数据库管理系统,修改数据库用户密码。
- 登录网站后台,修改配置文件
data/common.inc.php中的密码。 - 验证修改是否成功。
第一步:修改数据库本身的密码
你需要通过数据库管理工具(如 phpMyAdmin、MySQL 命令行等)来操作。
方法 A:通过 phpMyAdmin (最常用)
-
登录 phpMyAdmin:在你的网站控制面板(如 cPanel、宝塔面板等)中找到 phpMyAdmin 并登录,通常需要使用数据库服务器的
root用户名和密码。 -
选择数据库:在左侧的数据库列表中,找到你的 DedeCMS 网站所使用的数据库。
(图片来源网络,侵删) -
进入“权限”页面:点击顶部的 “权限” (Privileges) 选项卡。
-
编辑用户:在用户列表中,找到 DedeCMS 所使用的数据库用户(
dede_user),点击该用户名对应的 “编辑权限” (Edit privileges) 链接。(这是一个示例截图,界面可能因版本不同而略有差异)
-
修改密码:
(图片来源网络,侵删)- 向下滚动到 “更改密码” (Change password) 部分。
- 选择 “输入密码” (Input password below)。
- 在“密码”和“重新输入密码”两个框中输入你的新密码。
- 点击 “执行” (Go) 按钮。
-
确认修改:系统会提示你密码已成功更改。
至此,数据库本身的密码已经修改完成,但此时你的网站会因为配置文件中的旧密码而无法连接数据库,导致网站无法访问,所以必须进行第二步。
第二步:更新 DedeCMS 配置文件
你需要告诉 DedeCMS 你的数据库新密码,信息存储在 data/common.inc.php 文件中。
-
通过 FTP 或文件管理器访问文件:
- 使用 FTP 工具(如 FileZilla)或你的主机控制面板中的文件管理器,登录到你的网站根目录。
- 找到并进入
data文件夹。 - 编辑
common.inc.php文件。
-
修改数据库密码配置:
- 使用文本编辑器(如 Notepad++, VS Code, 或在线编辑器)打开
common.inc.php。 - 找到
$cfg_dbpwd这一行,它定义了数据库连接密码。 - 将引号内的值修改为你在第一步中设置的新密码。
// 修改前 $cfg_dbpwd = '你的旧密码'; // 修改后 $cfg_dbpwd = '你的新密码';
- 使用文本编辑器(如 Notepad++, VS Code, 或在线编辑器)打开
-
保存文件:
- 保存对
common.inc.php文件的修改。 - 重要提示:为了安全起见,在保存后,建议将
data目录的权限设置为755,并将common.inc.php文件的权限设置为644,这可以防止其他用户写入该文件。
- 保存对
第三步:验证修改
完成以上两步后,你的网站应该可以恢复正常了。
- 访问网站前台:在浏览器中打开你的网站主页,如果能正常显示,说明配置正确。
- 访问网站后台:尝试登录 DedeCMS 的后台管理 (
/dede/login.php),如果成功登录,则说明所有更改都已生效。
如果网站仍然无法访问或出现数据库连接错误,请仔细检查以下两点:
- 第一步:确认在数据库中修改的密码是否正确。
- 第二步:确认
common.inc.php文件中的$cfg_dbpwd变量值是否与数据库新密码完全一致,包括大小写和特殊字符。
重要注意事项
- 备份!备份!备份!:在进行任何文件或数据库修改之前,务必备份你的整个网站文件和数据库,这是防止意外发生导致数据丢失的最佳实践。
- 使用强密码:新密码应包含大小写字母、数字和特殊符号,长度至少为 12 位,以确保数据库安全。
- 修改
root密码:如果你修改的是数据库root用户的密码,那么不仅需要修改common.inc.php,还需要确保你的 phpMyAdmin 登录信息也已更新。 - 多站点环境:如果你在一个数据库中运行了多个 DedeCMS 网站,请确保所有网站的
common.inc.php文件都已更新为新的密码。
按照以上步骤操作,你应该可以顺利地更改 DedeCMS 的数据库密码。
