核心答案
DedeCMS 的数据库配置文件位于:

(图片来源网络,侵删)
/data/common.inc.php
这个文件位于您网站根目录下的 data 文件夹中。
详细说明与操作指南
文件位置示意图
假设您的网站安装在 /var/www/html/ 目录下,那么配置文件的完整路径就是:
/var/www/html/data/common.inc.php
如何修改数据库配置?
当您需要修改数据库信息时(更换服务器、修改密码、数据库名等),请按照以下步骤操作:

(图片来源网络,侵删)
第一步:通过 FTP 或文件管理器找到文件
使用您的 FTP 工具(如 FileZilla, FlashFXP)或主机控制面板中的文件管理器,登录到您的网站服务器,找到并进入 data 文件夹。
第二步:下载并编辑文件
-
下载
common.inc.php文件到您的本地电脑。
(图片来源网络,侵删) -
使用任何代码编辑器(如 VS Code, Sublime Text, Notepad++ 或记事本)打开这个文件。
-
找到类似下面的代码段:
<?php //数据库连接信息 $cfg_dbhost = 'localhost'; //数据库主机 $cfg_dbname = 'dedecmsv57'; //数据库名 $cfg_dbuser = 'root'; //数据库用户名 $cfg_dbpwd = 'your_password'; //数据库密码 $cfg_dbprefix = 'dede_'; //数据表前缀,请注意网站安装时设定的前缀是什么 $cfg_db_language = 'gbk'; //数据库编码,建议 utf-8 ?>
第三步:修改配置信息
根据您的实际数据库信息,修改以下四个变量的值:
$cfg_dbhost: 数据库主机地址,通常是localhost,但如果您的数据库在另一台服务器上,则需要填写服务器的 IP 地址或域名。$cfg_dbname: 数据库名称,您在创建数据库时设定的名字。$cfg_dbuser: 数据库用户名,拥有该数据库操作权限的用户名。$cfg_dbpwd: 数据库密码,对应用户的密码。$cfg_dbprefix: 数据表前缀。非常重要! 如果您在安装时修改了默认的前缀(例如从dede_改成了mycms_),这里也必须保持一致,否则网站将无法正常连接数据库,导致后台无法登录、前台空白等问题。$cfg_db_language: 数据库字符集,强烈建议使用utf8,以支持多语言和特殊字符。
第四步:保存并上传文件
- 保存您修改后的
common.inc.php文件。 - 通过 FTP 或文件管理器,将修改后的文件上传回服务器的原位置 (
/data/目录),覆盖掉旧文件。
安全提示
data 目录和 common.inc.php 文件是 DedeCMS 的核心配置,安全性至关重要。
-
设置目录权限:确保
data目录的权限设置为 755,这是最安全的设置。 -
设置文件权限:
common.inc.php文件的权限可以设置为 644。 -
禁止访问:在
.htaccess文件中添加以下规则,可以防止用户通过浏览器直接访问data目录下的 PHP 文件,大大提高安全性,如果您的网站根目录下没有.htaccess文件,请自行创建一个。在
.htaccess文件中添加:<Files "*.php"> Order deny,allow Deny from all </Files>
| 项目 | |
|---|---|
| 配置文件路径 | /data/common.inc.php |
| 需要修改的变量 | $cfg_dbhost, $cfg_dbname, $cfg_dbuser, $cfg_dbpwd, $cfg_dbprefix |
| 安全建议 | 确保 data 目录权限为 755,common.inc.php 权限为 644,并配置 .htaccess 禁止直接访问。 |
找到并正确修改 common.inc.php 文件,是解决 DedeCMS 数据库连接问题的第一步。
