Flow2api 支持本地部署和 Docker 部署。本文按“准备账号 Token → 选择验证码方案 → 配置代理 → 常见问题”的顺序整理。
1. 获取 Flow 账号 ST Token
- 登录 Google Flow。
- 在 Flow 页面按
F12打开开发者工具。 - 进入 Application / 应用 → Cookies。
- 找到
__Secure-next-auth.session-token，它就是 ST 的值。 - 把 ST 粘贴到 Flow2api 配置页。保存前先配置项目代理，否则可能保存失败。
2. 验证码 / 打码方式选择
Flow 增加了额外验证码，Flow2api 可选择浏览器打码、内置有头浏览器、远程打码或第三方打码服务。
- 商用打码：YES、CAP、EZ-CAP 等都需要充值；目前 YesCaptcha 反馈较多。注册 YesCaptcha 后获取 API Key，填入系统配置中的
YesCaptcha API密钥。 - Docker 有头 / 内置浏览器：使用
docker-compose.headed.yml、Dockerfile.headed或flow2api-headed镜像。优点是镜像内自带浏览器和模拟显示环境，可直接打码；缺点是镜像较大。 - 本地部署：Clone 或下载项目后运行
python main.py，会自动安装所需浏览器环境。仍需配置请求网络出口和打码网络出口。 - Docker 原版无打码环境：使用
Dockerfile、docker-compose.yml或flow2api镜像。优点是镜像小；缺点是需要远程打码或商用打码。
3. 网络出口建议
网络出口质量会直接影响 reCAPTCHA 分数和 Flow 请求稳定性。建议使用合规、质量较高、延迟稳定的网络出口，并尽量避免频繁切换低质量出口。
Yaml 轮询
Yaml 轮询的核心作用是把多个合规网络出口放进同一个策略组，由 Mihomo / Clash 按健康检查结果自动轮换或负载均衡。这样可以降低单一出口 IP 被风控、延迟抖动或验证码分数过低带来的失败率。
- 适合场景：多节点、多地区合规网络出口混合使用。
- 建议策略：优先选低延迟、稳定返回 200 的节点，避免大量低质量节点混入。
- 公网 VPS 注意：如果机器同时对外提供 Flow2api 服务，需要让服务端口直连，避免入站流量被 TUN/MATCH 规则错误接管。
Warp
Warp 测试正常通过。仓库：chutiangekmm/warp-proxy
4. 常见问题
PUBLIC_ERROR_SOMETHING_WENT_WRONG：打码分数太低，尝试换高质量合规网络出口。PUBLIC_ERROR_USER_QUOTA_REACHED：Flow 账号没有可用配额。PUBLIC_ERROR_UNSAFE_GENERATION：提示词或参考图违规。Failed to obtain reCAPTCHA token：未获取到打码 token，检查代理、打码配置和浏览器环境。
5. 并发与多部署
Flow 账号本身没有明显并发限制；实测一个号可以较多并发。但 Flow2api 服务本身可能会卡，建议多实例分布式部署，多个 Flow2api 可以共用同一个号。
6. 水印
水印与请求 IP/地区有关。可尝试切换请求 IP 或更换服务器地区；目前没有明确公开指标说明哪个地区一定有水印或无水印。
7. 自动更新账号 Token
支持自动账号登录与 Token 更新：genz27/flow2api_tupdater