教程概览
- 准备工作:下载所需软件。
- 安装 PHPStudy:一键搭建本地服务器环境。
- 下载并解压 DedeCMS:获取网站程序文件。
- 创建数据库:为网站准备数据存储空间。
- 运行安装向导:通过浏览器完成网站配置。
- 安装后配置:修改网站信息、删除安装文件等。
- 常见问题与解决:遇到问题怎么办。
第一步:准备工作
在开始之前,请确保你已经下载了以下两个核心软件:

(图片来源网络,侵删)
-
PHPStudy (推荐使用 8.1 版本)
- 简介:这是一个集成化的 PHP 环境套件,它集成了 Apache/Nginx (Web 服务器)、MySQL (数据库) 和 PHP (编程语言),你无需手动配置这些复杂的软件,一键即可启动。
- 下载地址:https://www.xp.cn
- 注意:请根据你的电脑系统(32位或64位)下载对应的版本,对于绝大多数用户,下载
64位版本即可。
-
DedeCMS 程序文件
- 简介:这是 DedeCMS 的核心程序代码。
- 推荐版本:DedeCMS 5.7 UTF8 SP2 正式版,这是一个非常成熟、稳定且拥有大量模板和插件的版本,非常适合新手学习和使用。
- 下载地址:DedeCMS 官方下载页,找到 "5.7 UTF8 SP2" 版本下载。
下载完成后,你会得到两个文件:
phpstudy...或phpstudy...exe(PHPStudy 安装包)DedeCMS5.7-UTF8-SP2...(压缩文件,通常是.zip或.rar)
第二步:安装 PHPStudy
- 双击运行你下载的
phpstudy...exe文件。 - 按照安装向导的提示进行操作,通常只需要一直点击“下一步”即可,非常简单。
- 安装完成后,启动 PHPStudy,你会看到一个简洁的控制面板界面。
- 重要:确保在控制面板中,网站服务 (Apache 或 Nginx) 和 数据库服务 (MySQL) 的状态是“运行中”,如果不是,点击“启动”按钮。
第三步:下载并解压 DedeCMS
- 找到你下载的 DedeCMS 压缩包(
DedeCMS5.7-UTF8-SP2.zip)。 - 右键点击它,选择“全部解压缩...”。
- 解压到一个不含中文字符的路径下,
D:\phpstudy_pro\WWW或C:\www。强烈建议不要解压到桌面!- 为什么放在
WWW目录下?:PHPStudy 默认会将WWW目录作为网站的根目录,所有放在这个文件夹里的网站程序,都可以通过浏览器访问。
- 为什么放在
第四步:创建数据库
网站程序需要数据库来存储文章、分类、用户等信息。

(图片来源网络,侵删)
- 在 PHPStudy 控制面板中,找到并点击 “数据库管理” -> “MySQL管理工具” -> “phpMyAdmin”,这会自动在你的默认浏览器中打开 phpMyAdmin 页面。
- 在 phpMyAdmin 页面顶部,点击 “新建”。
- 数据库名:输入一个你想要的数据库名称,
dedecms57。 - 排序规则:非常重要! 必须选择
utf8_general_ci或utf8mb4_general_ci,这保证了你的网站可以正常存储中文内容。 - 点击右下角的 “创建” 按钮。
- 数据库创建成功后,你可以返回 PHPStudy 控制面板,重启一下 MySQL 服务,以确保新创建的数据库被正确加载。
第五步:运行安装向导
所有准备工作都已完成,可以正式安装 DedeCMS 了。
-
打开你的浏览器(推荐使用 Chrome 或 Firefox)。
-
在地址栏输入以下地址并回车:
http://localhost/你的文件夹名/- 示例:如果你把 DedeCMS 解压到了
D:\phpstudy_pro\WWW\dedecms57,那么你就输入http://localhost/dedecms57/。 - 注意:如果你的文件直接解压在了
WWW根目录下,没有新建文件夹,那么直接访问http://localhost/即可。
- 示例:如果你把 DedeCMS 解压到了
-
你会看到 DedeCMS 的欢迎页面,点击 “我已经阅读并同意此协议”,然后点击 “继续”。
(图片来源网络,侵删) -
进入 “环境检测” 页面,这一步会检查你的服务器环境是否符合要求,如果看到红色叉号(❌),通常是 PHPStudy 没有运行或者版本不兼容,请确保 PHPStudy 的服务都已启动,如果都正常,应该全是绿色对勾(✅)。
-
进入 “安装参数设置” 页面,这是最关键的一步:
- 网站安装目录:保持默认即可,通常是 。
- 网站默认首页:保持默认
index.php。 - 网站名称:填写你的网站标题,我的本地测试站”。
- 网站首页meta描述:网站的简短描述,可以不填。
- 网站首页meta关键词:网站的关键词,可以不填。
- 管理员账号:填写你的后台登录用户名,
admin。 - 管理员密码:设置一个安全的密码,一定要记住!
- 确认管理员密码:再次输入密码。
- 网站版权信息:填写你的版权信息,
Copyright © 2025 My Company。 - 数据库服务器:保持默认
localhost。 - 数据库用户名:默认是
root。 - 数据库密码:非常重要! 这是你在安装 PHPStudy 时设置的 MySQL 密码,如果你是第一次使用,并且没有修改过,密码很可能是
root、p@ssw0rd、phpstudy或者为空,请尝试这些常见密码,如果你忘记了,可以回到 PHPStudy 控制面板,点击 “修改 MySQL 密码” 来重置。 - 数据库名称:选择我们第四步创建的数据库名,
dedecms57。 - 数据库前缀:保持默认
dede_即可。 - 网站模板目录:保持默认
default。 - 是否开启会员功能:根据需要选择,新手建议开启。
-
所有信息填写完毕后,点击 “开始安装”,程序会自动为你创建数据表并写入初始数据。
-
安装成功后,你会看到“安装成功”的提示。请务必记下后台管理地址,通常是
http://localhost/dedecms57/dede/。
第六步:安装后配置
-
删除安装目录:为了网站安全,安装成功后必须删除安装目录,回到你的文件管理器,进入 DedeCMS 的安装文件夹(
D:\phpstudy_pro\WWW\dedecms57),找到名为install的文件夹,将其彻底删除。 -
修改网站目录权限:
- 进入
D:\phpstudy_pro\WWW\dedecms57\data目录。 - 将
config.cache.inc.php文件的只读属性去掉(在 Windows 中右键文件 -> 属性 -> 去掉“只读”勾选)。 - 重要:在
D:\phpstudy_pro\WWW\dedecms57目录下,找到plus和a目录,将它们里面的所有文件和文件夹的写入权限开启,在 PHPStudy 中,可以右键点击这些目录,选择“权限设置”,然后给 Everyone 或 Users 用户添加“完全控制”权限,这是为了使 DedeCMS 的部分功能(如上传、生成栏目等)能够正常工作。
- 进入
-
登录后台管理:
- 在浏览器中访问你记下的后台地址,
http://localhost/dedecms57/dede/。 - 使用你设置的管理员账号和密码登录。
- 登录后,你就可以开始发布文章、创建栏目、修改网站信息等操作了。
- 在浏览器中访问你记下的后台地址,
第七步:常见问题与解决
-
问题1:安装时提示“无法连接数据库服务器”或“数据库用户名/密码错误”。
- 原因:数据库信息填写错误。
- 解决:返回安装步骤,检查数据库名、用户名、密码是否正确,特别是密码,确认一下 PHPStudy 中 MySQL 的密码设置。
-
问题2:安装后前台或后台出现“无法打开指定目录”或“文件写入失败”的警告。
- 原因:目录权限不足。
- 解决:严格按照第六步的说明,给
plus和a目录及其子目录赋予写入权限。
-
问题3:访问网站首页时是乱码。
- 原因:数据库编码或网站编码不一致。
- 解决:检查 phpMyAdmin 中你创建的数据库排序规则是否为
utf8_general_ci,确保你下载的 DedeCMS 版本是UTF8版本。
-
问题4:如何本地网站部署到服务器?
- 流程:
- 在服务器上同样搭建 LAMP/LNMP 环境。
- 在服务器数据库中创建一个新的数据库。
- 将你本地
D:\phpstudy_pro\WWW\dedecms57\uploads目录下的所有文件通过 FTP 上传到服务器的网站目录。 - 将本地数据库通过 phpMyAdmin 的 “导出” 功能导出为
.sql文件。 - 在服务器上通过 phpMyAdmin 导入这个
.sql文件。 - 修改服务器上网站根目录下的
/data/common.inc.php文件,将里面的数据库连接信息(数据库名、用户名、密码)修改为服务器的信息。
- 流程:
恭喜你!现在你已经成功在本地搭建好了 DedeCMS,可以开始自由地探索和学习这个强大的 CMS 系统了。
