dede系统环境搭建如何快速配置成功？

1. 环境要求：搭建 DedeCMS 需要哪些软件和版本。
2. 本地环境搭建：推荐新手在电脑上本地搭建，方便测试和学习。
3. 服务器环境搭建：将网站部署到真正的服务器上，供用户访问。

环境要求

在开始之前,请确保你的服务器或本地计算机满足以下最低要求：

本地环境搭建 (推荐新手)

本地环境可以让你在自己的电脑上搭建一个完整的网站服务器,不影响线上环境，非常适合学习和测试，最简单的方法是使用集成环境包。

推荐工具：phpStudy (Windows) 或宝塔面板 (Linux/Windows)

这里以 phpStudy (Windows 平台) 为例，因为对新手最友好。

步骤 1：下载并安装 phpStudy

1. 访问 phpStudy 官网下载最新版：https://www.xp.cn/
2. 下载后解压并运行 phpstudy.exe。
3. 根据提示完成安装,安装后，phpStudy 会自动启动控制面板。

步骤 2：配置环境

1. 打开 phpStudy 控制面板。
2. 切换版本：在菜单栏选择 切换版本 -> 其他版本设置，这里我们选择一个兼容 DedeCMS 的版本，PHP 7.4 + MySQL 5.7 + Apache 的组合。
3. 启动服务：确保 Apache 和 MySQL 两个服务都已启动，如果没有启动，点击旁边的 启动 按钮。

步骤 3：创建网站和数据库

1. 创建网站：

   • 在 phpStudy 控制面板，点击 网站 -> 管理 -> 添加站点。
   • 域名：填写 localhost (本地访问) 或 dede.test (可以配置 hosts 文件实现，但新手直接用 localhost 即可)。
   • 根目录：选择一个你存放网站的文件夹，D:\phpStudy\WWW\dede，phpStudy 默认会在 WWW 目录下创建。
   • 点击 确定。

2. 创建数据库：

   • 点击 数据库 -> 管理 -> MySQL-Front (或者直接点击 phpMyAdmin，它通常会自动打开)。
   • 在 phpMyAdmin 中，点击 新建。
   • 数据库名：填写一个数据库名，dedecms。
   • 排序规则：选择 utf8mb4_general_ci 或 utf8mb4_unicode_ci，确保支持完整的中文和 Emoji。
   • 点击 创建。

步骤 4：下载并安装 DedeCMS

1. 下载 DedeCMS：

   • 访问 DedeCMS 官网下载最新稳定版：https://www.dedecms.com/
   • 下载后解压压缩包。

2. 上传文件：

   • 将解压后的文件（通常是 dede 文件夹内的所有内容，或者整个压缩包解压后的根目录文件）复制到你刚才在 phpStudy 中设置的网站根目录（D:\phpStudy\WWW\dede）中。注意： 不要把 dede 文件夹本身复制进去，而是要复制它里面的 index.php, install.php, include 等文件和文件夹到根目录。

3. 开始安装：

   • 在浏览器中访问你设置的网址,http://localhost/dede/。
   • 你会看到 DedeCMS 的安装向导界面，如果看不到，可能是权限问题，请确保网站根目录有写入权限（phpStudy 默认是有的）。
   • 环境检测：向导会自动检测你的 PHP、MySQL 等环境，如果显示“√”则表示通过，如果显示“×”或有红色警告，请根据提示返回 phpStudy 控制面板调整 PHP 版本或开启相应扩展（如 mysqli, gd 等）。
   • 安装协议：勾选“同意”并点击“继续”。
   • 参数配置：
     • 网站名称：填写你的网站名称。
     • 网站首页：设置网站首页的文件名，默认为 index.php。
     • 管理员账号：设置你的后台登录用户名。
     • 管理员密码：设置一个强密码。
     • 数据库配置：
       • 数据库服务器：填写 localhost。
       • 数据库用户名：填写你在 phpMyAdmin 中创建数据库时的用户名，默认是 root。
       • 数据库密码：填写 root (phpStudy 默认密码)。
       • 数据库名：填写你刚才创建的数据库名，dedecms。
       • 数据表前缀：保持默认的 dede_ 即可，可以防止与其他网站数据库冲突。
   • 点击 开始安装。
   • 安装完成后,会提示你删除 install 目录，这是非常重要的安全步骤！请立即删除网站根目录下的 install 文件夹。

步骤 5：访问网站和后台

• 前台网站：在浏览器中访问 http://localhost/，即可看到你搭建好的 DedeCMS 站点首页。
• 后台管理：在浏览器中访问 http://localhost/dede/，输入你设置的管理员账号和密码，即可登录后台进行网站内容的添加和管理。

服务器环境搭建

在服务器上搭建,通常有两种方式：手动命令行安装 或使用宝塔面板，宝塔面板和 phpStudy 原理类似，但面向服务器，更稳定，推荐使用。

使用宝塔面板 (强烈推荐)

宝塔面板可以让你通过图形化界面轻松管理服务器,安装软件、配置网站、管理数据库都非常简单。

步骤 1：安装宝塔面板

1. 根据你的服务器操作系统,访问宝塔官网选择对应的安装命令：https://www.bt.cn/new/download.html
2. 以 CentOS 7 为例，复制命令到服务器终端执行：

   yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh

3. 安装完成后,会显示面板的登录地址、用户名和初始密码，请务必保存好！

步骤 2：使用宝塔面板配置环境

1. 用浏览器登录宝塔面板。

2. 安装软件：

   • 点击左侧菜单的 软件商店。
   • 在搜索框中搜索并安装以下软件：
     • Nginx 或 Apache (二选一，推荐 Nginx)
     • PHP (选择 PHP 7.4 版本)
     • MySQL 5.7 或 MariaDB 10.5
   • 点击一键安装,等待安装完成。

3. 创建网站和数据库：

   • 创建网站：点击左侧 网站 -> 添加站点。
     • 域名：填写你的域名，www.yourdomain.com，如果是测试，可以用 IP 地址。
     • 根目录：选择一个存放网站文件的目录，/www/wwwroot/yourdomain.com。
     • PHP版本：选择刚刚安装的 PHP 7.4。
     • 点击 提交。
   • 创建数据库：点击左侧 数据库 -> 添加数据库。
     • 数据库名：dedecms_db。
     • 用户名：dedecms_user。
     • 密码：设置一个强密码。
     • 字符集：选择 utf8mb4。
     • 点击 确定。

步骤 3：上传 DedeCMS 文件并安装

1. 上传文件：

   • 使用宝塔面板的“文件”管理器，进入你刚刚创建的网站根目录（/www/wwwroot/yourdomain.com）。
   • 将下载好的 DedeCMS 压缩包上传到该目录。
   • 在文件管理器中,右键点击上传的压缩包，选择 解压缩。
   • 解压后,将解压出来的文件（文件夹内的内容）移动到根目录下，如果解压后就是 index.php 等文件在根目录，则无需移动。

2. 开始安装：

   • 在浏览器中访问你的域名,http://www.yourdomain.com/。
   • 接下来的安装步骤与本地环境完全相同：环境检测、参数配置、数据库配置等。
   • 注意：在服务器上，install 目录的权限可能需要手动设置，如果无法安装，请确保网站根目录（/www/wwwroot/yourdomain.com）及其子目录有 写入 权限，可以在宝塔文件管理器中右键目录 -> 权限，将所有者设置为 www (或运行 PHP 的用户) 并赋予 755 权限。

3. 完成安装：

   • 安装成功后,务必删除根目录下的 install 文件夹。

步骤 4：配置伪静态 (重要！)

DedeCMS 的 URL 静态化需要服务器配置伪静态规则，否则会出现 404 错误。

• 如果你使用的是 Nginx：

  1. 在宝塔面板,点击左侧 网站 -> 找到你的站点 -> 点击 设置。
  2. 选择 伪静态 标签页。
  3. 在右侧选择 DedeCMS 的规则模板，然后点击 保存。
  4. 重启 Nginx 服务。

• 如果你使用的是 Apache：

  1. DedeCMS 自带了 .htaccess 文件，你只需要确保它被上传到了网站根目录即可，宝塔面板默认会处理，无需额外配置。

步骤 5：访问网站和后台

• 前台网站：访问你的域名 http://www.yourdomain.com/。
• 后台管理：访问 http://www.yourdomain.com/dede/，登录后台。

常见问题与注意事项

1. 安装时环境检测失败：

   • PHP 版本不兼容：切换到 PHP 7.4。
   • 缺少 PHP 扩展：在 phpStudy 或宝塔面板的 软件商店 -> PHP -> 设置 -> 安装扩展 中，安装 mysqli, gd, curl, openssl 等常用扩展。
   • 目录权限问题：确保网站根目录有写入权限（755），data 目录和 cache 目录需要有写入权限（777），安装完成后记得改回 755）。

2. 后台登录后空白或乱码：

   • 检查 data 目录权限是否正确。
   • 检查 PHP 版本是否兼容。
   • 清除浏览器缓存和 Cookie。

3. 网站首页 404：

   • 几乎可以肯定是 伪静态没有配置正确，请务必按照第三步的说明，为你的 Web 服务器（Nginx 或 Apache）配置好 DedeCMS 的伪静态规则。

4. 安全性：

   • 删除 install 目录：这是最基本也是最重要的安全措施。
   • 修改默认后台目录：安装后，可以在后台的“系统” -> “系统基本参数” -> “后台目录名称”中修改后台登录地址，增加安全性。
   • 使用强密码：管理员密码和数据库密码一定要设置得复杂一些。
   • 保持更新：关注 DedeCMS 官方，及时更新到最新版本以修复安全漏洞。

通过以上步骤,你就可以成功搭建起一个稳定运行的 DedeCMS 系统环境了，祝你使用愉快！