DedeCMS 安装教程 (目录模式 / Dir Mode)

DedeCMS(织梦内容管理系统)是一款非常流行的 PHP 开源网站管理系统,安装过程相对简单,但有一些关键步骤需要注意。

dede安装教程dir
(图片来源网络,侵删)

安装前准备

在开始安装之前,请确保您的服务器环境满足 DedeCMS 的最低要求。

环境要求:

  • PHP: 版本 >= 5.2 (推荐 7.x 或更高版本)
  • MySQL: 版本 >= 5.0 (推荐 5.6 或更高版本)
  • Web 服务器: Apache (推荐) 或 Nginx
  • PHP 扩展: 必须开启 mysqli, gd, zlib, curl, pdo_mysql 等扩展。

软件包下载:

  • 访问 DedeCMS 官网:https://www.dedecms.com/
  • 在“下载中心”找到最新稳定版的 DedeCMS,对于企业站,通常选择 “官方 GBK 版”“官方 UTF-8 版”
  • 下载格式通常是 .zip.rar 压缩包。

核心概念: 目录模式 vs. /dede/ 后台模式

dede安装教程dir
(图片来源网络,侵删)

在开始前,请理解 DedeCMS 的两种核心目录结构:

  • 目录模式 (您要的 Dir 模式):

    • 前台: 网站首页和所有内容页面都直接放在网站根目录(如 wwwrootpublic_html)下。
    • 后台: 管理后台目录被重命名为一个自定义的名字(如 admin, myadmin 等),放在根目录下。
    • 优点: 结构最简洁,URL 地址最短,对搜索引擎友好。
    • 缺点: 根目录文件较多,管理起来可能不如 /dede/ 模式直观。
  • /dede/ 后台模式:

    • 前台: 网站内容页面放在一个名为 plusa 的目录下。
    • 后台: 管理后台固定在 /dede/ 目录下。
    • 优点: 结构清晰,前台和后台文件分离。
    • 缺点: 前台 URL 会多一个目录层级,不够简洁。

本教程将重点讲解如何安装和配置 目录模式。


详细安装步骤

步骤 1: 解压并上传文件

  1. 解压下载的 DedeCMS 压缩包,你会得到一个名为 dedecms 或类似名称的文件夹。
  2. 打开这个文件夹,你会看到 adatadedeinclude 等目录和 index.php 等文件。
  3. 通过 FTP 工具(如 FileZilla)或服务器的文件管理器,将 dedecms 文件夹内的所有文件和文件夹上传到您的网站根目录。
    • 对于虚拟主机: 根目录通常是 public_htmlwwwroot
    • 对于本地服务器 (如 XAMPP/WampServer): 根目录通常是 htdocs
    • 注意: 是上传 dedecms 文件夹里的内容,而不是上传 dedecms 这个文件夹本身。

步骤 2: 设置目录权限 (非常重要!)

这是安装过程中最容易出错的一步,DedeCMS 需要对某些目录进行写入操作,以生成配置文件和缓存。

  • 必须设置可写权限的目录:

    • /data/ (存放配置文件和缓存)
    • /data/safe/ (安全目录)
    • /a/ (前台内容目录,对应 目录模式)
    • /uploads/ (附件上传目录)
    • /templets/ (模板目录)
    • /html/ (静态化文件目录)
  • 如何设置权限?

    • Linux 服务器 (通过 FTP):
      • 右键点击上述每个目录,选择 "文件权限" (File Permissions)。
      • "所有者" 的权限设置为 "读、写、执行" (数值为 7)。
      • "组""其他用户" 的权限设置为 "读、执行" (数值为 5)。
      • 一个常见的设置是 755,对于 /data/ 目录,有时需要设置为 777 才能安装成功,安装成功后务必改回 755
    • Windows 服务器:
      • 右键点击目录 -> "属性" -> "安全" 选项卡。
      • 确保网站运行的用户(如 IIS_IUSRSNETWORK SERVICE)有“修改”或“完全控制”权限。
    • 宝塔面板:

      在文件管理器中,找到对应目录,点击“权限”,勾选“读取”、“写入”即可。

步骤 3: 运行安装向导

  1. 在浏览器中,通过您的域名访问网站。http://www.yourdomain.com
  2. 如果权限设置正确,系统会自动检测环境,并跳转到 DedeCMS 的安装页面,如果直接显示了网站首页,请尝试访问 http://www.yourdomain.com/install/index.php
  3. 您会看到欢迎界面,点击 "我同意",进入下一步。

步骤 4: 环境检测

系统会自动检测您的 PHP、MySQL 等环境,如果所有项目都显示为 或 “正常”,则表示环境符合要求,如果出现 或 “失败”,请根据提示进行修复(通常是缺少 PHP 扩展或目录权限问题),然后刷新页面。

步骤 5: 数据库配置

这是安装的核心步骤,请务必准确填写。

  • 数据库服务器: 通常是 localhost
  • 数据库用户名: 您的数据库用户名(如 root)。
  • 数据库密码: 您的数据库密码。
  • 数据库名: 如果数据库不存在,安装程序会自动为您创建一个,您可以填写一个自定义的数据库名称。
  • 数据库前缀: 为了防止与其他程序冲突,建议修改默认的 dede_ 为一个自定义的前缀,myweb_
  • 管理目录名: 这是实现 目录模式的关键!
    • 默认值是 dede
    • 为了安全,请务必修改成一个别人不容易猜到的名字admin, myadmin, manage123 等。这个名称将作为您后台登录的路径。
    • 您在这里填写 myadmin,那么您的后台登录地址就是 http://www.yourdomain.com/myadmin/

步骤 6: 网站信息设置

  • 网站名称: 您的网站标题。
  • 网站首页标题: SEO 用的标题。
  • 网站关键字: SEO 关键词,用英文逗号隔开。
  • 网站描述: SEO 描述。
  • 管理员账号: 您的后台登录用户名,默认是 admin,为了安全,建议修改。
  • 管理员密码: 设置一个强密码。
  • 网站版权信息: 底部的版权信息。

填写完毕后,点击 “开始安装”

步骤 7: 完成安装

程序会自动执行 SQL 语句,创建数据表并写入初始数据,这个过程很快,完成后,会显示“安装成功”的提示。

步骤 8: 清理安装文件 (安全步骤)

  1. 通过 FTP 或文件管理器,删除 /install/ 目录,这个目录在安装完成后不再需要,留在服务器上有安全隐患。
  2. /data/ 目录下的 install.lock.lock 文件重命名为 install.lock,这个文件用于锁定安装程序,防止被恶意重装。

后台登录与前台访问

  • 访问后台: 在浏览器地址栏输入:http://www.yourdomain.com/您在第6步设置的管理目录名/

    • http://www.yourdomain.com/myadmin/
    • 使用您在第6步设置的管理员账号和密码登录。
  • 访问前台: 直接在浏览器地址栏输入您的域名:http://www.yourdomain.com/ 您会看到 DedeCMS 的默认模板首页。


常见问题与解决方法

  1. 问题: 目录/data/ 不存在或没有写入权限! 解决: 请返回 步骤 2,仔细检查并确保 /data/ 目录及其子目录有正确的写入权限(Linux 下 755777,Windows 下给用户组添加修改权限)。

  2. 问题: PHP 版本过低,请使用 5.2 以上的版本! 解决: 联系您的空间商,升级 PHP 版本,或者在本地环境(如 XAMPP)中切换到更高版本的 PHP。

  3. 问题: 数据库连接失败,请检查配置。 解决: 仔细检查 步骤 5 中的数据库信息是否填写正确,特别是数据库名、用户名和密码。

  4. 问题: 安装完成后,前台页面空白或乱码。 解决:

    • 乱码: 检查您下载的是 GBK 版本还是 UTF-8 版本,并确保数据库和网页编码一致。
    • 空白: 检查 include 目录下的文件是否完整上传,以及 /data/ 目录下的 common.inc.php 文件是否生成成功。
  5. 问题: 无法进入后台,提示“无法登录”或“验证码错误”。 解决:

    • 确认后台地址是否正确(您自定义的管理目录名)。
    • 清除浏览器缓存和 Cookie,然后重试。
    • 检查 data 目录的权限,确保 session 文件能被正常写入。
    • 如果是本地环境,可能是 php.ini 中的 session.save_path 配置有问题。

至此,您的 DedeCMS 目录模式的网站已经成功安装并可以运行了!接下来您就可以开始进行模板修改、内容发布等后续操作了。