Dedecms 安装全攻略

Dedecms 是一款非常流行的 PHP 开源网站管理系统，尤其适合快速搭建资讯、博客、企业展示类网站，其安装过程相对简单,遵循以下步骤即可。

第一步：环境准备

在开始安装之前，您的服务器或本地环境必须满足以下要求，您可以在自己的电脑上使用集成环境（如 phpStudy、XAMPP、WampServer）进行测试,也可以直接在购买的虚拟主机或云服务器上操作。

核心环境要求：

• 操作系统: Linux, Windows, macOS 均可。
• Web 服务器:
  • Apache (推荐): 版本 2.0及以上
  • Nginx: 版本 0.8及以上 (需配合 PHP-FPM)
• 数据库:
  • MySQL: 版本 5.0及以上 (建议 5.6 或更高版本以获得更好性能和安全性)
  • MariaDB: 与 MySQL 兼容,同样支持。
• PHP:
  • 版本 6, 7.0, 7.1, 7.2, 7.3, 7.4 (建议使用 PHP 7.2 或 7.4，PHP 5.6 已非常老旧且不安全)。
  • 必须开启的 PHP 扩展：mysqli 或 pdo_mysql, gd, mbstring, curl, zip。

如何检查环境？ 如果您使用集成环境（如 phpStudy），环境通常已经配置好，您可以在浏览器中访问 http://localhost/phpinfo.php（需要在该环境网站根目录下创建一个包含 <?php phpinfo(); ?> 的文件），查看 PHP 版本和已加载的模块。

第二步：下载 Dedecms 程序

1. 访问官网： 打开 Dedecms 官方网站：https://www.dedecms.com/
2. 下载程序： 在官网首页找到“下载”或“资源”栏目，下载最新稳定版的 Dedecms 程序包。
3. 选择版本： 通常会有“GBK”和“UTF-8”两个版本。
   • GBK: 主要用于简体中文网站，编码占用空间小,但只支持简体中文。
   • UTF-8: 国际通用编码，支持全球语言（包括中文、英文、日文等）,推荐新网站使用。
4. 下载文件： 下载后您会得到一个 .zip 或 .rar 格式的压缩包。

第三步：上传并解压程序

1. 获取根目录： 确定您的网站根目录。

   
   （图片来源网络，侵删）
   • 本地环境 (phpStudy): 通常是 phpStudy/Apache/htdocs/ 或 phpStudy/WWW/。
   • 虚拟主机/云服务器: 通过 FTP 或文件管理器登录后，根目录通常是 public_html、www 或 html。

2. 上传文件：

   • 方法一 (推荐): 将下载的压缩包（DedeCMS-V57-UTF8-SP2.zip）直接上传到服务器的根目录。
   • 方法二: 在本地电脑上先将压缩包解压，然后找到解压后的文件夹（DedeCMS-V57-UTF8-SP2），将其中的所有文件和文件夹上传到服务器根目录。

   重要提示： 如果您选择方法二，请务必上传 DedeCMS-V57-UTF8-SP2 文件夹内的内容，而不是上传 DedeCMS-V57-UTF8-SP2 这个文件夹本身。

3. 设置目录权限： 这是非常关键的一步，如果权限设置不正确，安装过程会失败或网站无法正常生成文件。 您需要通过 FTP 客户端（如 FileZilla）或服务器自带的文件管理器，将以下目录的权限设置为 可写 (777 或 755)。

   • /data/ (这是存放核心配置和数据的目录，最重要！)
   • /dede/ (后台管理目录)
   • /templets/ (模板目录)
   • /uploads/ (附件上传目录)
   • /html/ (静态文件生成目录)

   如何设置权限？ 在 FileZilla 中，右键点击这些文件夹 -> “文件权限”，然后勾选“用户”、“组”、“其他”下的“读取”、“写入”、“执行”，或者直接输入数字 777，安装成功后再改回 755。

   
   （图片来源网络，侵删）

第四步：运行安装向导

1. 打开浏览器： 在浏览器地址栏中输入您的网站域名或本地地址。

   • 本地环境: http://localhost/
   • 线上网站: http://www.yourdomain.com/

2. 开始安装： 如果您正确上传了文件并设置了权限，浏览器会自动跳转到 Dedecms 的安装页面，如果没跳转，可以直接访问 http://www.yourdomain.com/install/。

3. 安装协议： 首先会显示安装许可协议，点击“我同意”。

4. 环境检测：

   • 系统会自动检测您的服务器环境（PHP、MySQL、目录权限等）。
   • 如果所有项目都显示为“通过”,则可以进行下一步。
   • 如果有项目显示“失败”，请根据提示进行修复，通常是 PHP 版本不兼容或目录权限未设置正确。

5. 安装参数配置：

   • 网站名称: 您网站的标题。
   • 网站首页: 您网站的默认首页文件名，通常是 index.html。
   • 管理员账号: 您的后台登录用户名,建议使用复杂的英文和数字组合。
   • 管理员密码: 您的后台登录密码，务必设置强密码（大小写字母+数字+符号）。
   • 安全提问: 用于找回密码,选择一个问题并填写答案。
   • 数据库服务器: 通常是 localhost。
   • 数据库用户名: 您的数据库用户名。
   • 数据库密码: 您的数据库密码。
   • 数据库名: 您为 Dedecms 创建的数据库。
   • 数据库前缀: 为了防止冲突，可以为数据表名添加一个前缀，默认 dede_ 即可。
   • 网站系统安装目录: 默认 ,表示安装在根目录。

6. 开始安装： 确认信息无误后，点击“开始安装”,系统会自动创建数据表并写入初始数据。

7. 安装完成： 安装成功后，会显示一个成功页面，并提示您删除 /install/ 安装目录，这是非常重要的安全步骤,必须执行！

第五步：访问网站与后台

1. 删除安装目录：

   • 通过 FTP 或文件管理器登录服务器，删除根目录下的 install 文件夹。

2. 访问前台网站：

   在浏览器中输入您的域名，即可看到 Dedecms 的默认首页。

3. 访问后台管理系统：

   • 在浏览器地址栏中输入：http://www.yourdomain.com/dede/
   • 使用您在安装步骤中设置的管理员账号和密码登录。

第六步：安装后的基本设置与安全加固

1. 修改后台默认路径：

   • 为了安全,强烈建议修改后台管理目录的名称。
   • 通过 FTP 将 dede 文件夹重命名为一个只有您自己知道的复杂名称（如 myadmin2025）。
   • 修改 /data/common.inc.php 文件，找到 $cfg_cmspath 和 $cfg_adminfolder 这两行,将值修改为您的新目录名。

2. 修改默认管理员密码：

   • 登录后台后，进入“系统” -> “系统用户管理”，找到默认的 admin 用户，点击“修改”，设置一个全新的、更复杂的密码。

3. 关闭注册功能：

   如果您的网站不需要用户注册，可以在后台“系统” -> “系统基本参数” -> “核心设置”中，找到“是否开启会员注册”，选择“否”。

4. 修改网站标题和关键词：

   在后台“系统” -> “系统基本参数”中，可以修改网站标题、关键词、描述等 SEO 信息。

常见问题与解决方案 (FAQ)

• Q1: 安装时提示 "目录 /data/ 不可写" 或 "目录 /dede/ 不可写"？

  • A: 这是最常见的问题，请返回第三步，通过 FTP 工具将这些目录的权限设置为 777，安装成功后再改回 755。

• Q2: 安装时数据库连接失败，提示 "数据库服务器地址不对" 或 "用户名/密码错误"？

  • A:
    1. 确认数据库名、用户名、密码是否正确。
    2. 确认数据库服务器地址是否为 localhost，如果不是（例如是 0.0.1 或一个 IP 地址）,请使用正确的地址。
    3. 确认您的数据库用户是否有当前数据库的完全权限。

• Q3: 安装时提示 "PHP 版本过低" 或 "PHP 版本不支持"？

  • A: Dedecms 旧版本可能不支持最新的 PHP 8.x，您需要降级您的 PHP 版本到 7.4 或 7.2，或者寻找支持新 PHP 版本的 Dedecms 兼容版本。

• Q4: 前台页面显示空白，或者后台登录后显示空白？

  • A: 通常是 PHP 错误被屏蔽了，可以尝试：
    1. 检查 php.ini 文件中的 display_errors 是否设置为 On。
    2. 检查 /data/ 目录下的 config.cache.inc.php 文件是否存在,或者是否被正确写入。
    3. 检查目录权限是否正确。

• Q5: 如何将网站从本地迁移到服务器？

  • A: 这是一个更复杂的过程，主要包括三步：
    1. 导出数据库： 在本地 Dedecms 后台，进入“系统” -> “数据库备份/恢复”，导出数据库为 .sql 文件。
    2. 上传文件： 将本地网站根目录下的所有文件上传到服务器。
    3. 修改配置文件： 在服务器上，找到 /data/common.inc.php 文件，用记事本打开，修改其中的数据库信息（服务器地址、用户名、密码、数据库名）为服务器上的信息。
    4. 导入数据库： 在服务器上创建一个新的数据库，然后将本地导出的 .sql 文件通过 phpMyAdmin 等工具导入到新数据库中。

希望这份详细的教程能帮助您成功安装 Dedecms！祝您建站愉快！