下面我将为你提供一个详细、完整的图文式教程,以目前最流行的 Linux + Nginx + MySQL + PHP (LNMP) 环境为例进行讲解,如果你使用的是 LAMP (Apache) 环境,步骤基本类似,只是 Web 服务器部分不同。

第一步:环境准备
在安装 DedeCMS 之前,你的 VPS 必须已经搭建好了 Web 环境,我们推荐使用 LNMP 一键安装包来快速部署环境。
购买并连接 VPS
确保你已经拥有一台 VPS,并且可以通过 SSH 客户端(如 Xshell, PuTTY, 或 Terminal)连接到它。
安装 LNMP 环境
LNMP 一键安装包是国内非常成熟和流行的 VPS 环境部署脚本。
(1)下载安装脚本 在 SSH 终端中,执行以下命令下载最新的 LNMP 一键安装包:

wget http://soft.vpser.net/lnmp/lnmp1.7.tar.gz -cO lnmp1.7.tar.gz && tar zxf lnmp1.7.tar.gz && cd lnmp1.7
注意:lnmp1.7.tar.gz 是一个示例版本号,请访问 LNMP 官网 获取最新的下载链接。
(2)运行安装程序 下载并解压后,进入目录并执行安装命令:
./install.sh
(3)根据提示进行配置 脚本会自动检测你的系统环境,然后会让你进行一些配置:
- Please enter the root password of your MySQL: 输入你的 MySQL 数据库 root 用户的密码,请务必记住这个密码。
- Please enter the default MySQL charset: 输入 MySQL 的默认字符集,推荐使用
utf8mb4。 - Please enter the memory size of your VPS: 输入你的 VPS 内存大小,脚本会据此推荐合适的缓存配置,直接按回车使用默认值即可。
脚本会自动开始安装 Nginx, MySQL, PHP 以及 PHP 的一些常用扩展(如 php-mysql, php-gd, php-mbstring 等),这个过程可能需要 10-30 分钟,具体取决于你的 VPS 性能和网络速度,请耐心等待,直到看到 Install lnmp completed! enjoy it. 的提示。
第二步:下载并准备 DedeCMS 文件
环境搭建好后,我们就可以下载 DedeCMS 的源码了。
创建网站目录
我们会在 /home/wwwroot/ 目录下为每个网站创建一个独立的文件夹,我们这里以创建一个名为 mydede 的网站为例。
mkdir -p /home/wwwroot/mydede
下载 DedeCMS 最新版本
访问 DedeCMS 官网 下载最新的稳定版源码包,我们以命令行方式下载为例(以 DedeCMS V5.7 UTF8 SP2 为例):
# 进入网站目录 cd /home/wwwroot/mydede # 下载最新的 DedeCMS 源码包 (请替换为最新的下载链接) wget http://updatenew.dedecms.com/base/release57/DedeCMS-V5.7-UTF8-SP2.zip
解压并移动文件
下载的源码包是一个 ZIP 压缩文件,我们需要解压它。
# 安装 unzip 工具(如果系统没有) yum install unzip -y # 对于 CentOS/RHEL apt-get install unzip -y # 对于 Debian/Ubuntu # 解压 ZIP 文件 unzip DedeCMS-V5.7-UTF8-SP2.zip # 解压后会发现一个名为 dedecms 的文件夹,我们需要将其中的内容移动到当前目录 mv dedecms/* . # 清理临时文件 rm -rf DedeCMS-V5.7-UTF8-SP2.zip dedecms
设置目录权限
这是至关重要的一步!DedeCMS 需要对某些目录进行写入操作,如 data/, uploads/, templets/ 等。
# 进入网站根目录 cd /home/wwwroot/mydede # 设置目录所有者为 www 用户(LNMP 默认用户) chown -R www:www . # 设置关键目录的权限为 755,data 目录为 777(为了安全,可以设置为 755 并设置 SGID,但 775 最简单) chmod -R 755 . chmod -R 777 data/ uploads/ a/ special/ html/ dede/ templets/
注意:将 data 等目录权限设为 777 是最简单但安全性较低的做法,更安全的做法是保持 755,并将这些目录的用户组设置为 www,然后设置 setgid 位,让新文件继承组权限,对于新手,777 是最不容易出错的。
第三步:配置 Nginx 虚拟主机
为了让 Nginx 能够正确解析你的网站,需要创建一个虚拟主机配置文件。
创建配置文件
在 /usr/local/nginx/conf/vhost/ 目录下创建一个新的配置文件,mydede.conf:
vim /usr/local/nginx/conf/vhost/mydede.conf
写入配置内容粘贴到文件中,并请务必修改 server_name 为你的域名或 IP 地址。
server
{
listen 80;
# 请替换为你的域名或 IP
server_name mydede.com www.mydede.com;
index index.html index.htm index.php;
# 请替换为你的网站根目录
root /home/wwwroot/mydede;
# 将所有非 PHP 请求指向 index.php,用于 DedeCMS 的伪静态
if (!-e $request_filename)
{
rewrite "^/index\.php$" /index.php last;
rewrite "^/([a-z0-9\-]+)\.html$" /index.php?arcname=$1 last;
rewrite "^/([a-z0-9\-]+)/([a-z0-9\-]+)\.html$" /index.php?arcname=$1&arctitle=$2 last;
rewrite "^/([a-z0-9\-]+)/([a-z0-9\-]+)/([a-z0-9\-]+)\.html$" /index.php?arcname=$1&arctitle=$2&arcid=$3 last;
}
location ~ \.php$
{
# 请替换为你的网站根目录
root /home/wwwroot/mydede;
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
# 禁止访问 .ht 文件和核心文件
location ~ /\.(ht|svn|git) {
deny all;
}
location ~ /(data|dede|include|special|templets)/.*\.(php|php5)$ {
deny all;
}
}
重启 Nginx 使配置生效
lnmp restart
或者单独重启 Nginx:
nginx -s reload
第四步:通过浏览器完成安装
所有的准备工作都已完成,只剩下最后的图形化安装步骤。
访问安装地址
在浏览器中输入你的域名或 VPS 的 IP 地址,http://your_vps_ip 或 http://mydede.com。
如果一切正常,你应该会看到 DedeCMS 的欢迎安装界面。
开始安装
点击“我同意”,进入安装协议页面,再点击“继续进入安装向导”。
检查环境
系统会自动检测你的 PHP 和 MySQL 环境,如果所有项目都显示“√”或“正常”,则说明环境没有问题,如果有错误,请返回前面的步骤检查是否遗漏。
数据库配置
这是最关键的一步:
- 数据库服务器:
localhost - 数据库用户名:
root - 数据库密码: 你在第一步安装 LNMP 时设置的 MySQL root 密码
- 数据库名: 你可以为 DedeCMS 创建一个新的数据库,
dedecms_db,你可以在安装前通过mysql -u root -p命令登录 MySQL 并执行CREATE DATABASE dedecms_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;来创建。 - 数据库前缀: 可以使用默认的
dede_,也可以自定义,避免与其他程序冲突。 - 网站默认管理员账号: 设置你的管理员用户名(如
admin)。 - 网站默认管理员密码: 设置一个强密码。
- 网站安全设置: 勾选“开启浏览器访问验证”,并设置一个验证码,这可以有效防止恶意安装。
完成安装
点击“开始安装”,等待片刻,安装成功后,会提示你删除 /install/ 目录。
请务必执行这一步! 这是为了安全考虑。
你可以通过 SSH 连接到 VPS,执行以下命令:
rm -rf /home/wwwroot/mydede/install/
访问网站和后台
- 网站前台:
http://your_domain.com - 网站后台:
http://your_domain.com/dede/
使用你刚刚设置的管理员账号和密码登录后台。
总结与常见问题
- 安装失败/白屏/500错误:
- 首先检查 Nginx 和 PHP-FPM 的错误日志:
/usr/local/nginx/logs/error.log和/usr/local/php/var/log/php-fpm.log。 - 检查文件和目录权限是否正确设置。
- 检查
php.ini配置,特别是upload_max_filesize,post_max_size,memory_limit等参数是否满足需求。
- 首先检查 Nginx 和 PHP-FPM 的错误日志:
- 后台无法登录:
- 检查浏览器是否开启了 Cookie。
- 检查
data目录权限是否为 777 或 755 且用户组为 www。 - 清除浏览器缓存和 Cookie 后再试。
- 图片/附件上传失败:
- 检查
uploads目录权限。 - 检查
php.ini中的file_uploads,upload_max_filesize,post_max_size设置。 - 检查 Nginx 配置中是否有对上传文件类型的限制。
- 检查
恭喜你!至此,你已经成功在 VPS 上安装并运行了 DedeCMS,接下来你就可以开始搭建你的网站了。
