迁移前置准备：必须先检测目标服务器运行环境，服务器环境需要满足迅睿 CMS 运行要求，环境检测通过后，才可以开展网站迁移操作。 环境检测脚本为安装包根目录下的
test.php，若缺失该文件可前往官方仓库下载。访问http://你的域名/test.php即可检测 PHP 版本、数据库支持、数据库账号连通性等环境信息；CMS 数据库配置文件路径：config/database.php。
一、一键迁移方法（迅睿工具箱）
配套视频教程：https://www.xunruicms.com/doc/video-%E4%BD%BF%E7%94%A8%E8%BF%85%E7%9D%BF%E5%B7%A5%E5%85%B7%E7%AE%B1%E8%BF%81%E7%A7%BB%E7%BD%91%E7%AB%99.html
将网站从服务器 A 迁移至服务器 B，操作步骤如下：
- 在原服务器 A的网站后台，安装官方工具箱插件：https://www.xunruicms.com/shop/app/692.html
- 设置工具箱访问密码，进入迅睿工具箱功能页面。
- 在工具箱内选择【网站迁移】功能，填写迁移完成后使用的新域名。
- 通过 phpMyAdmin 将原网站数据库备份，保存至网站对应目录，完成后点击下一步。
- 将网站全部程序打包压缩，命名为
www.zip。 - 把压缩包上传到目标服务器 B 的网站目录。
- 根据页面提示完成后续部署操作，即可完成迁移。
二、传统手动迁移方法
配套视频教程：https://www.xunruicms.com/doc/video-%E6%9C%AC%E5%9C%B0%E7%BD%91%E7%AB%99%E4%B8%8A%E4%BC%A0%E6%88%96%E8%BF%81%E7%A7%BB%E6%96%B9%E6%B3%95.html
场景 1：迁移前后网站域名保持一致
- 确认目标服务器 B 的环境可以正常运行迅睿 CMS，建议尽量保持新旧服务器环境版本一致。
- 在原服务器 A 完整备份网站全部文件与数据库，防止迁移过程出现故障无法回滚。
- 将原服务器全部网站文件上传至目标服务器 B。
- 设置目标服务器目录权限，尽量与原服务器权限保持统一；不熟悉权限配置时，可临时设置全站可读写权限（0777）。
- 如果数据库账号、密码发生变更，修改配置文件
/config/database.php，更新数据库连接信息；修改完成后访问test.php，验证数据库是否可以正常连接。 - 登录网站后台，执行更新全站缓存。
- 若附件资源仍然调用旧域名，手动删除目录
/cache/attach/内全部缓存文件。 - 网站访问无报错，代表迁移完成。
场景 2：迁移前后网站域名不相同（本地转线上 / 更换域名）
- 确认目标服务器环境满足迅睿 CMS 运行条件。
- 在原站点（本地 / 旧服务器）打开 phpMyAdmin，导出数据库备份文件（例如
xxxx.sql）。 - 使用编辑器打开导出的
.sql数据库文件，将文件内全部旧域名批量替换为新的正式域名，保存修改。 - 将修改完成的数据库文件导入目标服务器的数据库当中。
- 将整套网站程序文件上传至目标服务器。
- Linux 服务器可临时设置全站权限为 777，迁移结束后再按需调整为安全权限。
- 修改域名配置缓存文件
cache/config/site.php，把文件内旧域名全部替换为新域名。 - 若数据库账号密码发生变动，修改
/config/database.php，更新数据库配置；访问test.php脚本校验数据库连接状态。 - 登录网站后台，执行更新全站缓存。
- 如果附件依旧显示旧域名，删除
/cache/attach/目录下缓存文件。 - 处理编辑器内容内的旧图片、附件域名：可安装「内容维护工具」插件进行批量替换，插件地址：https://www.xunruicms.com/shop/782.html，对数据库各个内容字段做旧域名批量替换。
- 网站各项页面、功能访问正常，即代表迁移成功。
三、迁移后应急方案：后台 CSS 样式加载异常
现象：迁移完成登录后台，页面样式错乱、CSS 样式无法正常加载。 产生原因：域名配置没有更新到位。
- 打开新服务器的配置文件
cache/config/site.php，将文件中的旧域名修改为当前新域名。 - 刷新后台页面，页面样式恢复正常后，进入网站后台设置，确认站点域名配置为新域名。
- 执行全站缓存更新。
⚠️重要注意：搬迁前后 HTTP 协议状态需要保持统一。例如旧站为 HTTP，不要搬迁完成后直接切换为 HTTPS；建议迁移全部完成、网站正常访问之后，再开启 HTTPS 配置。