DedeCMS 安装详细教程 (V5.7 SP2)
本教程将以在本地环境(Windows + Apache + PHP + MySQL)安装为例,但同样适用于任何标准的虚拟主机或云服务器环境。

(图片来源网络,侵删)
第一步:准备工作
在开始安装之前,请确保你已经准备好以下环境和软件:
环境要求
DedeCMS 对服务器环境的要求不高,主流的 Web 服务器环境基本都能支持:
- PHP 版本:
6到4之间。(强烈推荐 PHP 7.2 或 7.3,因为这是最稳定兼容的版本) - MySQL 版本:
0到7之间。 - Web 服务器: Apache (推荐,
.htaccess规则支持最好) 或 Nginx 或 IIS。
软件准备
-
DedeCMS 安装包:
- 官方下载地址:
http://www.dedecms.com/ - 进入官网后,找到“产品中心” -> “内容管理系统”,下载 DedeCMS V5.7 SP2 正式版 UTF8 版。
- 为什么推荐 UTF8 版? UTF8 是国际通用的编码格式,可以完美支持中英文、emoji 等字符,避免乱码问题,新手请务必选择 UTF8 版本。
- 官方下载地址:
-
本地环境集成包(如果你想在本地电脑上测试):
(图片来源网络,侵删)- phpStudy (Windows推荐): 集成了 Apache, PHP, MySQL, phpMyAdmin,一键安装,非常方便,下载地址:
https://www.xp.cn/ - WampServer (Windows): 也是一款非常流行的集成环境。
- MAMP (Mac): Mac 用户的首选集成环境。
- phpStudy (Windows推荐): 集成了 Apache, PHP, MySQL, phpMyAdmin,一键安装,非常方便,下载地址:
第二步:上传安装包
本地环境安装 (以 phpStudy 为例)
- 启动环境: 安装并打开 phpStudy,点击“启动”按钮,确保 Apache 和 MySQL 服务都已运行。
- 选择版本: 在 phpStudy 的“切换版本”菜单中,选择一个兼容的 PHP 版本,
PHP7.2或PHP7.3。 - 上传文件:
- 打开 phpStudy 的“网站” -> “管理” -> “打开根目录”,这将打开你的 Web 服务器根目录(通常是
WWW或www文件夹)。 - 将你下载好的
dedecms压缩包(dedecms-V57-UTF8-SP2.zip)解压。 - 将解压后的文件夹内的所有文件和文件夹,复制并粘贴到
WWW目录中。 - 为了方便访问,你可以将
WWW目录下的dedecms文件夹重命名为你喜欢的网站名称,myblog。
- 打开 phpStudy 的“网站” -> “管理” -> “打开根目录”,这将打开你的 Web 服务器根目录(通常是
虚拟主机/云服务器安装
- 通过 FTP 上传:
- 使用 FTP 工具(如 FileZilla、FlashFXP 等)连接到你的服务器。
- 将解压后的
dedecms文件夹内的所有文件和文件夹,上传到你的 Web 根目录(通常是public_html,www或html目录)。
- 通过文件管理器上传:
- 登录你的服务器控制台(如 cPanel、宝塔面板等)。
- 找到“文件管理器”工具,进入 Web 根目录。
- 将本地解压后的文件直接拖拽或上传到服务器上。
第三步:创建数据库
在安装 DedeCMS 之前,必须先为它创建一个空的数据库。
本地环境 (phpStudy)
- 打开 phpStudy,点击“其他菜单” -> “phpMyAdmin”。
- 在 phpMyAdmin 的首页,点击顶部的“数据库”选项卡。
- 在“新建数据库”输入框中,为你的数据库起一个名字,
dedecms_db。 - 在“排序规则”或“Collation”下拉菜单中,选择
utf8_general_ci或utf8mb4_general_ci。 - 点击“创建”按钮,一个空的数据库就准备好了。暂时不需要在里面创建任何表。
虚拟主机/云服务器
- cPanel 环境: 登录 cPanel,找到“MySQL 数据库向导”或“数据库”部分,按照提示创建数据库和数据库用户,并将用户授权给该数据库。
- 宝塔面板: 登录宝塔面板,点击左侧的“数据库”,然后点击“添加数据库”,填写数据库名、用户名、密码,并选择字符集为
utf8mb4。 - 其他控制台: 操作流程类似,核心是创建一个数据库和一个拥有该数据库所有权限的用户,并记下以下信息:
- 数据库名
- 数据库用户名
- 数据库密码
第四步:开始安装
所有准备工作都已完成,可以开始正式安装了。
-
访问安装页面:
- 打开你的浏览器,在地址栏输入你的网站地址。
- 本地环境:
http://localhost/myblog/(假设你把文件夹重命名为myblog) - 服务器环境:
http://你的域名.com/
-
进入安装向导:
(图片来源网络,侵删)- 浏览器会自动检测到你的
install目录,并跳转到安装页面,如果没跳转,你可以手动访问http://你的域名.com/install/。 - 你会看到 DedeCMS 的欢迎界面,点击“我同意”按钮。
- 浏览器会自动检测到你的
-
环境检测:
- 系统会自动检测你的 PHP 版本、MySQL 版本、文件夹权限等。
- 重点检查
data和include目录的权限,如果显示为“不可写”,你需要手动设置它们的权限为 755 或 777 (在 Linux/Unix 系统中),在本地环境 phpStudy 中,通常不会有这个问题,在服务器上,可以通过 FTP 或文件管理器右键修改属性。
-
数据库配置:
- 数据库服务器: 本地环境填
localhost,服务器环境通常也是localhost或0.0.1,具体请咨询你的主机商。 - 数据库用户名: 填写你第三步创建的数据库用户名。
- 数据库密码: 填写你设置的数据库密码。
- 数据库名: 填写你创建的数据库名。
- 数据库前缀: 默认是
dede_,如果你在同一数据库中安装多个 DedeCMS 站点,请修改为不同的前缀,如blog_、news_等,以防止数据冲突。 - 数据库编码: 选择
UTF-8。 - 点击“开始安装”按钮。
- 数据库服务器: 本地环境填
-
网站信息设置:
- 网站名称: 填写你的网站标题。
- 网站首页标题: 设置网站首页的
<title>标签,对 SEO 很重要。 - 网站关键词: 填写 3-5 个核心关键词,用英文逗号隔开。
- 网站描述: 简要描述你的网站内容,用于搜索引擎展示。
- 管理员账号: 设置你的后台登录用户名,默认是
admin,建议修改。 - 管理员密码: 设置一个强密码。
- 确认管理员密码: 再次输入密码。
- 电子邮件: 填写你的常用邮箱,用于接收系统通知和找回密码。
- 点击“开始安装”。
-
安装完成:
- 系统会自动完成数据库的创建和数据的导入,安装成功后,会显示一个“安装成功”的页面。
- 非常重要! 记录下页面提示的“后台管理入口地址”(
/dede/)和你的管理员账号密码。
第五步:安装后配置与安全设置
-
删除 install 目录:
- 为了安全,必须通过 FTP 或文件管理器删除你网站根目录下的
install文件夹,不删除的话,任何人都可以重新运行安装程序,覆盖你的网站。
- 为了安全,必须通过 FTP 或文件管理器删除你网站根目录下的
-
修改后台目录名(强烈推荐):
- 默认的后台管理目录是
/dede/,这是黑客攻击的重点目标,为了安全,最好修改成一个别人猜不到的名字。 - 通过 FTP 或文件管理器,将
dede文件夹重命名,myadmin或work。 - 之后,你访问后台的地址就变成了
http://你的域名.com/myadmin/。
- 默认的后台管理目录是
-
登录后台:
使用你刚刚设置的账号密码,通过修改后的后台地址登录你的网站管理后台。
-
修改核心设置:
- 登录后台后,进入“系统” -> “系统基本参数” -> “核心设置”。
- 网站根网址: 确保这里的 URL 是你正确的网站地址。
- 首页默认页: 通常设置为
index.html。 - CMS根目录: 确保路径正确。
-
设置伪静态:
- 为了网站的 SEO 和用户体验,需要开启伪静态。
- Apache 环境: 后台“系统” -> “系统基本参数” -> “选项设置” -> “是否使用伪静态”,选择“是”,然后确保你的网站根目录下有
.htaccess文件,并且里面包含了 DedeCMS 的伪静态规则。 - Nginx 环境: 你需要手动在 Nginx 的配置文件中添加 DedeCMS 的伪静态规则,然后重启 Nginx 服务,规则可以在官方文档或网上轻易找到。
常见问题
-
Q: 安装时提示
目录data不可写怎么办?- A: 这是最常见的问题,你需要通过 FTP 或服务器文件管理器,将
data文件夹的权限修改为755或777,安装完成后,记得改回755。
- A: 这是最常见的问题,你需要通过 FTP 或服务器文件管理器,将
-
Q: 安装后前台或后台出现乱码怎么办?
- A: 99% 的情况是因为你安装时数据库编码选择错误,或者网站文件编码不是 UTF8,请务必确认你下载的是 UTF8 版本,并且在安装时数据库编码也选择了 UTF-8。
-
Q: 后台登录失败,密码错误怎么办?
- A: 检查用户名和密码是否正确,如果忘记密码,可以通过数据库管理工具(如 phpMyAdmin)进入
dede_admin表(前缀可能不同),找到pwd字段,将其值修改为e10adc3949ba59abbe56e057f20f883e(这是123456的 MD5 值),然后尝试用密码123456登录,登录成功后再去修改密码。
- A: 检查用户名和密码是否正确,如果忘记密码,可以通过数据库管理工具(如 phpMyAdmin)进入
-
Q: 为什么后台登录地址是
/dede/,但我修改了文件夹名后还是访问不了?- A: 确保你修改的是网站根目录下的
dede文件夹,而不是dede/templets里面的文件夹,修改后,请清除浏览器缓存再试。
- A: 确保你修改的是网站根目录下的
至此,你的 DedeCMS 网站已经成功安装并可以使用了!接下来你就可以开始创建栏目、发布文章,并根据自己的需求选择和安装模板了。
