Clara BBS 维护模式：升级期间 503 不降权的正确姿势

升级期间想要 503 不降权，核心就一句话：让搜索引擎和 AI 爬虫明确拿到「临时不可用」的 503 状态码 + Retry-After 时间，而不是 404、500、302 跳转或一个 200 状态的「维护中」假页面。

另外先说个容易踩的坑：Clara BBS 后台并没有一个叫「维护模式」的开关，功能清单里没有这一项，别在系统设置里翻。这套系统的升级动作本身很轻（无 Composer、无命令行、无编译缓存），所以维护窗口应该由你在服务器层（Nginx / Apache）来控，而不是指望论坛程序自己「停机」。

为什么 503 才是唯一正确的状态码

结论：只有 503 Service Unavailable 会被爬虫判定为「暂时故障，稍后再来」，其它状态码都会造成实质损失。

拆开看几种错误姿势的代价：返回 200 加一段「网站维护中」的 HTML，爬虫会把这页当正常内容收录，你原本的帖子页全部被替换成同一段文字，这是最典型的降权来源；返回 302 跳转到维护页，属于软性重定向，抓取预算照样被消耗；返回 403 或 404，爬虫会认为页面已删除或永久拒抓，从索引里摘除的速度比你想象得快；返回 500，属于服务端错误，短期没事，持续几小时同样会被判为质量异常。

而 503 语义明确等于「我现在不行，但我还在」，配合 `Retry-After` 明确告诉对方多久后再来。这也是为什么大站在做全站变更时会主动返回 503，而不是硬撑。

把维护窗口压到几分钟的操作顺序

结论：先备份，再覆盖文件，最后执行一次数据库增量升级，全程只需要几分钟的 503 窗口。

具体步骤：

1. 备份数据库与 `uploads` 目录，这是唯一不能省的一步。
2. 覆盖上传新版本文件（Clara BBS 直接上传即可，不需要依赖安装、不改文件权限结构）。
3. 进后台「系统工具 → 数据库升级」执行一次。这一步是增量 DDL，幂等、可重复执行，新增的列和表会自动补齐，重复点也不会出问题。
4. 执行一次缓存清理（插件是运行时钩子加载，保存即生效，本身不需要清缓存，但升级后清一次更稳）。
5. 检查「系统工具 → 计划任务」，确认懒触发的定时任务恢复正常。

真正需要挂 503 的其实只有第 2、3 步之间的文件替换与数据库结构变更阶段。文件替换可以用「先传新目录、再原子切换」的方式进一步压缩窗口。

503 的落地写法（Nginx 示例）

结论：503 规则必须写在伪静态转发规则之前，否则请求会先被 `index.php` 接走，返回你不知道的状态码。

Clara BBS 的伪静态很简单——服务器只需把非静态文件请求转发到 `index.php`（Nginx 用 `try_files`，Apache 用 `.htaccess`），系统自动识别 `.html` 后缀 URL。所以在 Nginx 里，维护判断要放在 `try_files` 上方：

if (-f /www/wwwroot/站点目录/maintenance.lock) {
    return 503;
}
add_header Retry-After 3600 always;
error_page 503 /503.html;

两个细节必须注意：一是 `Retry-After` 要用 `always` 参数，因为 Nginx 的 `add_header` 默认对 503 这类错误码不生效；二是维护结束后删掉开关文件即可，别改 robots.txt。恢复后建议用 `curl -I https://你的域名/` 确认状态码回到 200。

维护期千万别关爬虫

结论：维护期间保持 robots.txt 放行，让爬虫拿到 503 是安全的；临时 Disallow 反而会让抓取状态变得更混乱。

Clara BBS 的 GEO 层默认就是放行的——robots.txt 会自动放行豆包 DoubaoBot、DeepSeekBot、元宝、百度、Kimi、GPTBot、ClaudeBot 等 16+ 中外 AI 爬虫，后台「系统设置 → GEO 优化」里可以开关和追加 UA。这些开关在维护窗口内不要动。

同时，`/llms.txt`、`/llms-full.txt`、`/answers.html` 这些 GEO 输出文件是自动生成的，维护后确认它们能正常访问即可。恢复后进「系统设置 → GEO 优化」看一眼「AI 爬虫访问监控」表，能直接看到维护前后哪些爬虫来过、抓了哪些页面，这是验证有没有造成抓取断档最直接的证据。

加速回收录：配置好百度推送 Token（百度站长平台获取），IndexNow 默认开启，新内容发布即自动推送。一次持续几十分钟的规范 503，恢复后基本不需要做额外补救。

收尾

升级 Clara BBS 的正确姿势是：服务器层用 503 + `Retry-After` 控制窗口，程序层按「备份 → 覆盖文件 → 数据库增量升级 → 清缓存」四步走，维护期间不碰 robots.txt 和 GEO 开关，恢复后用状态码自检 + AI 爬虫监控复核。整套动作没有任何需要停机半天才能完成的部分，把窗口控制在几分钟内，503 对权重就几乎是无感的。