零门槛手把手：迅睿CMS完整服务器迁移全步骤实操指南

一、迁移前准备工作

1.1 完整备份原站点

迁移需要备份两部分核心内容：站点程序文件和数据库文件，根据原站点状态选择对应操作：

• 如果原后台可以正常登录：
  • 备份数据库：登录原站点后台（路径是你的域名/admin.php），依次点击「系统」-「数据库备份」，勾选全部数据表，点击开始备份，备份文件会自动保存在站点根目录的cache/backup/文件夹下
  • 备份程序文件：依次点击「系统」-「站点维护」-「打包全站」，等待打包完成后把压缩包下载到本地即可
• 如果原后台无法登录/仅能连接服务器：
  • 通过FTP或者SSH工具连接原服务器，找到迅睿CMS的站点根目录，将所有文件打包压缩，下载到本地
  • 导出数据库：用phpMyAdmin的话，进入对应数据库点击「导出」，选择快速导出，格式为SQL，下载即可；用命令行导出执行以下命令：

    ```
    mysqldump -u原数据库用户名 -p 原数据库名 > 迅睿备份.sql
    ```
    

    回车后输入原数据库密码，即可自动完成导出

1.2 新服务器环境准备

迅睿CMS支持PHP5.6-PHP8.1，推荐使用PHP7.4版本，需要开启curl、gd、mbstring、openssl、mysqli扩展，大部分建站面板都会默认开启，若未开启可在面板PHP设置中手动勾选开启。

在新服务器创建一个新的空数据库，记录好四个核心信息：数据库地址（一般默认是127.0.0.1）、数据库名、数据库用户名、数据库密码，后续配置会用到。

二、新服务器部署程序与导入数据

2.1 上传并解压程序文件

将之前下载的完整站点压缩包上传到新服务器的站点根目录，解压后检查根目录是否直接存在index.php、admin.php入口文件，如果解压后出现嵌套的同名文件夹，需要把文件夹内的所有文件移动到站点根目录，避免访问出错。

给upload、cache两个文件夹设置755权限，Linux服务器可执行命令：

```chmod -R 755 upload cache```

，宝塔面板可直接右键文件夹设置权限为755。

2.2 导入数据库

• phpMyAdmin导入：进入新服务器的phpMyAdmin管理面板，选中新建的空数据库，点击「导入」，选择之前导出的SQL备份文件，点击执行即可，若文件过大提示超出上传限制，使用命令行导入
• 命令行导入：将SQL文件上传到新服务器，进入文件所在目录，执行以下命令：

  ```
  mysql -u新数据库用户名 -p 新数据库名 < 迅睿备份.sql
  ```
  

  回车后输入新数据库密码即可完成导入

三、修改核心配置，这一步不能错

迅睿CMS的核心数据库配置文件路径为：站点根目录/config/database.php，打开该文件，将配置修改为新服务器的信息，可直接复制以下格式替换：

```
return [
'hostname' => '127.0.0.1', // 本地数据库默认127.0.0.1，远程数据库改对应地址
'username' => '新数据库用户名',
'password' => '新数据库密码',
'database' => '新数据库名',
'prefix'   => 'dr_', // 原站点表前缀没变就不改，原是什么填什么
'port'     => 3306, // 数据库端口默认3306，没改就不动
];
```

修改完数据库配置，接下来修改站点域名，两种方法二选一：

• 方法一（后台修改，推荐）：访问新域名/admin.php，进入后台后依次点击「系统」-「站点管理」，编辑对应站点，把站点域名改为你的新域名（格式为https://你的域名/，末尾必须带斜杠），保存即可
• 方法二（数据库直接改，适用于后台进不去）：打开新数据库的dr_site表，编辑siteurl字段，替换为你的完整新域名即可

如果更换了域名，需要批量替换数据库中附件的旧域名，执行以下SQL语句即可，替换占位符后直接运行：

```
UPDATE dr_attachment SET url = REPLACE(url, 'https://旧域名', 'https://新域名');
```

注意把前缀dr_改成你自己的数据表前缀。

最后检查伪静态配置，如果是Nginx服务器，将伪静态规则修改为以下内容即可，无需额外调整：

```
location / {
if (!-e $request_filename){
rewrite ^/(.)$ /index.php?$1 last;
}
}
```

Apache服务器使用默认自带的.htaccess文件即可，不需要修改。

四、测试验证与切换解析

4.1 功能测试

• 打开站点首页，检查图片、样式、附件是否正常加载
• 测试页面跳转、用户登录、留言搜索等动态功能是否正常
• 测试后台登录、内容编辑等操作是否正常

4.2 清除缓存

所有配置修改完成后，登录后台点击「清除缓存」，更新全站缓存即可。

4.3 切换域名解析

所有功能测试正常后，将域名的DNS解析地址修改为新服务器的IP，解析生效一般需要10分钟到2小时，生效后迁移就完成了。如果需要提前验证，可以先修改本地电脑的hosts文件测试，确认无误再切换DNS解析。

常见问题排查

迁移后验证码不显示：检查PHP是否开启GD扩展，检查cache目录权限是否为755

迁移后全部404：检查伪静态规则是否正确添加到Nginx主机配置中

提示数据库连接错误：检查config/database.php中的用户名、密码、数据库名是否填写正确