整个安装过程的核心,就是让安装程序通过您在 Web 浏览器中填写的信息,来生成这个最终的配置文件。

(图片来源网络,侵删)
下面我为您详细梳理一下织梦安装的全过程,并重点解释配置文件的作用和生成方式。
织梦安装流程详解
织梦的安装过程非常简单,遵循以下几步即可:
第一步:上传文件
- 下载织梦程序:从织梦官方社区(https://www.dedecms.com/)下载最新版本的程序包(
DedeCMS-V5.7.111-GBK+SP1.zip)。 - 解压文件:将下载的 ZIP 压缩包解压。
- 上传到服务器:
- 使用 FTP 工具(如 FileZilla)或服务器的文件管理器。
- 将解压后的文件夹内的所有文件和文件夹,上传到您的网站根目录。
- 重要:通常是
public_html、wwwroot或htdocs目录,确保上传的是解压后的内容,而不是包含解压后文件的文件夹本身。
第二步:运行安装程序
-
访问安装地址:在浏览器中输入您的网站域名,后面加上
/install/。http://www.yourdomain.com/install/- 如果您的网站根目录就是域名,直接访问
http://www.yourdomain.com/,安装程序通常会自动检测并跳转。
-
进入安装向导:您会看到织梦的安装欢迎界面,点击“我同意”进入下一步。
(图片来源网络,侵删)
第三步:环境检测(关键步骤)
安装程序会自动检测您的服务器环境是否满足织梦的运行要求,您需要确保所有项目都是 “√” (通过) 或 “推荐”。
- PHP 版本:通常要求
PHP 5.6或更高版本,过低或过高版本可能会有兼容性问题。 - MySQL 版本:通常要求
MySQL 5.0或更高版本。 . PHP GD 库:用于处理图片,必须开启。 . Safe Mode:必须为 OFF。 . Session:必须开启。 . Zlib Support:用于数据压缩,建议开启。 *. 文件上传:需要开启。
如果检测不通过,您需要联系您的服务器空间商,让他们帮您修改 PHP 配置(通常是修改 php.ini 文件),如果无法修改,可能需要更换支持织梦运行的主机。
第四步:安装配置(填写数据库信息)
这是最核心的一步,您在这里填写的信息将用于生成 data/common.inc.php 文件。
| 配置项 | 说明 | 示例 |
|---|---|---|
| 网站名称 | 您网站的正式名称。 | "我的个人博客" |
| 网站首页默认文件名 | 一般保持默认 index.html 即可。 |
index.html |
| 管理员账号 | 您登录网站后台的用户名,建议使用英文或数字。 | admin |
| 管理员密码 | 您登录后台的密码,一定要设置复杂,包含大小写字母、数字和符号。 | Admin@2025 |
| 确认密码 | 再次输入一遍密码。 | Admin@2025 |
| 数据库服务器 | 数据库地址,99% 的情况下是 localhost。 |
localhost |
| 数据库用户名 | 您的数据库用户名,由空间商提供。 | yourdb_user |
| 数据库密码 | 您的数据库密码,由空间商提供。 | yourdb_password |
| 数据库名称 | 您要用来存放织梦数据的数据库名,由空间商提供。 | yourdb_name |
| 数据库前缀 | 用于避免与其他网站的数据库表冲突,可以保持默认 dede_,也可以自定义,如 my_。 |
dede_ |
| 网站安装目录 | 如果您的网站不是放在根目录,需要在这里填写相对路径,一般放在根目录,此项留空即可。 | (留空) |
填写完成后,点击“开始安装”。

(图片来源网络,侵删)
第五步:安装完成
- 生成配置文件:安装程序会根据您填写的信息,连接数据库,创建数据表,并最重要的——在
/data/目录下生成common.inc.php文件。 - 删除安装目录:为了网站安全,安装成功后,务必通过 FTP 或文件管理器删除
/install/这个整个目录,如果不删除,任何人都可以重新运行您的安装程序,覆盖您的网站和数据库。 - 访问网站:您可以直接访问您的域名,应该就能看到织梦的默认首页了。
data/common.inc.php 配置文件的详细说明
这个文件是织梦系统的核心配置文件,包含了连接数据库和网站的基本设置。它的权限非常重要,安装完成后建议设置为 644(即所有者可读写,组用户和其他用户只读),以增强安全性。 示例及解释:**
<?php //数据库连接信息 $cfg_dbhost = 'localhost'; // 数据库主机 $cfg_dbname = 'yourdb_name'; // 数据库名 $cfg_dbuser = 'yourdb_user'; // 数据库用户名 $cfg_dbpwd = 'yourdb_password'; // 数据库密码 $cfg_dbprefix = 'dede_'; // 数据库表前缀 $cfg_db_language = 'gbk'; // 数据库语言版本,默认为gbk //网站路径信息 $cfg_cmspath = '/'; // 网站在服务器上的绝对路径,根目录为'/' $cfg_mainsite = 'http://www.yourdomain.com'; // 网站的主域名 //后台路径信息 $cfg_adminfolder = 'dede'; // 后台管理目录名称 // ... 其他配置 ...
重要提示:
- 不要手动编辑此文件:除非您非常清楚自己在做什么,否则不要轻易修改这个文件的内容,错误的配置会导致网站无法访问或数据库连接失败。
- 忘记后台密码怎么办:如果您忘记了织梦后台的管理员密码,可以通过一个专门的“找回密码”程序来解决,而不是手动修改这个文件,通常在
/dede/目录下会有一个resetpassword.php文件,按照提示操作即可。
常见问题排查
-
安装时提示
目录data不存在或不可写- 原因:Web 服务器(如 Apache、Nginx)对
/data/目录没有写入权限。 - 解决:通过 FTP 或文件管理器,将
/data/目录的权限设置为 777。注意: 这只是安装时的临时措施,安装完成后请务必改回 644(对文件)和 755(对目录)。
- 原因:Web 服务器(如 Apache、Nginx)对
-
安装时提示
数据库连接失败,请检查配置- 原因:您填写的数据库信息(主机、用户名、密码、数据库名)有误。
- 解决:仔细检查您从空间商那里获取的数据库信息,确保每一个字符都正确,特别是主机名,不一定是
localhost,有时是MySQL.yourhost.com这样的形式。
-
安装完成后,首页空白或显示错误
- 原因1:
/data/目录权限不正确。 - 解决:将
/data/目录权限设置为 755,其下的文件权限设置为 644。 - 原因2:
/data/common.inc.php文件权限不正确。 - 解决:确保该文件权限为 644。
- 原因3:PHP 版本不兼容。
- 解决:联系空间商,将 PHP 版本调整到织梦推荐的版本。
- 原因1:
安装织梦不需要您手动创建配置文件,它的核心工作就是填写数据库信息,然后由安装程序自动生成 data/common.inc.php,记住安装流程中的关键点:上传文件 -> 运行 /install/ -> 环境检测 -> 填写数据库信息 -> 删除 /install/ 目录,整个过程非常直观,按照向导操作即可。
