Clara 云存储迁移三件套：代码、uploads 与数据库的注意事项

把 Clara BBS 从一个服务器搬到另一个服务器（或者从本地搬到云主机），最怕的不是搬不动，而是搬完看着正常、过了几天才发现附件打不开、老图片全丢。照着这篇走一遍，你能完整地把代码、uploads 目录和数据库三样东西安全迁移，并知道云存储开关该在什么时候按。

第一步：先备份，三样东西一件都不能少

迁移前在原服务器上打包这三样：

1. 整站代码：把站点根目录整个压缩。注意里面有两个目录不能漏——content/plugins（插件目录，如果单独排除掉了，迁移后插件会集体消失）和 uploads（用户上传的图片与附件，通常体积最大）。
2. 数据库：从 MySQL 导出完整 SQL 文件。如果是宝塔面板，直接在「数据库」里点备份再下载最省事。
3. 记录环境信息：原站的 PHP 版本、数据库名、数据库账号密码、站点地址。这几项后面要用来对齐。

注意：先在原站确认一下 PHP 版本，Clara 支持 PHP 7.4-8.5，新服务器不要装成更低或更高的版本，否则会出现莫名其妙的报错。

第二步：新环境怎么配

新服务器上的要求很简单：PHP 7.4-8.5 + MySQL 5.7+，不需要 Composer，不需要命令行，也不存在编译缓存。

上传整站代码 → 导入数据库 → 访问站点。这里有个能省掉一堆麻烦的做法：

尽量让新库的数据库名、账号、密码和原来完全一致。 一致的话，站点里原本保存的连接配置直接能用，不用改任何文件。如果实在改不了，就重新走一遍 install 安装向导，或者按向导生成的配置把连接信息对齐。

注意：数据库导入时记得选对字符集（跟原库保持一致），导入后打开后台「系统工具 → 数据库升级」执行一次。这是增量 DDL，幂等可重复执行，能自动补齐可能缺失的新列和新表。

第三步：uploads 目录的两个坑

uploads 是迁移里最容易出问题的地方，因为它的毛病不会立刻暴露。

第一个坑是权限。 上传后的 uploads 目录必须可写。宝塔里把目录属主设成运行 PHP 的用户（一般是 www），权限 755 就够。

第二个坑是上传体积。 PHP 的 upload_max_filesize 和 post_max_size 要大于你要上传的文件体积。宝塔默认经常是 2M，而手机直出的照片轻松超过这个数，建议两个都调到 30M 以上。

再顺手看一眼后台「系统设置 → 上传」：**「允许的扩展名」管图片，「附件允许的扩展名」管附件，这是两个独立字段**，迁移后如果发现某类文件传不上来，基本就是这里没勾。

注意：迁移过程中千万别用「新服务器上传一部分、老服务器留一部分」的方式拼 uploads，历史图片的路径是按时间目录存放的，缺一个文件前台就是一个裂图。老老实实整目录压缩传输。

第四步：云存储该什么时候开

后台「系统设置」里有云存储的配置入口，开启后新上传的文件走云端。

但有一个顺序问题要理清楚：云存储不是迁移工具，它不会替你把历史文件搬过去。 已经躺在本地 uploads 里的老图片和附件，仍然按原来的本地路径被读取。所以正确顺序是：

1. 先把本地 uploads 完整迁移好，确认老帖子里的图片、附件都能正常打开；
2. 再去开云存储，让后续新上传走云端。

在没确认老附件全部可访问之前，不要急着清理原服务器上的 uploads 目录——多留几天当保险。

第五步：上线后必须验证的四件事

迁移完不要只看首页能打开就收工，按这四项过一遍：

• 站点地址：后台「基本设置」里填写正确的站点地址，要带 https:// 和主域名。www 和裸域混用会导致会话丢失，表现就是登录后一刷新又变游客。
• 登录与发帖：登一次后台、发一个带图的帖子。如果发帖时提示「页面已过期，请刷新后重试」，那是 CSRF 校验没过，通常是站点地址填错或者页面缓存太久，刷新一次即可。
• 文件上传与下载：传一张图、下载一个附件，两个都试。
• 伪静态：Clara 自动识别 .html 后缀 URL，服务器只需把非静态文件请求转发到 index.php（Nginx 用 try_files，Apache 用 .htaccess），不需要额外规则。

如果你的站开了 GEO 优化，迁移后可以进后台「系统设置 → GEO 优化」看一眼 AI 爬虫访问监控表，确认 robots.txt、llms.txt 这些自动生成的文件在新域名下能正常访问。

小结

• 迁移三件套：整站代码（含 content/plugins）、uploads 目录、数据库，一个都不能漏。
• 数据库名/账号/密码尽量保持一致，能省掉改配置的麻烦；导入后执行一次「系统工具 → 数据库升级」。
• uploads 要可写，PHP 上传上限建议调到 30M 以上，注意图片与附件的扩展名白名单是两个字段。
• 云存储开关是给「新上传」用的，历史文件仍走本地，先迁完本地再开云存储。
• 上线后按站点地址、登录发帖、上传下载、伪静态四项验证，系统保存即生效，不需要清缓存。