第一步:检查最常见的原因——服务器未开启PHP解析
这是导致“无法显示网页”或直接下载安装文件的最主要原因,服务器(尤其是Windows的IIS或Nginx)默认不认识 .php 文件,需要手动配置。

(图片来源网络,侵删)
如果您使用的是 Apache 服务器:
- 检查
httpd.conf文件:找到LoadModule php7_module modules/libphp7.so(或你PHP版本对应的模块) 这一行,确保它没有被注释掉(行首没有 )。 - 添加
AddType指令:在配置文件中找到<IfModule mime_module>部分,确保里面有类似下面这样的行:AddType application/x-httpd-php .php AddType application/x-httpd-php-source .phps
- 重启Apache服务:保存配置文件后,重启Apache使配置生效。
如果您使用的是 Nginx 服务器:
Nginx的配置是关键,请检查您的 nginx.conf 或站点配置文件,确保 server 块里有正确的PHP处理配置。
server {
listen 80;
server_name yourdomain.com; # 您的域名
root /path/to/your/website; # 网站根目录
location / {
index index.php index.html index.htm;
}
# 关键部分:处理.php文件
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000; # 或者是 unix:/var/run/php/php7.4-fpm.sock; 根据你的PHP-FPM配置来
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
- 重启Nginx和PHP-FPM:保存配置后,重启Nginx和PHP-FPM服务。
如果您使用的是 IIS 服务器 (Windows):
- 安装 URL Rewrite 模块:这是IIS运行PHP环境的前提。
- 配置处理程序映射:
- 在IIS管理器中,选中您的网站。
- 双击“处理程序映射”。
- 在右侧操作栏点击“添加脚本映射...”。
- 请求路径填入
*.php。 - 可执行文件选择PHP的安装路径下的
php-cgi.exe(C:\php\php-cgi.exe)。 - 名称可以填
PHP。 - 确认后,重启IIS服务。
第二步:检查服务器软件是否正常运行
在浏览器中访问您的域名(http://www.yourdomain.com),看看是否能正常显示默认的首页。
- 如果能显示首页:说明Web服务器软件(Apache/Nginx/IIS)是正常工作的,问题很可能出在PHP配置上(请返回第一步)。
- 如果也不能显示首页:说明Web服务器软件本身可能有问题,或者域名解析、防火墙设置有问题,请先确保服务器软件能正常启动并响应请求。
第三步:检查PHP环境是否正常
这是一个非常有效的排查方法。
- 在您的网站根目录(也就是您解压DedeCMS的文件夹)里,创建一个新的文本文件。
- 将文件命名为
info.php。 - 用记事本打开这个文件,输入以下代码:
<?php phpinfo(); ?>
- 保存文件,然后在浏览器中访问
http://www.yourdomain.com/info.php。
- 如果能看到一个详细的PHP信息页面:恭喜您,您的PHP环境是正常的!问题可能出在DedeCMS的安装步骤或权限上(请看第四步)。
- 如果看到下载提示或空白页:这100%是第一步的PHP解析配置问题,请务必返回第一步仔细检查。
安装成功后,为了安全,请务必删除这个 info.php 文件!

(图片来源网络,侵删)
第四步:检查DedeCMS安装步骤和权限
如果PHP环境正常,但在安装过程中遇到问题(如无法写入配置文件、数据库连接失败等),请检查以下几点:
-
文件权限:
- Linux服务器:确保网站根目录(
/dedecms/)及其子目录(/data/,/uploads/,/a/等)具有正确的读写权限。 - 最简单粗暴的方法(在测试环境可用)是给整个目录
777权限,但强烈不推荐在生产环境使用。 - 正确的权限设置通常是:
- 目录权限:
755 - 文件权限:
644 data目录需要755或777权限,因为安装程序需要写入config.cache.inc.php文件。
- 目录权限:
- 您可以通过SSH执行以下命令来设置权限(请将
/path/to/your/website替换为您的实际路径):chown -R www:www /path/to/your/website # 将所有者改为Web服务器用户 (如www, nginx, apache) find /path/to/your/website -type d -exec chmod 755 {} \; # 设置所有目录为755 find /path/to/your/website -type f -exec chmod 644 {} \; # 设置所有文件为644 chmod -R 777 /path/to/your/website/data # 单独设置data目录为777
- Linux服务器:确保网站根目录(
-
安装步骤:
- 确保您访问的是正确的安装地址:
http://www.yourdomain.com/install/ - 检查
install目录是否存在,安装完成后,为了安全,务必删除install目录。
- 确保您访问的是正确的安装地址:
-
数据库配置:
(图片来源网络,侵删)- 在安装向导的“数据库设置”步骤,请仔细核对:
- 数据库名称
- 数据库用户名
- 数据库密码
- 数据库主机(通常是
localhost)
- 确保您已经在MySQL/MariaDB中为DedeCMS创建了数据库和用户,并授予了该用户对数据库的所有权限。
- 在安装向导的“数据库设置”步骤,请仔细核对:
第五步:检查服务器安全组和防火墙
- 云服务器(如阿里云、腾讯云、Vultr等):请检查服务器的“安全组”设置,确保已经放行了
80(HTTP) 和443(HTTPS) 端口。 - 本地服务器或物理机:检查Windows防火墙或Linux的
iptables/firewalld,确保没有阻止Web服务器(Apache/Nginx)的端口。
总结与排查清单
遇到“无法显示网页”,请按以下顺序检查:
- 【首要】 检查PHP解析是否配置正确(IIS/Nginx/Apache的配置)。
- 【快速】 创建
info.php文件测试PHP环境是否工作。 - 【环境】 检查Web服务器软件本身是否正常运行(访问域名看首页)。
- 【权限】 检查DedeCMS目录,特别是
data目录的文件权限。 - 【网络】 检查云服务器的安全组或本地防火墙设置。
按照这个流程,99%的“无法显示网页”问题都能得到解决,祝您安装顺利!
