Cloudflare 过盾助手
适用于开启 Cloudflare 五秒盾(或更严格 Bot Fight Mode)的聚合中转站,确保插件既能识别账号信息,也能在请求被限制时自动重试。
功能概述
- 自动检测:识别到页面标题包含
Just a moment、存在#cf-content、或 API 返回 401/403/429 等状态码时,自动触发过盾流程。 - 临时窗口:后台开启与目标域同源的临时标签页,沿用浏览器 Cookie,完成 Cloudflare 的 JS/人机挑战后再返回原页面。
- 请求降级:普通
fetch失败时,改由临时窗口携带 Cookie 重放请求,避免跨域/凭据缺失导致的无限重试。 - 手动兜底:若 Cloudflare 判定需要用户交互,会自动弹出窗口提示在 20 秒内完成验证。
使用步骤
- 登录目标站点,在插件中新增账号 → 填写站点地址 → 点击“自动识别”。
- 如遇 Cloudflare 提示,浏览器会自动弹窗;只需保持窗口前台,等待自动完成验证或按提示点选。
- 验证通过后,插件会自动回到识别流程,继续读取 Access Token、余额、模型列表等数据。
- 若是 API 请求阶段触发限流(常见于 CC Switch/CherryStudio 导出或 New API 同步),系统会自动启用临时窗口重发,无需额外操作。
用过盾历史排查
想知道临时页面为什么打开,或为什么没有打开,可以前往 设置 → 数据刷新,点击 网站验证辅助 标题旁的 过盾历史。历史在弹窗中显示,平时默认关闭。
账号的过盾相关异常提示、自动过盾受限提醒、签到结果中的验证失败或临时页面关闭提示,以及临时页面上的助手提示,也提供 查看过盾历史 入口。
- 搜索站点、操作或诊断信息,也可以按处理状态筛选;搜索和筛选覆盖当前保留的全部记录。
- 展开一条记录,查看触发操作、来源、可用的 HTTP 状态或错误码,以及临时页面是否创建或复用。
- 若记录显示被设置或权限阻止,点击 查看相关设置 定位对应选项,再按需要调整。
- 需要保留排查信息时,点击 复制诊断详情;要删除本机记录,可在历史右上角的更多菜单中选择 清空历史 并确认。
历史最多保留本机最近 100 条记录,只记录新发生的临时页面请求,不会补录升级前的操作。站点地址只保留来源,不保存 URL 路径、查询参数、Token、Cookie 或请求与响应正文。
处理完成表示该次临时页面任务返回了完成结果;账号是否恢复可用,请以刷新、签到等操作的最终结果为准。
注意事项
- IP 质量:若连续无法通过,需要更换网络或在站点侧临时放宽防护;默认超时时间为 20 秒。
- 弹窗权限:请允许浏览器弹出窗口,否则插件无法创建临时标签页。
- 重复挑战:若频繁触发 429,可在 自建站点管理中调低速率或启用模型白名单,减少无效请求。
常见问题
| 场景 | 解决方案 |
|---|---|
| 弹窗秒关 | 查看浏览器地址栏右侧是否拦截弹窗,允许后重新识别。 |
| 一直停留在 “Just a moment” | 在弹出的窗口中手动完成验证码;若仍失败,请更换 IP。 |
| API 导出仍报 403 | 手动点击“再次导出”,后台会复用刚通过过盾的 Cookie;若失败,检查目标站是否限制管理员 Token。 |
| 无弹窗但识别失败 | 站点可能移除了 Cloudflare,但接口返回 401(凭据失效),请重新登录站点并刷新插件数据。 |
| 验证页面显示不全 | 在 设置 → 数据刷新 → 网站验证辅助 → 验证窗口尺寸 调整宽高并保存,下次新建验证窗口时生效。 |
