webchat2api

webchat2api 是一个将 GPT/ChatGPT Web、Grok/xAI Web 与 Gemini Web 能力封装为标准 API 接口的代理服务项目，提供 FastAPI 后端、Next.js Web 管理端、OpenAI 风格 API、Gemini native API、GPT/Grok/Gemini 账号池管理、文生文/文生图试验页以及 Docker 自托管部署能力。

Warning

免责声明：本项目涉及对 GPT/ChatGPT Web、Grok/xAI Web 与 Gemini Web 能力的研究与封装，仅供个人学习、技术研究与非商业性技术交流使用。严禁用于商业倒卖、批量滥用、违反服务条款或违法违规场景。使用者需自行承担账号受限、封禁及其他法律与合规风险。

Important

默认登录密钥为 admin，仅适合本地测试。公网或生产环境部署后必须通过 LOGIN_SECRET 或 WEBCHAT2API_AUTH_KEY 修改为强随机密钥。

功能概览

• OpenAI 风格 API：将 GPT/ChatGPT Web、Grok/xAI Web 与 Gemini Web 能力包装为 /v1/models、/v1/chat/completions、/v1/completions、/v1/complete、/v1/images/generations、/v1/images/edits、/v1/responses、/v1/messages 等接口；兼容上游前缀 /openai/v1/models、/openai/v1/chat/completions 和 /claude/v1/messages
• 公共接口：提供 /health、/version、/auth/login，AI 接口统一使用 Bearer Token 鉴权
• GPT/Grok/Gemini 文本模型：/v1/models 优先通过 provider=gpt 账号动态拉取 GPT 模型，并合并静态 Grok 与 Gemini 模型；/v1/chat/completions 按 model 自动分发到 GPT、Grok 或 Gemini 服务商账号
• Grok app-chat：支持通过 grok.com app-chat 路径访问带 mode_id 的 Grok 模型，并可走 Browser Bridge 用真实 Chromium 代理请求
• Grok 图片生成与编辑：grok-imagine-image-lite、grok-imagine-image、grok-imagine-image-pro 通过 app-chat 图片能力生成图片；grok-imagine-image-edit 支持 app-chat 图片编辑；grok-imagine-video 已列出但暂未实现，Grok files 和 voice 仍未接入
• Gemini native API：提供 /gemini/v1beta/models、generateContent、streamGenerateContent、deepresearch、deepresearch/stream、interactions 和 interactions/{id}；支持 Gemini native contents/parts/tools/toolConfig/generationConfig 与 functionCall/functionResponse 转换
• tier 感知账号选择：Grok app-chat 会按模型所需 basic、super、heavy tier 和账号 capabilities 优先选择匹配账号，未匹配时再回退到普通 Grok 轮换
• Web 管理后台：账号池、用户 API Key、代理、日志、图片任务、图片文件、备份、图片存储和系统配置管理
• 管理接口：提供 /api/settings、/api/auth/users、/api/accounts、/api/cpa/*、/api/sub2api/*、/api/remote-account/*、/api/image-tasks/*、/api/images*、/api/logs、/api/proxy/test、/api/storage/info、/api/backups*、/api/backup/test、/api/image-storage/* 等后台能力
• 远程账号注入：管理员可配置远程账号来源、手动同步来源，或通过 /api/remote-account/inject 注入账号；响应会隐藏来源鉴权 Token 和账号凭据
• 账号服务商：账号 provider 选择 gpt、grok 或 gemini，账号 type 仍表示套餐或订阅类型；账号导入、刷新、导出和脱敏逻辑按服务商模块处理。Gemini account_status 中的 psid_psidts、missing_psid、usable_gemini_session 等值是派生诊断标签，不包含实际 cookie 值。
• 试验页：/、/image、/image-manager、/accounts、/logs、/settings、/login 覆盖文生文聊天、文本模型批量可用性测试、文生图/图生图切换、图片队列、图片历史、图片管理、账号导入导出和系统设置；/image 的文本和图片测试可按 GPT/Grok/Gemini provider 过滤模型与账号，且 /image 提供 inline prompt/settings 组合式图片输入框，支持选择预设图片比例（包含未指定选项）以及可收起的紧凑输入栏（便于查看生成结果）
• 文生文聊天历史：保存在浏览器本地，刷新页面后仍保留
• 图片账号轮换：图片生成/编辑遇到失效账号时，会跳过该账号并尝试下一个可用账号
• 网络配置：ChatGPT Web、Grok Console 与 Grok app-chat 请求使用可配置网络 profile，支持独立的指纹、TLS impersonate、超时、代理和 Cloudflare Cookie
• 内容过滤：支持本地 sensitive_words 命中和可选 OpenAI 兼容 ai_review 审核；审核前会移除 base64 data URI 并截断长文本，fail_open 默认放行
• 云备份：支持 Cloudflare R2 定时和手动备份，可选 openssl AES-256-CBC 加密，并可按开关包含配置、CPA、Sub2API、日志、图片任务、账号快照、用户密钥快照和图片
• 图片存储：支持本地、WebDAV、双写模式，提供 WebDAV 连通性测试和同步；图片索引写入 data/image_index.json，标签写入 data/image_tags.json
• Grok 防护处理：支持手动 cf_clearance、FlareSolverr clearance 刷新，以及可选 Browser Bridge 浏览器路径；这些都是尽力而为，不保证绕过所有 Cloudflare/WAF 挑战
• GPT Turnstile：默认启用 enable_turnstile_solver，会在 ChatGPT 返回 Turnstile 要求时尝试生成 Sentinel Turnstile Token；该能力依赖上游挑战和求解结果，真实 GPT Turnstile 仍可能失败
• 账号导出：仅导出 TXT，并按 GPT/Grok/Gemini 服务商分别下载为 webchat2api-gpt.txt / webchat2api_grok.txt / webchat2api_gemini.txt；文件内容每行一个 access_token、sso 或 Gemini cookie/session 凭据
• 账号导入：账号导入弹窗按 GPT/Grok/Gemini provider 显示对应提示；GPT 支持 Access Token、Session JSON、CPA、远程 CPA 与 Sub2API，Grok 支持 token/cookie、CPA、远程 CPA 与 Sub2API（需要注意，前端手动与 TXT 导入仅接受裸 SSO 值或单行 sso=<值>，不支持分号、完整 Cookie 请求头、sso-rw 或其他 cookie 键值对；API 或远程注入路径拥有其各自的校验规则，用户必须遵循对应的端点 schema，不应假设前端接受完整 cookie 头部），Gemini 支持包含 __Secure-1PSID 的 cookie/session、CPA、远程 CPA 与 Sub2API
• 部署方式：Docker CLI、Docker Compose

Provider 模块边界

项目把 GPT、Grok、Gemini 拆为可独立维护的 provider 模块，公共 API 路由保持不变。

层级	位置	维护说明
后端 provider 基础与注册	services/providers/base.py、services/providers/registry.py	定义 provider 常量、ModelSpec、模型注册表和 provider 归一化。
GPT provider	services/providers/gpt/	GPT 模型、账号导入导出、ChatGPT Web 文本链路和 GPT 图片链路。
Grok provider	services/providers/grok/	Grok 模型、账号 token/cookie 处理、Console 文本链路、app-chat 文本与图片链路。
Gemini provider	services/providers/gemini/	Gemini 模型、cookie/session 账号处理、Gemini Web 文本链路和 Gemini native API 相关能力。
前端 provider 注册	web/src/providers/	账号页的导入文案、导出按钮、刷新能力、额度展示和 provider 标签集中配置。

维护新模型或账号字段时，优先改对应 provider 目录，再确认 services/providers/registry.py、services/account_service.py 和 web/src/providers/ 是否需要同步。services/models.py 仍是兼容 facade，供旧导入路径使用。

界面预览

快速开始

Docker CLI 部署

新用户可先克隆仓库并进入项目目录：

git clone https://github.com/zqbxdev/webchat2api
cd webchat2api

构建本地镜像并运行本地示例容器：

docker build -t webchat2api:latest .

docker run -d \
  --name webchat2api \
  --restart unless-stopped \
  -p 83:83 \
  -v $(pwd)/data:/app/data \
  -e PORT=83 \
  -e HOST=0.0.0.0 \
  -e LOGIN_SECRET=your-strong-secret \
  webchat2api:latest

如需容器访问宿主机代理：

docker run -d \
  --name webchat2api \
  --restart unless-stopped \
  --add-host=host.docker.internal:host-gateway \
  -p 83:83 \
  -v $(pwd)/data:/app/data \
  -e PORT=83 \
  -e HOST=0.0.0.0 \
  -e LOGIN_SECRET=your-strong-secret \
  -e PROXY_URL=http://host.docker.internal:7890 \
  webchat2api:latest

本地开发或 smoke 测试时，如果宿主机 83 端口已有生产容器，不要复用 webchat2api 容器名或 83:83 映射。建议使用独立开发容器和 8083:83 端口，例如：

docker build -t webchat2api:dev .

docker run --rm -d \
  --name webchat2api-dev \
  -p 8083:83 \
  -v $(pwd)/data-dev:/app/data \
  -e PORT=83 \
  -e HOST=0.0.0.0 \
  -e LOGIN_SECRET=admin \
  webchat2api:dev

curl http://localhost:8083/health

生产部署后访问：

• 服务地址：http://localhost:83
• 管理后台：http://localhost:83
• API Base URL：http://localhost:83/v1
• 登录密钥：使用启动时配置的 LOGIN_SECRET 或 WEBCHAT2API_AUTH_KEY，不要在生产环境使用默认 admin

Docker 镜像内置 Chromium、Node.js、npm 和 Grok Browser Bridge。容器启动时，scripts/entrypoint.sh 会先在 BRIDGE_PORT 上启动 services/browser_bridge/server.js，默认端口为 3080，并短暂探测 /health；即使 Bridge 未就绪，也会继续启动 FastAPI。

生产环境请立即修改默认密钥：

docker run -d \
  --name webchat2api \
  --restart unless-stopped \
  -p 83:83 \
  -v $(pwd)/data:/app/data \
  -e LOGIN_SECRET=your-strong-secret \
  webchat2api:latest

Docker Compose 部署

docker-compose.yml 使用本地镜像 webchat2api:latest。请先按上面的命令构建镜像，再启动服务。普通 Compose 文件仍是跨平台默认选择，即使没有显式 networks: 配置，Docker Compose 也会自动创建默认 bridge 网络：

如需在 bridge 网络中访问宿主机代理，请在 Compose 文件中同时取消 PROXY_URL 和 extra_hosts 注释。

docker compose up -d

如需通过 Compose 构建并启动，可使用本地构建配置：

docker compose -f docker-compose.local.yml up -d --build

常用命令：

docker logs -f webchat2api
docker restart webchat2api
docker compose down

Linux 服务器如果需要绕过 Docker 默认 bridge 网络，让容器直接使用宿主机网络，可改用独立的 docker-compose.host.yml。该文件使用 network_mode: host，只适用于 Linux Docker Engine，不适用于 Docker Desktop 的常规跨平台场景。它不是覆盖文件，不要和 docker-compose.yml 叠加使用。

Warning

host 网络模式会让服务直接暴露在宿主机网络的 83 端口，Docker ports 无法限制访问范围。启动前必须设置强随机 LOGIN_SECRET，并用宿主机防火墙、安全组或反向代理访问控制限制入口。

export LOGIN_SECRET=your-strong-random-secret
docker compose -f docker-compose.host.yml up -d
docker logs -f webchat2api
docker compose -f docker-compose.host.yml down

如需重新构建镜像后再启动：

docker build -t webchat2api:latest .
export LOGIN_SECRET=your-strong-random-secret
docker compose -f docker-compose.host.yml up -d

host 网络模式下没有 ports 映射，服务会直接监听宿主机的 83 端口。若宿主机代理监听在 loopback，可在 docker-compose.host.yml 中设置 PROXY_URL: http://127.0.0.1:7890。

本地开发

启动后端：

uv sync
LOGIN_SECRET=admin uv run python main.py

启动前端开发服务：

cd web
npm install
npm run dev

Grok Browser Bridge、防护与账号 tier

Grok Console 与 grok.com app-chat 是不同上游路径。本项目没有接入官方 xAI API，也不声称提供官方兼容能力。Console 路径可使用 network_profiles.grok_console.cf_clearance 附加手动 Cookie；app-chat 路径可使用 network_profiles.grok_app_chat 覆盖 UA、impersonate、cf_clearance、cf_cookies、sec-ch-ua、x-statsig-id 等字段。未提供手动 statsig_id 时，后端按 grok2api 的当前实现从 grok.com/index 提取 verification meta，再调用 statsig_signer_url（默认 https://grok.wodf.de/sign）生成按请求路径签名的 x-statsig-id，签名结果缓存一小时。

Grok 账号生命周期与状态优先级机制

系统实现了一套 Grok 账号生命周期状态优先级逻辑，用于应对偶发的 WAF 或探针波动：

• 真实业务调用优先（valid_by_call）：24 小时内若有成功的真实 Grok 业务调用（可通过 last_success_at 判断），其优先级高于后续 Cloudflare 质询或 403 探针（Probe）故障。在此期间，UI 呈现的账号状态会恢复或保持为“正常”，同时清空 state_reason、last_check_error、last_check_http_status 等临时故障标记（即 last_check_http_status 不再保留该被覆盖的 403 错误）。而调度和退避控制属性（例如 last_check_at、last_refresh_attempt_at 与 refresh_backoff_until）仍能记录和体现相应的探测与重试时间，用以控制底层的调度与间隔。
• 陈旧成功过期：当最后一次真实调用成功时间超出 24 小时（即 GROK_RECENT_SUCCESS_TTL_SECONDS 超期），陈旧的成功不再起覆盖作用。若探针再次遇到 Cloudflare 或 403，账号会转为未验证 unverified 并记录为 cloudflare_or_forbidden。
• 调度元数据与退避机制：无论状态优先级是否覆盖临时探测错误，最近探测时间与退避标记（例如 last_check_at、last_refresh_attempt_at、refresh_backoff_until）仍可写入账号元数据，用于控制后续刷新和重试间隔。

如配置 flaresolverr_url，直接 app-chat 请求遇到 Cloudflare 或 403 时会尝试通过 FlareSolverr 刷新 clearance 并重试。Browser Bridge 是独立浏览器路径；显式配置 browser_bridge_url 时，后端会优先使用该 Bridge。未配置时，app-chat 默认先走直接请求；直接请求遇到 408、502、503、504 时，才会尝试探测并回退到 http://127.0.0.1:3080/health 对应的 Browser Bridge。直接 app-chat 返回 403 会原样返回给调用方，不会自动回退到 Browser Bridge，也不会把账号标记为异常；401 会标记账号异常，429 会标记账号限流。Browser Bridge 的接口是 POST /api/chat {sso,payload} 和 GET /health，请求会经真实 Chromium 页面发往 grok.com。Docker 入口脚本会在 BRIDGE_PORT 上启动 services/browser_bridge/server.js，默认 3080；页面池可用 BRIDGE_MAX_PAGES 和 BRIDGE_PAGE_IDLE_MS 控制。Bridge 如果没有拿到 x-userid Cookie，会快速返回 sso_unavailable，避免继续使用未鉴权页面。

Warning

Cloudflare、WAF、账号风控和上游配额都可能变化。手动 clearance、FlareSolverr 和 Browser Bridge 都是尽力而为，不能保证长期可用。

Grok app-chat 模型会按所需账号层级选号：basic 可跑 lite 和 fast，super 可跑 auto、expert、图片标准和 pro，heavy 优先用于 heavy 模型。账号可额外设置 capabilities 缩小可用范围。grok-imagine-image 和 grok-imagine-image-pro 如果账号没有对应 tier、图片权限或剩余额度，可能返回 403 或 429，这通常是上游账号限制，不一定是 Cloudflare 或 WAF 问题。

API 示例

所有 AI 接口均使用 Bearer Token 鉴权：

Authorization: Bearer <LOGIN_SECRET 或用户 API Key>

OpenAI 兼容文本接口也接受 x-api-key: <LOGIN_SECRET 或用户 API Key>。当前包括 /v1/models、/v1/chat/completions、/v1/completions、/v1/complete、/v1/responses、/v1/messages，以及兼容别名 /openai/v1/models、/openai/v1/chat/completions、/claude/v1/messages。图片生成与图片编辑接口请继续使用 Bearer Token。

健康检查：

curl http://localhost:83/health

返回：

{"status":"ok"}

模型列表：

curl http://localhost:83/v1/models \
  -H "Authorization: Bearer admin"

/v1/models 按 ChatGPT 上游实现聚合匿名目录和各账号类型实际可用的 GPT 文本模型，不注入本地固定文本模型或档位别名。思考档位使用上游支持的 -standard、-extended、-max 通用模型后缀。GPT 图片模型包括 gpt-image-2、codex-gpt-image-2。Grok 当前使用内置模型列表，因为现有 Grok token/cookie 无法访问 console.x.ai 或 api.x.ai 的模型列表端点。Gemini 当前使用内置模型列表，包括 gemini-2.5-pro、gemini-2.5-flash、gemini-pro。Grok Console 文本模型包括 grok-4.3、grok-4、grok-4.20、grok-4.20-reasoning、grok-4.20-non-reasoning、grok-4.20-multi-agent；app-chat 文本模型包括 grok-4.20-0309 系列、grok-4.20-fast、grok-4.20-auto、grok-4.20-expert、grok-4.20-heavy、grok-4.3-beta；图片模型包括 grok-imagine-image-lite、grok-imagine-image、grok-imagine-image-pro、grok-imagine-image-edit，grok-imagine-video 仅声明为未支持的视频能力。Grok files 和 voice 仍未接入，请不要把上游网页能力理解为本项目已启用。

/v1/completions 是标准文本补全入口，/v1/complete 保留为兼容别名。两者都需要已配置可用账号；没有真实凭据时，不应把示例请求视为上游成功证明。

聊天接口：

curl http://localhost:83/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer admin" \
  -d '{
    "model": "auto",
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'

也可直接选择 Grok 或 Gemini 模型，接口会按模型分发到对应 provider 的账号：

curl http://localhost:83/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer admin" \
  -d '{
    "model": "grok-4.3",
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'

Grok 搜索来源会写入响应中的结构化 search_sources，并在 OpenAI 风格消息里转换为 url_citation annotations。流式响应会在最终 finish_reason=stop chunk 附带这些 metadata。show_search_sources 默认关闭；开启后，非流式文本末尾会追加 Markdown Sources 列表，便于不读取 annotations 的客户端显示来源。

GPT 图片生成接口：

curl http://localhost:83/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer admin" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只漂浮在太空里的猫",
    "n": 1,
    "response_format": "b64_json"
  }'

Grok 图片生成接口，经 grok.com app-chat 路径。grok-imagine-image-lite 通常需要 basic 及以上账号，grok-imagine-image 和 grok-imagine-image-pro 通常需要 super 及以上账号，并受上游图片配额限制：

curl http://localhost:83/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer admin" \
  -d '{
    "model": "grok-imagine-image-lite",
    "prompt": "一只漂浮在太空里的猫",
    "n": 1,
    "response_format": "b64_json"
  }'

当前 GPT 图片模型包括 gpt-image-2 和 codex-gpt-image-2，图片生成/编辑仍使用 GPT 服务商账号。GPT 图片编辑接受 JSON 或表单中的图片输入，可传 URL、data URI 或上传文件，支持多参考图；当前不支持 file_id。每张参考图上限为 50MiB。当前 Grok app-chat 图片生成支持 grok-imagine-image-lite、grok-imagine-image、grok-imagine-image-pro；Grok 图片编辑支持 grok-imagine-image-edit，限制为 size=1024x1024、最多 7 张参考图、n<=2。grok-imagine-video 暂未支持，Grok files 和 voice 也未接入，请不要把它们当成可用的视频、文件或语音接口。

账号导入说明：

导入 GPT 账号时使用 provider=gpt 或保持默认；导入 Grok 账号 token/cookie 时使用 provider=grok；导入 Gemini cookie/session 时使用 provider=gemini，并确保包含 __Secure-1PSID。provider 负责选择服务商，type 仍用于记录 plan、subscription 等套餐或订阅类型。

远程账号注入面向管理员使用，适合把外部账号源同步到本项目账号池。常用接口包括：

• GET /api/remote-account/sources 查看已配置来源
• POST /api/remote-account/sources 新增来源
• POST /api/remote-account/sources/{source_id}/sync 手动同步来源
• POST /api/remote-account/inject 直接注入 payload、accounts 或 tokens

远程来源支持 merge 和 replace。replace 只替换同一 source_id 下的远程账号，不会清空其他来源或本地账号。来源配置响应会隐藏 auth_token 和 bearer_token，同步失败只返回通用错误，避免泄漏上游地址中的敏感细节。本项目参考了 grok2api 管理端注入和 upsert 思路，远程来源抓取层由本项目自行实现。

请求和响应示例见 远程账号注入 API 示例。

账号导出接口：

curl http://localhost:83/api/accounts/export \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer admin" \
  -d '{
    "provider": "gpt",
    "access_tokens": []
  }'

provider 可选 gpt、grok 或 gemini，用于分别导出对应 TXT 文件；GPT 下载文件名固定为 webchat2api-gpt.txt，Grok 下载文件名固定为 webchat2api_grok.txt，Gemini 下载文件名固定为 webchat2api_gemini.txt。access_tokens 为空数组时导出该服务商全部账号；内容仅包含凭据本身，每个账号一行，优先使用清理后的 access_token，缺失 access_token 时使用清理后的 sso 或 Gemini cookie/session。

配置

核心配置见 .env.example、config.example.json 和 技术指南。如需本地覆盖配置，请复制示例文件：

cp config.example.json config.json

config.json 是本地运行配置，可能包含代理、备份密钥或其他敏感值，不应提交。后端会写入 config.json 保存 Web UI 设置，部署时如果把该文件只读挂载，管理后台的设置保存会失败。data/ 保存账号、用户密钥、日志、图片任务等运行数据，必须保持本地忽略，永远不要提交到代码仓库。

配置项	默认值	说明
PORT	83	服务监听端口
HOST	0.0.0.0	服务监听地址
LOGIN_SECRET	admin	管理后台默认登录密钥
WEBCHAT2API_AUTH_KEY	空	兼容旧配置的登录密钥覆盖项
WEBCHAT2API_BASE_URL	空	生成图片访问 URL 时使用的外部基础地址
PROXY_URL	空	上游请求使用的 HTTP/HTTPS/SOCKS 代理
auth-key	admin	config.json 中的管理端登录密钥，会被环境变量覆盖
refresh_account_interval_minute	60	限流账号后台检查间隔
image_retention_days	15	本地图片保留天数
image_poll_timeout_secs	120	图片任务轮询超时时间
auto_remove_rate_limited_accounts	false	是否自动移除限流账号
auto_remove_invalid_accounts	true	是否自动移除失效账号
show_search_sources	false	是否在非流式文本末尾追加 Markdown Sources 来源列表；结构化 search_sources 和 url_citation annotations 不依赖该开关
log_levels	debug、error、info、warning	日志级别过滤配置
sensitive_words	[]	本地敏感词，命中后直接拦截文本请求
global_system_prompt	空	全局系统提示词
ai_review	默认关闭	OpenAI 兼容文本审核配置，fail_open 未配置时默认放行
backup	默认关闭	Cloudflare R2 备份配置，支持定时、手动、轮换和可选加密
image_account_concurrency	3	图片账号并发数量
network_profiles	见 config.example.json	ChatGPT Web、Grok Console 和 Grok app-chat 网络 profile
network_profiles.grok_console.cf_clearance	空	Grok Console 请求附加的 Cloudflare cf_clearance Cookie
network_profiles.grok_app_chat	空	Grok app-chat 请求 profile，可配置 user-agent、impersonate、timeout、cf_clearance、cf_cookies、sec-ch-ua、x-statsig-id 等字段
network_profiles.grok_app_chat.statsig_signer_url	https://grok.wodf.de/sign	未配置合法手动 statsig_id 时使用的 Grok Statsig 签名服务；公网地址须为 HTTPS:443，容器内网地址可用 HTTP/HTTPS
chatgpt_fingerprint	见 config.example.json	ChatGPT Web 请求指纹，可配置 UA、impersonate 和 sec-ch-ua 等字段
grok_console_fingerprint	空	旧版 Grok Console 指纹配置，仍兼容；同名字段会被 network_profiles.grok_console 覆盖
enable_turnstile_solver	true	ChatGPT Turnstile 要求出现时尝试求解，不保证所有真实挑战都能通过
flaresolverr_url	空	FlareSolverr 服务地址，配置后可为 Grok app-chat 尝试刷新 Cloudflare clearance
flaresolverr_timeout_sec	60	FlareSolverr 单次求解超时时间，单位秒
browser_bridge_url	空	Grok Browser Bridge 地址；留空时后端在直接 app-chat 请求遇到可回退错误后探测 http://127.0.0.1:3080
BRIDGE_PORT	3080	Docker 入口脚本启动 Browser Bridge 使用的端口
BRIDGE_MAX_PAGES	10	Browser Bridge 页面池最大页面数
BRIDGE_PAGE_IDLE_MS	300000	Browser Bridge 空闲页面回收时间，单位毫秒
STORAGE_BACKEND	json	存储后端：json、sqlite、postgres、git
DATABASE_URL	空	SQLite/PostgreSQL 连接字符串
GIT_REPO_URL	空	Git 存储后端仓库地址
GIT_TOKEN	空	Git 存储后端访问令牌
GIT_BRANCH	main	Git 存储后端分支
GIT_FILE_PATH	accounts.json	Git 存储后端账号文件路径
GIT_AUTH_KEYS_FILE_PATH	auth_keys.json	Git 存储后端用户密钥文件路径，.env.example 当前未列出，可按需设置

测试与检查

后端单元测试：

python3 -m unittest discover -s test -t .

Important

-t . 用于指定项目根目录，避免 test/utils.py 遮蔽项目内的 utils 包。

前端类型检查和构建：

cd web
npm run typecheck
npm run build

存储后端检查脚本：

python scripts/test_storage.py

Browser Bridge 可选健康语义测试位于 services/browser_bridge/test_health.js，需要 Node 环境。

文档

完整技术指南见：docs/technical-guide.md。

功能状态见：docs/feature-status.md。

上游 SSE 会话协议参考见：docs/upstream-sse-conversation.md。

社区支持

欢迎在 linux.do 社区交流反馈。

致谢

感谢 https://github.com/chenyme/grok2api 和 https://github.com/basketikun/chatgpt2api