什么是“数据库主机”?
数据库主机,在技术上也常被称为 数据库服务器地址 或 数据库主机名。

它就是存放您网站所有数据(如文章、会员、商品、系统设置等)的那台计算机在局域网或互联网上的“门牌号”或“地址”。
- 对于虚拟主机用户:这个地址通常由您的虚拟主机服务商提供,格式可能是一个域名(如
mysql.yourhost.com)或一个IP地址(如168.1.100)。 - 对于VPS/云服务器/独立服务器用户:这个地址通常是您自己服务器上的一个本地地址,最常见的是
localhost或0.0.1,因为数据库和网站程序通常运行在同一台服务器上。
在DedeCMS中如何找到和修改“数据库主机”?
这个配置信息存储在DedeCMS的核心配置文件中,您需要通过FTP或文件管理器来修改它。
第一步:找到配置文件
配置文件名为 common.inc.php,它位于您的DedeCMS安装目录下的 /data/ 文件夹里。
文件路径:/网站根目录/data/common.inc.php

第二步:编辑配置文件
使用FTP工具登录您的服务器,找到上述文件并下载到本地,然后用任何代码编辑器(如 VS Code, Sublime Text, Notepad++ 等)打开它。
第三步:定位并修改配置项
在 common.inc.php 文件中,找到以下这几行代码:
//数据库连接信息 $cfg_dbhost = 'localhost'; // 数据库主机 $cfg_dbname = 'dedecmsv57'; // 数据库名称 $cfg_dbuser = 'root'; // 数据库用户名 $cfg_dbpwd = '123456'; // 数据库密码 $cfg_dbprefix = 'dede_'; // 数据库表前缀 $cfg_db_language = 'gbk'; // 数据库语言版本
您需要修改的就是这一行:
$cfg_dbhost = 'localhost';
第四步:填入正确的值
根据您的服务器环境,填入正确的数据库主机地址:

不同环境下的“数据库主机”值
虚拟主机(最常见)
这是最常见的情况,您需要登录您的虚拟主机控制面板,在“数据库管理”或“MySQL管理”等相关模块中找到您的数据库信息。
- 通常显示为:
mysql.yourhost.com或db.xxxxx.com这样的域名。 - 也可能是:一个IP地址,如
45.67.89。
请务必使用主机服务商提供的准确地址,不要想当然地填写 localhost。
示例:
如果您的虚拟主机商提供的数据库主机是 mysql.my-service-provider.com,那么您就应该修改为:
$cfg_dbhost = 'mysql.my-service-provider.com';
本地服务器(VPS/云服务器/独立服务器)
如果您自己管理服务器,并且数据库和网站都安装在同一个服务器上,那么主机地址就是本机地址。
- 首选值:
localhost - 备选值:
0.0.1
这两个地址都指向本机,通常使用 localhost 即可,但如果连接 localhost 出现问题(在某些Linux系统配置下,localhost 可能会强制使用Unix Socket连接,而您的PHP配置可能使用的是TCP/IP),可以尝试使用 0.0.1。
示例:
$cfg_dbhost = 'localhost';
或者
$cfg_dbhost = '127.0.0.1';
数据库与网站分离(高级部署)
在一些高性能或高安全性的部署方案中,数据库会部署在独立的一台服务器上,而网站程序部署在另一台服务器上。
$cfg_dbhost的值必须是数据库服务器的公网IP地址。
示例:
如果您的数据库服务器IP地址是 0.113.55,那么您就应该修改为:
$cfg_dbhost = '203.0.113.55';
修改后的操作
- 保存文件:编辑完成后,保存
common.inc.php文件。 - 上传文件:通过FTP将修改后的文件上传回服务器的原路径
/data/下,覆盖旧文件。 - 设置权限:确保
common.inc.php文件的权限设置正确,通常是644(所有者可读写,组用户和其他用户只读),这可以增强安全性。 - 测试网站:访问您的网站,检查是否已经恢复正常。
常见问题排查
如果修改后网站依然无法访问,请检查以下几点:
- 数据库信息全部正确:除了主机地址,请再次确认 数据库名
$cfg_dbname、数据库用户名$cfg_dbuser和 数据库密码$cfg_dbpwd是否完全正确,包括大小写。 - 数据库服务是否运行(针对本地服务器):检查您服务器上的MySQL或MariaDB服务是否已经启动。
- 防火墙设置(针对本地服务器或分离部署):检查服务器的防火墙是否已经放行了数据库的端口(默认为
3306)。 - 文件编码:确保您编辑和保存文件时使用的编码是 UTF-8 无BOM 格式,否则可能会导致特殊字符错误。
希望这份详细的指南能帮助您成功解决DedeCMS的数据库主机配置问题!
