重要提醒:安装前必读
- DedeCMS 已停止更新:DedeCMS 的官方团队已经停止了所有更新和维护,这意味着它可能存在未发现的安全漏洞,不建议用于新项目,尤其是商业项目,如果你只是个人学习、搭建一个不重要的博客或信息网站,可以继续,否则,强烈建议考虑更现代、更安全的 CMS,如 WordPress、Typecho、Hal 等等。
- 服务器环境:DedeCMS 是基于 PHP + MySQL 的,你需要确保你的服务器或本地环境已经正确安装并配置了:
- PHP:推荐版本
3到2之间,新版本可能不兼容。 - MySQL:版本
0或更高。 - Web 服务器:Apache 或 Nginx 都可以,但 Apache 的
.htaccess规则支持更好。 - FTP/SFTP 客户端:用于上传文件到服务器(如 FileZilla)。
- 数据库管理工具:用于创建数据库(如 phpMyAdmin)。
- PHP:推荐版本
安装步骤详解
第一步:准备工作
-
下载 DedeCMS 源码
- 访问 DedeCMS 的官方网站或其源码托管地址(如 Gitee)下载最新稳定版的源码包。
- 官方网站:
http://www.dedecms.com/ - Gitee 地址:
https://gitee.com/destine/dedecms(请自行搜索最新的可用仓库) - 下载的文件通常是一个压缩包,
dedecms-v5.7-UTF8-B20250227.zip。
-
准备服务器环境
- 本地环境:如果你想在本地电脑上测试,可以使用集成环境,如
phpStudy、XAMPP、WAMP等,安装这些软件后,启动 Apache 和 MySQL 服务即可。 - 虚拟主机/云服务器:确保你的服务商已经支持 PHP 和 MySQL,并已为你开通。
- 本地环境:如果你想在本地电脑上测试,可以使用集成环境,如
-
创建数据库
- 登录你的数据库管理工具,最常见的是
phpMyAdmin。 - 在 phpMyAdmin 的主界面,点击“新建”。
- 输入一个数据库名称(
dedecms_db)。 - 选择“排序规则”(Collation),对于中文网站,推荐选择
utf8_general_ci或utf8mb4_general_ci。 - 点击“创建”按钮,数据库就创建好了。
- 登录你的数据库管理工具,最常见的是
-
创建数据库用户并授权
- 在 phpMyAdmin 的顶部菜单栏,点击“权限”。
- 点击“添加用户账户”。
- 用户名:输入一个用户名(
dedecms_user)。 - 主机名:选择
localhost。 - 密码:设置一个强密码。
- 在“数据库-specific 权限”部分,在下拉菜单中选择你刚刚创建的数据库(
dedecms_db)。 - 勾选“全局”和“数据库”下的所有权限(或至少勾选
SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,INDEX,ALTER)。 - 点击“执行”按钮,这个用户就可以完全访问你创建的数据库了。
第二步:上传源码
-
解压下载的源码包
- 将下载的
.zip文件解压到你的电脑上。
- 将下载的
-
连接服务器
- 使用 FTP 客户端(如 FileZilla)连接到你的服务器。
- 找到网站的根目录,这个目录通常是:
- 本地环境:
phpStudy的WWW文件夹,或XAMPP的htdocs文件夹。 - 虚拟主机:通常是
public_html、www或html文件夹。 - 云服务器:
/var/www/html(根据你的服务器配置可能不同)。
- 本地环境:
-
上传文件
- 将解压后的文件夹(
dedecms)中的所有文件和文件夹,不是上传dedecms这个文件夹本身,而是上传它里面的内容,全部拖拽到服务器的根目录中。 - 上传完成后,你应该能在服务器根目录下看到
data、include、templets、uploads等文件夹和index.php、install等文件。
- 将解压后的文件夹(
第三步:运行安装程序
-
访问安装地址
- 打开你的浏览器,输入你的网站域名或本地地址。
- 在地址后面加上
/install,然后按回车。 - 本地地址:
http://localhost/install - 网站域名:
http://www.yourdomain.com/install
- 本地地址:
- 如果一切正常,你应该会看到 DedeCMS 的安装向导欢迎页面。
-
环境检测
- 安装程序会自动检测你的服务器环境,包括 PHP 版本、MySQL 扩展、文件夹权限等。
- 如果出现红色叉号:表示检测失败,需要根据提示进行修复,最常见的问题是
data和include文件夹没有写入权限。 - 如何修复权限:
- 本地环境:在 phpStudy 的环境管理中,找到“站点管理”或“虚拟主机设置”,确保网站目录有读写权限。
- 服务器:通过 FTP 客户件右键点击
data和include文件夹,选择“文件权限”,将其数值修改为777。安装完成后务必改回755,这是安全措施。
- 所有检测项目都显示绿色对勾后,点击“同意协议,继续安装”。
-
填写数据库信息
- 数据库主机:通常是
localhost。 - 数据库用户名:填写你在第一步中创建的数据库用户名(
dedecms_user)。 - 数据库密码:填写你为该用户设置的密码。
- 数据库名:填写你创建的数据库名(
dedecms_db)。 - 数据库表前缀:默认是
dede_,如果你在同一数据库中安装多个 DedeCMS,可以修改这个前缀以避免冲突,通常保持默认即可。 - 网站默认管理员帐号:默认是
admin。 - 网站默认管理员密码:设置一个你自己的管理员密码。
- 网站安全设置:可以勾选“开启注册”,以及设置“网站名称”、“网站路径”等。
- 填写完毕后,点击“开始安装”。
- 数据库主机:通常是
-
安装完成
- 程序会开始执行 SQL 语句,创建数据表并写入初始数据,这个过程很快。
- 安装成功后,会显示一个成功页面,并提示你删除
/install目录。
第四步:安装后配置
-
删除安装目录
- 这是非常重要的一步!通过 FTP 或文件管理器,将服务器上的
/install文件夹彻底删除,这可以防止他人通过这个目录重新安装你的网站,造成安全隐患。
- 这是非常重要的一步!通过 FTP 或文件管理器,将服务器上的
-
登录后台
- 在浏览器地址栏输入你的网站域名,后面加上
/dede。 http://www.yourdomain.com/dede- 使用你刚才设置的管理员账号(
admin)和密码登录。
- 在浏览器地址栏输入你的网站域名,后面加上
-
修改默认密码
- 首次登录后,第一件事就是修改默认的管理员密码!
- 进入后台后,点击“系统” -> “系统用户管理”,找到
admin用户,点击“编辑”来修改密码。
-
修改网站信息
- 在后台,你可以修改网站的标题、副标题、关键词、描述等。
- 通常在“系统” -> “系统基本参数”中设置。
常见问题与解决方案
-
问题1:安装时提示
Could not connect to MySQL database(无法连接到数据库)- 原因:数据库信息填写错误。
- 解决:检查数据库名、用户名、密码是否正确,数据库主机是否为
localhost。
-
问题2:安装时提示
目录没有写入权限- 原因:
data和include文件夹的权限不足。 - 解决:通过 FTP 将这两个文件夹的权限设置为
777,安装成功后再改回755。
- 原因:
-
问题3:安装完成后,网站首页空白或显示错误
- 原因:
data目录权限未改回755。- 数据库配置文件
/data/common.inc.php的权限不正确(通常是644)。 - PHP 版本不兼容。
- 解决:检查并修正相关目录和文件的权限。
- 原因:
-
问题4:访问网站出现乱码
- 原因:数据库编码、网页编码和文件编码不一致。
- 解决:确保所有地方都使用
UTF-8编码,在后台“系统基本参数”中检查网站编码设置,并确保你的源码包是 UTF-8 版本的。
恭喜你!如果以上步骤都顺利完成,你的 DedeCMS 网站就已经成功安装并可以运行了,接下来你就可以开始添加内容、选择模板、进行个性化设置了。
