第一步:检查最常见的原因——服务器未开启PHP解析

这是导致“无法显示网页”或直接下载安装文件的最主要原因,服务器(尤其是Windows的IIS或Nginx)默认不认识 .php 文件,需要手动配置。

dedecms安装时总是无法显示网页
(图片来源网络,侵删)

如果您使用的是 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环境的前提。
  • 配置处理程序映射
    1. 在IIS管理器中,选中您的网站。
    2. 双击“处理程序映射”。
    3. 在右侧操作栏点击“添加脚本映射...”。
    4. 请求路径填入 *.php
    5. 可执行文件选择PHP的安装路径下的 php-cgi.exe (C:\php\php-cgi.exe)。
    6. 名称可以填 PHP
    7. 确认后,重启IIS服务。

第二步:检查服务器软件是否正常运行

在浏览器中访问您的域名(http://www.yourdomain.com),看看是否能正常显示默认的首页。

  • 如果能显示首页:说明Web服务器软件(Apache/Nginx/IIS)是正常工作的,问题很可能出在PHP配置上(请返回第一步)。
  • 如果也不能显示首页:说明Web服务器软件本身可能有问题,或者域名解析、防火墙设置有问题,请先确保服务器软件能正常启动并响应请求。

第三步:检查PHP环境是否正常

这是一个非常有效的排查方法。

  1. 在您的网站根目录(也就是您解压DedeCMS的文件夹)里,创建一个新的文本文件。
  2. 将文件命名为 info.php
  3. 用记事本打开这个文件,输入以下代码:
    <?php
    phpinfo();
    ?>
  4. 保存文件,然后在浏览器中访问 http://www.yourdomain.com/info.php
  • 如果能看到一个详细的PHP信息页面:恭喜您,您的PHP环境是正常的!问题可能出在DedeCMS的安装步骤或权限上(请看第四步)。
  • 如果看到下载提示或空白页:这100%是第一步的PHP解析配置问题,请务必返回第一步仔细检查。

安装成功后,为了安全,请务必删除这个 info.php 文件!

dedecms安装时总是无法显示网页
(图片来源网络,侵删)

第四步:检查DedeCMS安装步骤和权限

如果PHP环境正常,但在安装过程中遇到问题(如无法写入配置文件、数据库连接失败等),请检查以下几点:

  1. 文件权限

    • Linux服务器:确保网站根目录(/dedecms/)及其子目录(/data/, /uploads/, /a/等)具有正确的读写权限。
    • 最简单粗暴的方法(在测试环境可用)是给整个目录 777 权限,但强烈不推荐在生产环境使用
    • 正确的权限设置通常是:
      • 目录权限:755
      • 文件权限:644
      • data 目录需要 755777 权限,因为安装程序需要写入 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
  2. 安装步骤

    • 确保您访问的是正确的安装地址:http://www.yourdomain.com/install/
    • 检查 install 目录是否存在,安装完成后,为了安全,务必删除 install 目录
  3. 数据库配置

    dedecms安装时总是无法显示网页
    (图片来源网络,侵删)
    • 在安装向导的“数据库设置”步骤,请仔细核对:
      • 数据库名称
      • 数据库用户名
      • 数据库密码
      • 数据库主机(通常是 localhost
    • 确保您已经在MySQL/MariaDB中为DedeCMS创建了数据库和用户,并授予了该用户对数据库的所有权限。

第五步:检查服务器安全组和防火墙

  • 云服务器(如阿里云、腾讯云、Vultr等):请检查服务器的“安全组”设置,确保已经放行了 80 (HTTP) 和 443 (HTTPS) 端口。
  • 本地服务器或物理机:检查Windows防火墙或Linux的 iptables/firewalld,确保没有阻止Web服务器(Apache/Nginx)的端口。

总结与排查清单

遇到“无法显示网页”,请按以下顺序检查:

  1. 【首要】 检查PHP解析是否配置正确(IIS/Nginx/Apache的配置)。
  2. 【快速】 创建 info.php 文件测试PHP环境是否工作。
  3. 【环境】 检查Web服务器软件本身是否正常运行(访问域名看首页)。
  4. 【权限】 检查DedeCMS目录,特别是 data 目录的文件权限。
  5. 【网络】 检查云服务器的安全组或本地防火墙设置。

按照这个流程,99%的“无法显示网页”问题都能得到解决,祝您安装顺利!