| # FlareSolverr 处理 Cloudflare 拦截 |
|
|
| 本文说明如何配合 `docker-compose.warp.yml` 中的 WARP、Privoxy、FlareSolverr，解决注册流程遇到 Cloudflare 拦截的问题。 |
|
|
| ## 工作方式 |
|
|
| 注册流程不会每个请求都调用 FlareSolverr。当前逻辑是： |
|
|
| 1. 注册请求先按配置走代理链路。 |
| 2. 如果响应被识别为 Cloudflare challenge 或 403/503 拦截，后端调用 FlareSolverr。 |
| 3. FlareSolverr 打开目标地址并返回 `cf_clearance` cookie 和 User-Agent。 |
| 4. 后端把 clearance 写入当前注册 session，并重试当前请求一次。 |
| 5. 同进程内会缓存 clearance，后续同 host 请求可复用。 |
|
|
| ## 启动容器 |
|
|
| 推荐直接使用仓库里的 WARP compose： |
|
|
| ```bash |
| docker compose -f docker-compose.warp.yml up -d |
| ``` |
|
|
| 相关服务： |
|
|
| | 服务 | 用途 | 默认内部地址 | |
| | --- | --- | --- | |
| | `warp-proxy` | 提供 WARP 出站网络 | `socks5://warp-proxy:1080` | |
| | `privoxy` | 把 HTTP 代理转发到 WARP | `http://privoxy:8118` | |
| | `flaresolverr` | 获取 Cloudflare clearance | `http://flaresolverr:8191` | |
| | `app` | chatgpt2api 主服务 | `http://localhost:3000` | |
|
|
| 如果 app 运行在 Docker compose 网络内，FlareSolverr URL 使用： |
|
|
| ```text |
| http://flaresolverr:8191 |
| ``` |
|
|
| 如果 app 直接运行在宿主机，FlareSolverr URL 通常需要改成： |
|
|
| ```text |
| http://127.0.0.1:8191 |
| ``` |
|
|
| ## 设置页配置 |
|
|
| 打开： |
|
|
| ```text |
| http://localhost:3000/settings/ |
| ``` |
|
|
| 进入 `FlareSolverr` tab，推荐配置： |
|
|
| | 字段 | 推荐值 | |
| | --- | --- | |
| | 启用 FlareSolverr 清障 | 开启 | |
| | 出站模式 | `单代理/WARP` | |
| | 清障代理 URL | `http://privoxy:8118` | |
| | Clearance 模式 | `FlareSolverr` | |
| | FlareSolverr URL | `http://flaresolverr:8191` | |
| | 超时秒数 | `60` | |
| | 刷新间隔秒数 | `3600` | |
|
|
| 保存后可以点击： |
|
|
| - `测试当前清障代理` |
| - `测试 Clearance` |
|
|
| 两个测试都通过后，再启动注册任务。 |
|
|
| ## 注册页使用 |
|
|
| 打开： |
|
|
| ```text |
| http://localhost:3000/register/ |
| ``` |
|
|
| 正常配置邮箱和注册参数即可。遇到 Cloudflare 拦截时，日志会出现类似： |
|
|
| ```text |
| 检测到 Cloudflare 拦截，尝试刷新 clearance |
| Cloudflare clearance 刷新完成，重试当前请求 |
| ``` |
|
|
| 如果刷新失败，日志会提示 `clearance 刷新失败或重试后仍失败`，这通常表示当前 IP、WARP 出口或 FlareSolverr 浏览器环境仍被拦截。 |
|
|
| ## 常见问题 |
|
|
| ### FlareSolverr 地址填哪个？ |
|
|
| - Docker compose 内运行 app：`http://flaresolverr:8191` |
| - 宿主机运行 app：`http://127.0.0.1:8191` |
|
|
| ### 为什么打开了 FlareSolverr，但注册一开始没有调用？ |
|
|
| 这是正常的。FlareSolverr 只在检测到 Cloudflare 拦截后触发，用来刷新 clearance 并重试当前请求。 |
|
|
| ### 为什么测试代理成功，但 Clearance 失败？ |
|
|
| 代理只说明出站网络可用。Clearance 失败可能是： |
|
|
| - `flaresolverr` 容器没有启动 |
| - app 无法访问 `flaresolverr_url` |
| - WARP 出口 IP 仍被 Cloudflare 拦截 |
| - FlareSolverr 启动浏览器超时 |
|
|
| ### 如何确认容器在运行？ |
|
|
| ```bash |
| docker compose -f docker-compose.warp.yml ps |
| ``` |
|
|
| 查看 FlareSolverr 日志： |
|
|
| ```bash |
| docker logs -f chatgpt2api-flaresolverr |
| ``` |
|
|
| 查看主服务注册日志： |
|
|
| ```bash |
| docker logs -f chatgpt2api-warp |
| ``` |
|
|
