- 创建数据库和用户(在数据库管理软件中操作)
- 配置 DedeCMS 安装程序(在浏览器中操作)
第一步:创建数据库和用户
在 DedeCMS 安装时,它需要一个已经存在的空数据库,我们通常使用 phpMyAdmin 来管理 MySQL/MariaDB 数据库,它几乎所有的本地环境集成包(如 XAMPP, WampServer, 宝塔面板等)都默认集成了。

(图片来源网络,侵删)
前提条件
- 你已经成功安装了本地服务器环境(如 XAMPP, WampServer 等)。
- 数据库服务(MySQL 或 MariaDB)已经启动。
操作步骤
-
启动 phpMyAdmin
- 如果你使用 XAMPP/WampServer:在浏览器地址栏输入
http://localhost/phpmyadmin/并回车。 - 如果你使用宝塔面板:登录面板,在“文件”中找到网站根目录,或者在“数据库”里直接点击 phpMyAdmin。
- 如果你使用 XAMPP/WampServer:在浏览器地址栏输入
-
登录 phpMyAdmin
- 默认情况下,本地环境的登录用户名是
root,密码通常为空()或者是你自己设置的密码,直接点击“执行”或“登录”即可。
- 默认情况下,本地环境的登录用户名是
-
创建新数据库
- 登录后,在 phpMyAdmin 的主界面,找到“新建”选项卡。
- 在“数据库名称”输入框中,为你本地的测试数据库起一个名字,建议使用有意义的名称,
dede_test或my_local_cms。 - “排序规则” (Collation) 保持默认的
utf8mb4_general_ci即可,这能很好地支持中文字符。 - 点击“创建”按钮。
-
创建数据库用户并授权
- 强烈建议:不要直接使用
root用户来给 DedeCMS 使用,出于安全考虑,我们应该为 DedeCMS 创建一个专有的、权限受限的用户。 - 在创建完数据库后,phpMyAdmin 会自动跳转到新数据库的管理页面,点击顶部的“权限”选项卡。
- 在“权限”页面,点击“添加用户账户”链接。
- 用户名:输入一个新用户名,
dede_user。 - 主机:这个选项非常重要,对于本地测试,选择“本地”即可,它会自动解析为
localhost,这表示该用户只能从本机连接数据库,安全性更高。 - 密码:输入一个强密码,
your_strong_password_123。 - 重新输入密码:再次输入相同的密码。
- 全局权限:保持全部为未选中状态,因为我们只需要这个用户对我们刚刚创建的
dede_test数据库有操作权限,而不需要管理所有数据库的全局权限。 - 向下滚动页面,找到“数据库专有权限”部分。
- 在“添加权限到下列数据库”的下拉菜单中,选择我们刚刚创建的数据库
dede_test。 - 勾选所有权限(或者至少勾选
ALL PRIVILEGES),然后点击“执行”。
- 强烈建议:不要直接使用
你已经准备好了一个名为 dede_test 的空数据库,以及一个拥有该数据库全部操作权限的用户 dede_user(密码为 your_strong_password_123)。
第二步:配置 DedeCMS 安装程序
你需要在浏览器中运行 DedeCMS 的安装向导,并填入刚才创建的信息。
-
放置 DedeCMS 程序文件
- 将你下载的 DedeCMS 程序包解压。
- 将解压后的文件夹(
dedecms)复制到你的本地服务器网站根目录下。- XAMPP:
C:\xampp\htdocs\ - WampServer:
C:\wamp64\www\ - 宝塔面板:
/www/wwwroot/(然后在该站点下上传或直接将文件夹拖入)
- XAMPP:
-
启动安装向导
- 在浏览器中访问你放置 DedeCMS 的网址,如果你把文件夹放在
htdocs下并命名为dede,那么就访问http://localhost/dede/install/。 - 如果一切正常,你会看到 DedeCMS 的安装欢迎页面。
- 在浏览器中访问你放置 DedeCMS 的网址,如果你把文件夹放在
-
填写数据库信息
- 数据库服务器名:输入
localhost,这是标准配置,表示数据库就在本机。 - 数据库用户名:输入我们刚才创建的用户名
dede_user。 - 数据库密码:输入我们刚才设置的密码
your_strong_password_123。 - 数据库名:输入我们创建的数据库名
dede_test。 - 数据库前缀:保持默认的
dede_即可,如果你在同一数据库中安装多个 DedeCMS,可以修改这个前缀以区分,dede_test_。 - 网站默认首页:保持默认的
index.php。 - 管理员账号:设置你的网站后台管理员用户名,
admin。 - 管理员密码:设置一个复杂的后台管理密码。
- 确认管理员密码:再次输入密码。
- 网站名称:给你的测试网站起个名字,我的本地 DedeCMS 测试站”。
- 数据库服务器名:输入
-
开始安装
- 仔细检查所有信息无误后,点击“开始安装”按钮。
- 安装程序会连接你配置的数据库,并自动创建所需的表结构和数据,这个过程很快。
- 安装成功后,会提示你删除
install安装目录,这是非常重要的安全步骤!请务必按照提示删除该文件夹。
-
登录后台
- 删除
install文件夹后,访问你的网站首页(http://localhost/dede/),然后点击右上角的“登录”。 - 输入你刚才设置的管理员账号和密码,即可进入 DedeCMS 的后台管理系统。
- 删除
常见问题排查
-
错误:
#2002 - 服务器没有响应或Access denied for user 'root'@'localhost'- 原因:数据库服务未启动,或者用户名/密码错误。
- 解决:
- 确保你的 XAMPP/WampServer 控制面板中的 MySQL 服务是“启动”状态。
- 如果使用
root用户登录 phpMyAdmin 失败,请确认你设置的密码是否正确,本地环境默认密码可能为空。 - 检查你在安装向导中填写的数据库用户名和密码是否与在 phpMyAdmin 中创建的一致。
-
错误:
#1044 - Access denied for user '...'@'localhost' to database '...'- 原因:你创建的数据库用户没有对你指定的数据库有操作权限。
- 解决:返回 phpMyAdmin 的“权限”页面,检查
dede_user对dede_test数据库的权限是否已正确授予。
-
安装后页面空白或乱码
- 原因:
- 数据库连接信息错误。
- 数据库编码问题(虽然我们使用了
utf8mb4_general_ci,但有时也可能出错)。 - PHP 版本不兼容(DedeCMS 对 PHP 版本有要求,过高或过低都可能出问题,建议使用 PHP 7.x)。
- 解决:检查
/data/common.inc.php文件中的数据库配置信息是否正确,如果确认无误,可以尝试重新安装一个全新的数据库。
- 原因:
通过以上步骤,你就成功地在本地搭建了一个完整的 DedeCMS 测试环境,可以安心地进行网站模板修改、功能插件开发和内容测试了。
