教程概览

  1. 准备工作:下载所需软件。
  2. 安装 PHPStudy:一键搭建本地服务器环境。
  3. 下载并解压 DedeCMS:获取网站程序文件。
  4. 创建数据库:为网站准备数据存储空间。
  5. 运行安装向导:通过浏览器完成网站配置。
  6. 安装后配置:修改网站信息、删除安装文件等。
  7. 常见问题与解决:遇到问题怎么办。

第一步:准备工作

在开始之前,请确保你已经下载了以下两个核心软件:

dede 本地搭建教程
(图片来源网络,侵删)
  1. PHPStudy (推荐使用 8.1 版本)

    • 简介:这是一个集成化的 PHP 环境套件,它集成了 Apache/Nginx (Web 服务器)、MySQL (数据库) 和 PHP (编程语言),你无需手动配置这些复杂的软件,一键即可启动。
    • 下载地址https://www.xp.cn
    • 注意:请根据你的电脑系统(32位或64位)下载对应的版本,对于绝大多数用户,下载 64位 版本即可。
  2. DedeCMS 程序文件

    • 简介:这是 DedeCMS 的核心程序代码。
    • 推荐版本DedeCMS 5.7 UTF8 SP2 正式版,这是一个非常成熟、稳定且拥有大量模板和插件的版本,非常适合新手学习和使用。
    • 下载地址DedeCMS 官方下载页,找到 "5.7 UTF8 SP2" 版本下载。

下载完成后,你会得到两个文件:

  • phpstudy...phpstudy...exe (PHPStudy 安装包)
  • DedeCMS5.7-UTF8-SP2... (压缩文件,通常是 .zip.rar)

第二步:安装 PHPStudy

  1. 双击运行你下载的 phpstudy...exe 文件。
  2. 按照安装向导的提示进行操作,通常只需要一直点击“下一步”即可,非常简单。
  3. 安装完成后,启动 PHPStudy,你会看到一个简洁的控制面板界面。
  4. 重要:确保在控制面板中,网站服务 (Apache 或 Nginx) 和 数据库服务 (MySQL) 的状态是“运行中”,如果不是,点击“启动”按钮。

第三步:下载并解压 DedeCMS

  1. 找到你下载的 DedeCMS 压缩包(DedeCMS5.7-UTF8-SP2.zip)。
  2. 右键点击它,选择“全部解压缩...”。
  3. 解压到一个不含中文字符的路径下,D:\phpstudy_pro\WWWC:\www强烈建议不要解压到桌面!
    • 为什么放在 WWW 目录下?:PHPStudy 默认会将 WWW 目录作为网站的根目录,所有放在这个文件夹里的网站程序,都可以通过浏览器访问。

第四步:创建数据库

网站程序需要数据库来存储文章、分类、用户等信息。

dede 本地搭建教程
(图片来源网络,侵删)
  1. 在 PHPStudy 控制面板中,找到并点击 “数据库管理” -> “MySQL管理工具” -> “phpMyAdmin”,这会自动在你的默认浏览器中打开 phpMyAdmin 页面。
  2. 在 phpMyAdmin 页面顶部,点击 “新建”
  3. 数据库名:输入一个你想要的数据库名称,dedecms57
  4. 排序规则非常重要! 必须选择 utf8_general_ciutf8mb4_general_ci,这保证了你的网站可以正常存储中文内容。
  5. 点击右下角的 “创建” 按钮。
  6. 数据库创建成功后,你可以返回 PHPStudy 控制面板,重启一下 MySQL 服务,以确保新创建的数据库被正确加载。

第五步:运行安装向导

所有准备工作都已完成,可以正式安装 DedeCMS 了。

  1. 打开你的浏览器(推荐使用 Chrome 或 Firefox)。

  2. 在地址栏输入以下地址并回车:

    http://localhost/你的文件夹名/
    • 示例:如果你把 DedeCMS 解压到了 D:\phpstudy_pro\WWW\dedecms57,那么你就输入 http://localhost/dedecms57/
    • 注意:如果你的文件直接解压在了 WWW 根目录下,没有新建文件夹,那么直接访问 http://localhost/ 即可。
  3. 你会看到 DedeCMS 的欢迎页面,点击 “我已经阅读并同意此协议”,然后点击 “继续”

    dede 本地搭建教程
    (图片来源网络,侵删)
  4. 进入 “环境检测” 页面,这一步会检查你的服务器环境是否符合要求,如果看到红色叉号(❌),通常是 PHPStudy 没有运行或者版本不兼容,请确保 PHPStudy 的服务都已启动,如果都正常,应该全是绿色对勾(✅)。

  5. 进入 “安装参数设置” 页面,这是最关键的一步:

    • 网站安装目录:保持默认即可,通常是 。
    • 网站默认首页:保持默认 index.php
    • 网站名称:填写你的网站标题,我的本地测试站”。
    • 网站首页meta描述:网站的简短描述,可以不填。
    • 网站首页meta关键词:网站的关键词,可以不填。
    • 管理员账号:填写你的后台登录用户名,admin
    • 管理员密码:设置一个安全的密码,一定要记住!
    • 确认管理员密码:再次输入密码。
    • 网站版权信息:填写你的版权信息,Copyright © 2025 My Company
    • 数据库服务器:保持默认 localhost
    • 数据库用户名:默认是 root
    • 数据库密码非常重要! 这是你在安装 PHPStudy 时设置的 MySQL 密码,如果你是第一次使用,并且没有修改过,密码很可能是 rootp@ssw0rdphpstudy 或者为空,请尝试这些常见密码,如果你忘记了,可以回到 PHPStudy 控制面板,点击 “修改 MySQL 密码” 来重置。
    • 数据库名称:选择我们第四步创建的数据库名,dedecms57
    • 数据库前缀:保持默认 dede_ 即可。
    • 网站模板目录:保持默认 default
    • 是否开启会员功能:根据需要选择,新手建议开启。
  6. 所有信息填写完毕后,点击 “开始安装”,程序会自动为你创建数据表并写入初始数据。

  7. 安装成功后,你会看到“安装成功”的提示。请务必记下后台管理地址,通常是 http://localhost/dedecms57/dede/


第六步:安装后配置

  1. 删除安装目录:为了网站安全,安装成功后必须删除安装目录,回到你的文件管理器,进入 DedeCMS 的安装文件夹(D:\phpstudy_pro\WWW\dedecms57),找到名为 install 的文件夹,将其彻底删除

  2. 修改网站目录权限

    • 进入 D:\phpstudy_pro\WWW\dedecms57\data 目录。
    • config.cache.inc.php 文件的只读属性去掉(在 Windows 中右键文件 -> 属性 -> 去掉“只读”勾选)。
    • 重要:在 D:\phpstudy_pro\WWW\dedecms57 目录下,找到 plusa 目录,将它们里面的所有文件和文件夹的写入权限开启,在 PHPStudy 中,可以右键点击这些目录,选择“权限设置”,然后给 Everyone 或 Users 用户添加“完全控制”权限,这是为了使 DedeCMS 的部分功能(如上传、生成栏目等)能够正常工作。
  3. 登录后台管理

    • 在浏览器中访问你记下的后台地址,http://localhost/dedecms57/dede/
    • 使用你设置的管理员账号和密码登录。
    • 登录后,你就可以开始发布文章、创建栏目、修改网站信息等操作了。

第七步:常见问题与解决

  • 问题1:安装时提示“无法连接数据库服务器”或“数据库用户名/密码错误”。

    • 原因:数据库信息填写错误。
    • 解决:返回安装步骤,检查数据库名、用户名、密码是否正确,特别是密码,确认一下 PHPStudy 中 MySQL 的密码设置。
  • 问题2:安装后前台或后台出现“无法打开指定目录”或“文件写入失败”的警告。

    • 原因:目录权限不足。
    • 解决:严格按照第六步的说明,给 plusa 目录及其子目录赋予写入权限。
  • 问题3:访问网站首页时是乱码。

    • 原因:数据库编码或网站编码不一致。
    • 解决:检查 phpMyAdmin 中你创建的数据库排序规则是否为 utf8_general_ci,确保你下载的 DedeCMS 版本是 UTF8 版本。
  • 问题4:如何本地网站部署到服务器?

    • 流程
      1. 在服务器上同样搭建 LAMP/LNMP 环境。
      2. 在服务器数据库中创建一个新的数据库。
      3. 将你本地 D:\phpstudy_pro\WWW\dedecms57\uploads 目录下的所有文件通过 FTP 上传到服务器的网站目录。
      4. 将本地数据库通过 phpMyAdmin 的 “导出” 功能导出为 .sql 文件。
      5. 在服务器上通过 phpMyAdmin 导入这个 .sql 文件。
      6. 修改服务器上网站根目录下的 /data/common.inc.php 文件,将里面的数据库连接信息(数据库名、用户名、密码)修改为服务器的信息。

恭喜你!现在你已经成功在本地搭建好了 DedeCMS,可以开始自由地探索和学习这个强大的 CMS 系统了。