织梦cms本地安装教程

织梦CMS本地安装全教程 (Windows + phpStudy)

织梦CMS（DedeCMS）是一款非常流行的开源PHP网站管理系统，尤其适合做企业网站、资讯门户等，本地安装可以让你在不影响线上服务器的情况下，自由地进行学习和开发。

本教程将分为以下几个部分：

1. 准备工作：下载所需软件。
2. 环境配置：使用 phpStudy 创建本地运行环境。
3. 文件准备：上传并解压织梦CMS程序。
4. 数据库配置：创建数据库和用户。
5. Web安装：通过浏览器完成安装向导。
6. 后续配置：安装完成后的必要设置。

第一步：准备工作

在开始之前,请确保你的电脑已经安装了以下软件：

1. phpStudy 集成环境包

   • 作用：一键搭建 PHP + MySQL + Apache/Nginx 的运行环境，这是最简单的方式。
   • 下载地址：https://www.xp.cn/download.html
   • 建议版本：对于新手，推荐下载 phpStudy 2025 或 phpStudy 8.1 等稳定版本，它们对织梦CMS的兼容性很好。
   • 注意：请下载与你的电脑系统位数（32位或64位）匹配的版本。

2. 织梦CMS 安装包

   
   （图片来源网络，侵删）
   • 作用：这是网站的核心程序文件。
   • 下载地址：https://www.dedecms.com/
   • 下载步骤：
     • 访问官网,点击“下载中心”。
     • 选择你需要的版本,目前最新稳定版是 DedeCMS V5.7 / V5.8。
     • 下载 GBK 或 UTF-8 版本。UTF-8 是国际编码，支持多语言，推荐使用，GBK 主要用于简体中文网站。
     • 下载格式通常是 .zip 或 .rar 压缩包。

第二步：配置本地环境

1. 安装 phpStudy

   • 双击你下载的 phpStudy 安装包（phpStudy2025.exe 或 phpstudy_pro.exe）。
   • 根据提示进行安装,一路点击“下一步”即可，安装完成后，会自动启动控制面板。

2. 启动环境

   • 打开 phpStudy 控制面板。
   • 确保右侧的 “网站”和 “数据库”服务都已启动（按钮状态为绿色）。
   • 如果没有启动,点击“启动”按钮。

3. 配置数据库管理工具

   • 在 phpStudy 控制面板中，找到 “MySQL管理” -> “phpMyAdmin”。
   • 点击后会自动在浏览器中打开 phpMyAdmin 登录页面。
   • 默认登录信息通常是：
     • 服务器：localhost
     • 用户名：root
     • 密码：root
   • 登录成功后,你就可以在这里管理你的数据库了。

第三步：准备织梦CMS文件

1. 解压织梦安装包

   
   （图片来源网络，侵删）
   • 找到你下载的织梦CMS压缩包（DedeCMS-V5.7-UTF8-SP2.zip）。
   • 右键点击,选择“解压到当前文件夹”或使用你喜欢的解压软件进行解压。

2. 上传文件到网站目录

   • 在 phpStudy 控制面板中，找到 “网站” -> “管理网站”。
   • 点击“添加站点”。
   • 域名：填写 localhost。
   • 端口：默认 80。
   • 根目录：这是最关键的一步！点击右侧的“...”按钮，选择一个你方便管理的空文件夹作为网站的根目录，你可以创建一个名为 DedeCMS 的文件夹，然后选择它。
   • 数据库：选择 MySQL。
   • 其他设置：保持默认即可。
   • 点击“确定”保存。

3. 复制解压后的文件

   • 打开你刚才解压的织梦文件夹,里面会有一个名为 dede 或 uploads 等子文件夹，以及一些文件（如 index.php, install.php）。
   • 全选 这些文件和文件夹。
   • 将它们复制并粘贴到你在 phpStudy 中设置的网站根目录（DedeCMS 文件夹）中。

第四步：创建数据库

1. 打开 phpMyAdmin（在 phpStudy 控制面板中点击“MySQL管理” -> “phpMyAdmin”）。
2. 在 phpMyAdmin 主页，点击顶部的 “新建” 选项卡。
3. 数据库名：输入一个数据库名称，dedecms。
4. 排序规则：选择 utf8_general_ci（如果你的织梦包是UTF-8版本）或 gbk_chinese_ci（如果是GBK版本）。必须与你的织梦编码保持一致！
5. 点击 “创建” 按钮。
6. （可选但推荐）创建数据库用户：
   • 在 phpMyAdmin 主页，点击 “用户账户” -> “添加用户账户”。
   • 用户名：输入 dedecms_user。
   • 主机名：选择 localhost。
   • 密码：设置一个密码，123456。
   • 在“数据库”部分，选择你刚创建的数据库 dedecms，并勾选“全部权限”。
   • 点击 “执行”，这样做更安全，但为了方便，你也可以直接使用 root 用户。

第五步：Web安装向导

所有准备工作都已完成,可以开始安装了！

1. 打开安装页面

   • 在浏览器地址栏输入：http://localhost/install/
   • 然后按回车键。

2. 同意协议

   进入安装页面后,首先会显示“许可协议”，勾选“我同意此协议”，然后点击“继续”。

3. 环境检测

   • 系统会自动检测你的服务器环境（如PHP版本、MySQL、目录权限等）。
   • 如果所有项目都显示“√”或“通过”，恭喜你，环境没问题！
   • 如果出现“×”或“不通过”：
     • 目录权限问题：最常见的是 data、uploads、a 等目录没有写入权限，解决方法：在 phpStudy 的网站管理中，找到你的站点，点击“设置” -> “目录权限”，勾选需要写入权限的目录，然后点击“修改权限”。
     • PHP版本问题：确保 phpStudy 中的 PHP 版本是 6 或 x，不要用 PHP 8.x 或更高版本，可能会不兼容，可以在 phpStudy 控制面板的“切换版本”中修改。

4. 数据库配置

   • 数据库服务器：默认 localhost，无需修改。
   • 数据库用户名：如果你之前创建了新用户，就填新用户名（如 dedecms_user）；否则直接填 root。
   • 数据库密码：填写对应的密码。
   • 数据库名：填写你创建的数据库名，如 dedecms。
   • 数据库前缀：默认是 dede_，为了安全，可以修改成其他名字，mycms_，防止被批量攻击。
   • 网站默认首页：默认是 index.php，保持不变。
   • 点击“继续”。

5. 网站设置

   • 网站名称：填写你的网站名称，如“我的本地测试站”。
   • 网站首页标题：填写网站的标题，用于SEO。
   • 管理员账号：这是你登录后台的用户名，如 admin。
   • 管理员密码：设置一个安全的后台登录密码。
   • 确认密码：再次输入密码。
   • 电子邮件：填写你的邮箱，用于接收密码找回等信息。
   • 点击“继续”。

6. 安装完成

   • 系统会自动执行SQL脚本,创建数据表并写入初始数据。
   • 安装成功后,会显示一个“安装成功”的页面，并提示你删除 install 安装目录。
   • 非常重要！：请回到你的网站根目录，将 install 文件夹彻底删除，这是网站安全的第一步！

第六步：后续配置

1. 访问网站

   • 在浏览器地址栏输入 http://localhost。
   • 你应该能看到织梦CMS的默认首页了。

2. 登录后台

   • 在网站首页的右下角,点击“登录”。
   • 或者直接在浏览器地址栏输入：http://localhost/dede/
   • 使用你刚才设置的管理员账号和密码登录。

3. 修改网站信息

   • 登录后台后,建议立即进行一些基本设置。
   • 进入 “系统” -> “系统基本参数”。
   • 在这里你可以修改网站名称、公司信息、版权信息、联系方式等。

4. 设置网站栏目和内容

   • 进入 “核心” -> “栏目管理”，开始创建你的网站栏目（如“公司简介”、“产品展示”、“新闻中心”等）。
   • 创建完栏目后,进入 “核心” -> 模型管理”，可以为不同栏目选择合适的内容模型（如文章、图集、软件等）。
   • 在相应栏目下点击 “增加普通文章” 或 “增加文档”，开始发布你的第一篇内容。

常见问题 (FAQ)

• Q: 安装时提示 install/index.php 找不到或404错误？

  • A: 这通常是因为文件没有正确上传到网站根目录，请检查 install 文件夹是否在你设置的网站根目录（如 DedeCMS 文件夹）内。

• Q: 安装后前台或后台全是乱码？

  • A: 几乎可以肯定是 数据库编码 和 织梦程序编码 不一致，请确保两者都是 UTF-8 或都是 GBK，如果已经安装，需要重新导入正确编码的数据库。

• Q: 后台登录提示验证码错误？

  • A: 可能是 data 目录权限问题，导致无法生成验证码图片，请确保 data 目录有写入权限。

• Q: 想换一个域名（如 mytest.com）怎么办？

  • A: 1. 在 phpStudy 中添加一个新站点，域名为 mytest.com，指向同一个网站根目录，2. 修改电脑的 hosts 文件（路径：C:\Windows\System32\drivers\etc\hosts），在文件末尾添加一行 0.0.1 mytest.com，3. 重启 phpStudy 的 Apache 服务。

至此,你的织梦CMS已经成功在本地安装并运行起来了！你可以尽情地探索和使用了。