迅睿CMS站点无法访问后恢复的实操配置详细指南

第一步：排查服务器基础运行环境

1.1 检查PHP版本是否符合要求

迅睿CMS要求PHP版本为7.4-8.2，超出该范围会导致核心功能异常无法访问。操作步骤：

• 通过FTP或宝塔文件编辑器，在站点根目录新建名为info.php的文件，文件内容为：

``` ```

• 上传文件后，访问域名http://你的站点域名/info.php，在页面中搜索“PHP Version”，确认版本在7.4-8.2区间。
• 若版本不符，直接在服务器面板（如宝塔）的软件商店切换PHP版本；如果是LNMP环境，执行命令lnmp manager，按提示选择对应版本后重启。

1.2 检查数据库服务是否正常运行

数据库服务异常会直接导致站点无法连接数据库。操作步骤：

• CentOS系统执行命令：systemctl status mysqld，若显示“inactive”则表示未运行，执行启动命令：systemctl start mysqld；
• Ubuntu系统执行命令：systemctl status mysql，未运行则执行：systemctl start mysql；
• 若启动失败，检查数据库密码是否正确，或查看错误日志/var/log/mysqld.log（CentOS）。

第二步：修复迅睿CMS核心配置文件

配置文件错误是站点无法访问的高频原因，核心需修改2个文件，路径均在站点根目录config/下。

2.1 修复数据库配置文件database.php

将以下完整代码替换原有内容，必须准确填写你的数据库信息：

``` 'mysql', 'connections' => [ 'mysql' => [ 'driver' => 'mysql', 'host' => '127.0.0.1', 'port' => '3306', 'database' => '你的数据库名', 'username' => '你的数据库用户名', 'password' => '你的数据库密码', 'charset' => 'utf8mb4', 'collation' => 'utf8mb4_unicode_ci', 'prefix' => 'xrui_', ] ] ]; ```

• 重点说明：prefix必须与后台数据库表前缀一致，若不确定，可登录数据库查看表名前缀；
• 避免数据库名、密码含特殊字符（如@、除外），否则会导致连接失败。

2.2 修复站点核心配置文件app.php

将以下完整代码替换原有内容，确保信息与实际站点一致：

``` 'https://你的站点域名/', 'debug' => false, 'key' => '迅睿后台-系统设置-站点设置中的APP_KEY', ]; ```

• 重点：url必须为站点实际访问地址（带http/https，如遇301跳转，需填写最终域名）；
• debug务必设为false，开启后会暴露错误信息，且站点安全性降低；
• key需复制后台生成的完整APP_KEY，错误会导致站点无法加载核心资源。

第三步：修复URL重写规则（解决404错误）

迅睿CMS依赖伪静态规则，规则错误会导致所有页面404，需根据服务器类型修改。

3.1 Nginx服务器配置

在站点对应的Nginx配置文件（一般在/usr/local/nginx/conf/vhost/下），找到当前站点的server块，修改location /节点，添加迅睿专属规则：

``` location / { try_files $uri $uri/ /index.php?$query_string; } 静态资源缓存规则 location ~ \.(js|css|png|jpg|jpeg|gif|ico)$ { expires 30d; log_not_found off; } ```

• 修改后执行命令nginx -s reload重载配置，规则立即生效。

3.2 Apache服务器配置

迅睿CMS根目录自带.htaccess文件，修改内容如下（子目录站点需调整RewriteBase）：

``` RewriteEngine On RewriteBase / RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.)$ index.php?$1 [L] ```

• 若访问后仍404，需先开启Apache的rewrite模块，执行命令：a2enmod rewrite，再重启Apache：systemctl restart apache2；
• 子目录站点需将RewriteBase /改为RewriteBase /你的子目录名/。

第四步：修复权限与缓存验证站点

4.1 修复目录权限

迅睿CMS的runtime、config、upload目录需可写，否则无法生成缓存或上传文件：

• 服务器根目录执行命令：chmod -R 755 runtime config upload；
• 若使用宝塔面板，直接在文件管理器中右键对应目录，修改权限为755，所有者为www用户。

4.2 清除缓存并测试

• 可访问后台（若能进入），执行【系统维护-清除全部缓存】；
• 服务器根目录执行命令：rm -rf runtime/，强制清空缓存文件；
• 访问站点域名，若能正常显示首页，即为恢复成功；若仍报错，重点核对数据库配置和APP_KEY的准确性，90%的异常会出现在这两处。