- 修改数据库本身的密码。
- 修改 DedeCMS 配置文件,使其能连接到新密码的数据库。
下面我将为您提供详细的图文步骤说明,请根据您的服务器环境(如宝塔面板、DedeCMS 自带后台、或通过代码编辑)选择适合您的方法。

(图片来源网络,侵删)
⚠️ 重要提醒:操作前必读
- 备份数据!备份数据!备份数据! 在进行任何数据库修改之前,请务必备份您的整个网站文件和数据库,这是最关键的一步,可以防止操作失误导致网站无法访问。
- 确认新密码:提前想好一个复杂的新密码,并记好它。
- 修改后立即清除缓存:修改后如果网站显示异常,请尝试登录 DedeCMS 后台,点击“系统” -> “SQL命令行工具” -> “执行清除所有缓存”。
通过宝塔面板(推荐,最简单)
如果您使用的是宝塔面板来管理网站,这是最直观、最安全的方法。
步骤 1:在宝塔面板中修改数据库密码
- 登录您的宝塔面板。
- 在左侧菜单中找到并点击 “数据库”。
- 在数据库列表中,找到您 DedeCMS 网站所使用的那一个数据库(
dedecms_v57)。 - 在该数据库行右侧,点击 “管理” 按钮,会弹出一个新的数据库管理窗口(如 phpMyAdmin)。
- 在 phpMyAdmin 界面,点击顶部的 “权限” 选项卡。
- 在权限列表中,找到您 DedeCMS 使用的数据库用户名(通常和数据库同名,如
dedecms_v57),点击其右侧的 “编辑权限” 链接。 - 在“更改密码”部分,选择“输入密码”,然后输入您的新密码,并再次确认。
- 滚动到页面底部,点击 “执行” 按钮保存,数据库本身的密码已经修改成功。
步骤 2:在宝塔面板中修改 DedeCMS 配置文件
- 返回宝塔面板主界面,点击 “文件”。
- 进入您网站的根目录(通常是
wwwroot或public_html)。 - 找到并打开
/data/common.inc.php文件。注意: 如果您的网站是安装子目录,路径可能不同,但/data/目录和这个文件名是固定的。 - 在文件中找到以下三行代码,并将它们的值修改为正确的信息:
//数据库连接信息 $cfg_dbhost = 'localhost'; // 数据库主机,通常是 localhost $cfg_dbname = '您的数据库名'; // 您的数据库名 $cfg_dbuser = '您的数据库用户名'; // 您的数据库用户名 $cfg_dbpwd = '您刚刚设置的新密码'; // **【重点】** 在这里填入您的新密码 $cfg_dbprefix = 'dede_'; // 数据库表前缀,请勿随意修改
- 修改完成后,保存文件并关闭。
访问您的网站,应该可以正常打开了。
通过 DedeCMS 后台自带功能(无需代码)
如果你的主机没有使用面板,或者你不想直接操作文件,这个方法很方便。
步骤 1:修改数据库密码
- 您需要通过您的主机控制面板(如 cPanel、Plesk)或自带的数据库管理工具(如 phpMyAdmin)来修改数据库密码,这个过程和方法一的步骤 1 基本相同。
- 登录您的数据库管理工具(phpMyAdmin)。
- 选择您的数据库。
- 点击“权限” -> “编辑权限” -> “更改密码” -> 输入新密码 -> “执行”。
步骤 2:在 DedeCMS 后台修改配置
- 登录您的 DedeCMS 管理后台。
- 在左侧菜单中,找到 “系统” -> “数据库备份/还原”。
- 在打开的页面中,找到右上角的 “配置数据库连接信息” 按钮,点击它。
- 在弹出的表单中,您会看到当前的数据库连接信息。
- 数据库服务器:通常是
localhost,除非您的数据库和网站不在同一台服务器上。 - 数据库用户名:您的数据库用户名。
- 数据库密码:【重点】 在这里填入您刚刚设置的新密码。
- 数据库名:您的数据库名。
- 数据库前缀:通常无需修改。
- 数据库服务器:通常是
- 填写完成后,点击 “提交” 或 “保存” 按钮。
系统会自动修改 /data/common.inc.php 文件,完成配置。

(图片来源网络,侵删)
通过代码直接修改(适用于没有面板和后台的情况)
如果你只有 FTP/SFTP 或 SSH 文件访问权限,可以使用此方法。
步骤 1:修改数据库密码
同样,这一步需要通过 phpMyAdmin 或其他命令行工具(如 mysql 命令)来完成,与方法一和二的步骤 1 相同。
步骤 2:手动编辑配置文件
- 使用 FTP/SFTP 工具(如 FileZilla)或 SSH 连接到您的服务器。
- 进入网站根目录,找到
/data/common.inc.php文件。 - 下载这个文件到本地电脑。
- 使用代码编辑器(如 VS Code, Sublime Text, Notepad++)打开它。
- 找到并修改以下变量:
$cfg_dbhost = 'localhost'; $cfg_dbname = '您的数据库名'; $cfg_dbuser = '您的数据库用户名'; $cfg_dbpwd = '您刚刚设置的新密码'; // **【重点】** 修改这里 $cfg_dbprefix = 'dede_';
- 保存文件,然后将其上传回服务器的
/data/目录,覆盖原文件。
故障排查
如果修改后网站出现以下问题,可以尝试以下解决方案:
-
网站首页空白,或提示“无法连接数据库”
(图片来源网络,侵删)- 原因:
common.inc.php文件中的数据库信息(尤其是密码)不正确。 - 解决:请再次检查
common.inc.php文件中的$cfg_dbpwd变量是否与您在数据库中设置的新密码完全一致,注意大小写和特殊符号。
- 原因:
-
网站后台可以打开,但前台报错
- 原因:可能是缓存问题。
- 解决:登录 DedeCMS 后台,进入“系统” -> “SQL命令行工具”,在“其他维护”选项卡下找到“清除所有缓存”并执行。
-
提示
/data/common.inc.php文件不存在或不可写- 原因:文件被误删,或者文件权限不正确(Linux 下通常需要设置为 644)。
- 解决:如果是误删,请从备份中恢复,如果是权限问题,通过 FTP/SFTP 工具右键该文件,修改权限为 644。
希望这份详细的指南能帮助您顺利完成密码修改!
