grokcli-2api

把 Grok OIDC 登录态 转成 OpenAI / Anthropic 兼容 API，并附带 Web 管理台：多 API Key、多账号轮询、设备码 / SSO / JSON 导入导出、协议注册。

当前版本：v1.9.67 · 上游模型入库 · 续期失败硬删除 · 断联防抖

镜像（全小写）	说明
`ghcr.io/hm2899/grokcli-2api:1.9.67`	当前版本
`ghcr.io/hm2899/grokcli-2api:latest`	最近 `v*` tag
`ghcr.io/hm2899/grokcli-2api:edge`	`main` 最新

独立运行：不依赖本地 Grok CLI / 浏览器 OAuth
Hybrid 存储（默认强制）：PostgreSQL 持久 + Redis 热状态 + 多 Worker
协议注册：内置 grok-build-auth（纯 HTTP，无需 Chromium）
中继友好：兼容 new-api / sub2api / Claude Code 工具流
大账号池：Token 自动续期、模型健康探测、冷却状态落库
会话粘性：prompt_cache_key / previous_response_id 固定同一账号，利于多轮缓存
任务可观测：后台任务写入「任务日志」；SSO / JSON 导入导出带实时进度

架构

客户端 (OpenAI / Anthropic SDK · new-api · Claude Code / sub2api)
        │  /v1/chat/completions  ·  /v1/responses  ·  /v1/messages
        ▼
  grokcli-2api  (FastAPI · multi-worker · TZ=Asia/Shanghai)
        │  管理台 /admin
        │  账号轮询 · 失败切换 · Prompt Cache 会话粘性
        │  任务日志（注册 / SSO / JSON / 测活 / 续期）
        │  PostgreSQL（账号 / Key / 设置 / 冷却 / 任务日志）—— 容器内网
        │  Redis（粘性 / 计数 / 锁 / 会话 / 任务进度）—— 容器内网
        ▼
  cli-chat-proxy.grok.com

data/*.json 仅作旧版迁移源与管理台导入导出，运行时权威数据在 PostgreSQL / Redis，不再写本地 JSON 镜像。

功能一览

功能	说明
OpenAI 兼容	`/v1/models` · `/v1/chat/completions` · `/v1/responses` · SSE
Anthropic 兼容	`/v1/messages` · tools / tool_use · `count_tokens`
管理台	账号、Key、协议注册、测活、续期、任务日志、用量、设置
多账号轮询	`round_robin` / `least_used` / `random`；可选出站代理池（聊天/测活/续期）
会话粘性	`prompt_cache_key`（body/header）与 Responses `previous_response_id` 粘同一账号
冷却状态	free-usage 等写入 DB；到期/测活成功 → 正常；billing 恢复可自动解禁
Token 续期	后台 leader 维护；支持单选/多选立即续期
模型探测	单账号 / 多选批量 / 全量；大池优先扫冷却/未知号
协议注册	MoeMail / YYDS / GPTMail / CF Temp Email + 内联过盾 / YesCaptcha；代理池；入池后延迟测活
SSO / JSON	后台任务 + 实时进度；JSON 支持多文件导入 / 选中导出
任务日志	注册、SSO、JSON、测活、续期等结果落 PG
用量统计	代理侧 token / 请求：今日·近 N 天·累计；按 Key / 账号 / 模型
容器时区	默认 `TZ=Asia/Shanghai`（日志与本地时间）

快速开始

方式 A：Docker Compose（推荐）

git clone https://github.com/HM2899/grokcli-2api.git
cd grokcli-2api
cp .env.example .env
# 编辑 .env：至少改 GROK2API_ADMIN_PASSWORD；生产请改 Postgres 密码

docker compose up -d --build
curl -fsS http://127.0.0.1:3000/health

浏览器打开：http://127.0.0.1:3000/admin

启动时指定打码线程数

主容器内联过盾线程数由 TURNSTILE_THREAD 控制（默认与注册并发一致，当前默认 3）：

# compose 启动时直接传参
TURNSTILE_THREAD=3 GROK2API_REG_CONCURRENCY=3 docker compose up -d --build

# 或写入 .env
# GROK2API_CAPTCHA_PROVIDER=local
# GROK2API_INLINE_SOLVER=1
# GROK2API_REG_CONCURRENCY=3
# TURNSTILE_THREAD=3

变量	默认	说明
`GROK2API_CAPTCHA_PROVIDER`	`local`	`local`（容器内联）/ `yescaptcha`
`GROK2API_INLINE_SOLVER`	`1`	`1` 时入口脚本在主容器内启动过盾
`GROK2API_REG_CONCURRENCY`	`3`	协议注册默认并发
`TURNSTILE_THREAD`	`= REG_CONCURRENCY`	本地过盾浏览器线程数
`TURNSTILE_BROWSER_TYPE`	`camoufox`	过盾浏览器类型
`TURNSTILE_PORT`	`5072`	内联过盾监听端口（容器内 loopback）

2 核小机器建议 TURNSTILE_THREAD=1~2；3 已较重，5 容易把 CPU/内存打满。

默认只映射应用端口 3000（内联部署）。
栈内 PostgreSQL / Redis / 本地过盾 都不绑定宿主机端口：

服务	容器内地址	是否映射到宿主机
app	`0.0.0.0:3000`	是 → `127.0.0.1:3000`
postgres	`postgres:5432`	否（compose 内网）
redis	`redis:6379`	否（compose 内网）
本地过盾	`127.0.0.1:5072`	否（主容器 loopback 内联）

因此 compose 里应用环境变量应使用服务名，而不是 127.0.0.1：

REDIS_URL=redis://redis:6379/0
DATABASE_URL=postgresql://grok2api:grok2api@postgres:5432/grok2api

.env.example 中的 127.0.0.1 仅适用于「本机直接跑 Python、自己起 DB」的场景。
docker compose 启动时会用 docker-compose.yml 中的服务名覆盖，无需改成宿主机端口。

若你确实需要从宿主机连库调试，可在本地 docker-compose.override.yml 临时加 ports（该文件已 gitignore，勿提交）。

方式 B：GHCR 镜像（注意小写）

Docker / GHCR 镜像名必须全小写。仓库 owner 可能是 HM2899，但拉取时要用：

ghcr.io/hm2899/grokcli-2api

错误示例（会拉失败）： ghcr.io/HM2899/grokcli-2api
正确示例：

docker pull ghcr.io/hm2899/grokcli-2api:1.9.67
# 或
docker pull ghcr.io/hm2899/grokcli-2api:latest

最小 compose 示例（内联 redis + postgres，不要给 DB 映射宿主机端口）：

services:
  redis:
    image: redis:7-alpine
    # 不要 ports —— 仅容器网络内访问
    environment:
      TZ: Asia/Shanghai
    command: ["redis-server", "--save", "", "--appendonly", "no"]
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 5s
      timeout: 3s
      retries: 10

  postgres:
    image: postgres:16-alpine
    environment:
      TZ: Asia/Shanghai
      PGTZ: Asia/Shanghai
      POSTGRES_USER: grok2api
      POSTGRES_PASSWORD: change-me
      POSTGRES_DB: grok2api
    volumes:
      - grok2api_pg:/var/lib/postgresql/data
    # 不要 ports —— 仅容器网络内访问
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U grok2api -d grok2api"]
      interval: 5s
      timeout: 5s
      retries: 10

  grokcli-2api:
    image: ghcr.io/hm2899/grokcli-2api:1.9.67
    ports:
      # 只映射应用；不要给 postgres/redis 加 ports
      - "3000:3000"
    environment:
      TZ: Asia/Shanghai
      GROK2API_HOST: "0.0.0.0"
      GROK2API_PORT: "3000"
      GROK2API_ADMIN_PASSWORD: "change-me"
      GROK2API_STORE_BACKEND: "hybrid"
      GROK2API_REQUIRE_SHARED_STORES: "1"
      GROK2API_WORKERS: "4"
      # 内联本地过盾（主容器 loopback，无需对外端口）
      GROK2API_CAPTCHA_PROVIDER: "local"
      GROK2API_INLINE_SOLVER: "1"
      REDIS_URL: "redis://redis:6379/0"
      DATABASE_URL: "postgresql://grok2api:change-me@postgres:5432/grok2api"
    volumes:
      - ./data:/app/data
    depends_on:
      redis:
        condition: service_healthy
      postgres:
        condition: service_healthy

volumes:
  grok2api_pg:

若包为 private，需先登录：

echo "$GITHUB_TOKEN" | docker login ghcr.io -u YOUR_GITHUB_USERNAME --password-stdin

必要环境变量

变量	说明
`GROK2API_ADMIN_PASSWORD`	管理台密码首次种子（无库内哈希时导入；之后以数据库为准）
`GROK2API_STORE_BACKEND=hybrid`	生产模式
`GROK2API_REQUIRE_SHARED_STORES=1`	Redis/PG 不可用则拒绝启动
`REDIS_URL`	Compose 内：`redis://redis:6379/0`
`DATABASE_URL`	Compose 内：`postgresql://…@postgres:5432/…`
`GROK2API_WORKERS`	建议 ≥2（按 CPU）
`TZ`	容器时区，默认 `Asia/Shanghai`
`GROK2API_RELOAD`	开发热更新：`1` 开启（强制单 worker）；生产保持 `0`

完整模板见 .env.example。生产请修改默认数据库密码。

会话粘性（Prompt Cache）

多轮请求尽量固定同一 Grok 账号，避免池轮转打断缓存局部性。管理台「会话粘性」默认开启。

上游（Grok / cli-chat-proxy）的 prompt cache 是 自动 prefix cache：同一账号 + 相同 messages/tools 前缀 → usage 里出现 prompt_tokens_details.cached_tokens。本项目对齐 superagent-ai/grok-cli 的做法，主动创造命中条件：

粘账号（affinity：prompt_cache_key / conversation / response 链）
出站前缀稳定（tools schema 规范化 + name 排序；messages 字段/参数 JSON 规范化；system 文本形态统一）
历史压缩前缀稳定（HISTORY_PREFIX_STABLE：旧 tool 结果确定性 placeholder，不反复改写）
可观测（响应字段 / header 回传 cache 命中量）

客户端提示	行为
`prompt_cache_key`（body 或 `x-prompt-cache-key` header）	作为稳定指纹；不再拼接 conversation root
Anthropic `cache_control` / metadata 缓存键	映射为粘性 key
Responses `previous_response_id`	用上轮发出的 `response_id` 找回账号（不再误当 conversation_id）
显式 `conversation_id` / 相关 header	最高优先

成功响应可观察：

字段 / Header	含义
`X-Grok2API-Affinity: 1` / `x_grok2api_affinity`	本轮命中会话粘性
`X-Grok2API-Affinity-Source` / `x_grok2api_affinity_source`	粘性来源：`previous_response_id` / `prompt_cache_key` / `conversation_id` / `root` 等
`x_grok2api_account`	实际使用的账号（跨轮应一致）
`x_grok2api_cache_read_tokens` / `X-Grok2API-Cache-Read-Tokens`	上游返回的 cache 读 token
`x_grok2api_cache_hit_ratio` / `X-Grok2API-Cache-Hit-Ratio`	`cached / prompt`（0–1）
`usage.prompt_tokens_details.cached_tokens`	标准 usage 字段（OpenAI 兼容）
`X-Grok2API-Prompt-Stable: 1`	本轮已做 tools/messages 出站稳定化

管理台用量页会汇总：

token 命中率 = Σ cache_read_tokens / Σ prompt_tokens
请求命中率 = 成功且 cache_read_tokens > 0 的请求占比
数据来自 usage_events（不是日汇总表），今日 / 近 N 天 / 累计三档。

历史压缩（GROK2API_HISTORY_COMPACT=1）开启时，默认 GROK2API_HISTORY_PREFIX_STABLE=1：旧 tool 结果用 确定性 placeholder（含内容 hash），后续轮次不再反复改写已压缩前缀，避免打断 prefix cache。

客户端配合（提高命中率）：

始终传稳定的 prompt_cache_key（或 Anthropic metadata / x-prompt-cache-key）
不要每轮改 system / tools schema
多轮用同一 API Key；观察 X-Grok2API-Affinity: 1 且账号字段跨轮不变
第二轮起看 cached_tokens > 0；若 affinity=1 仍为 0，则是上游未回 cache，不是粘性失败

本地开发热更新

生产默认 reload=False + 多 worker。改代码后要自动重启：

# 仅起 Redis/Postgres（若尚未运行）
docker compose up -d postgres redis

# 宿主机 Python 热更新（监听 .py / static/js / static/admin）
./dev.sh
# 或
GROK2API_RELOAD=1 GROK2API_WORKERS=1 python app.py

说明：

GROK2API_RELOAD=1 时强制 1 worker（uvicorn 限制）
默认忽略 data/、static/dist/、__pycache__/，避免写库/打包触发无意义重启
管理台 static/js 源文件变更会触发进程重启；带 hash 的 static/dist 仍建议跑 python scripts/build_admin_assets.py
Docker 镜像内一般不挂源码，热更新请用宿主机 ./dev.sh，或 bind-mount 代码后再设 GROK2API_RELOAD=1

从旧版（JSON 文件）升级

详见 docs/UPGRADE.md。

# 备份 data/ 后
chmod +x scripts/upgrade_from_file_backend.sh
./scripts/upgrade_from_file_backend.sh --data-dir ./data

# 或
docker compose up -d redis postgres
docker compose run --rm \
  -e DATABASE_URL=postgresql://grok2api:grok2api@postgres:5432/grok2api \
  grokcli-2api \
  python migrate_json_to_pg.py --data-dir /app/data --merge-pool

迁移内容：auth.json / keys.json / settings.json（含账号池状态）→ PostgreSQL。
不迁移：Redis 热状态、管理台登录会话。

已是 hybrid 时，拉新镜像即可；表结构由 store/pg.py 启动时幂等升级。

客户端接入

OpenAI 兼容

export OPENAI_BASE_URL=http://127.0.0.1:3000/v1
export OPENAI_API_KEY=你的管理台API_Key

curl "$OPENAI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-4.5","messages":[{"role":"user","content":"hi"}]}'

Anthropic 兼容

curl http://127.0.0.1:3000/v1/messages \
  -H "x-api-key: 你的管理台API_Key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-4.5","max_tokens":256,"messages":[{"role":"user","content":"hi"}]}'

Claude Code / Cursor / Cherry Studio：Base URL 填服务地址（通常带 /v1），Key 用管理台创建的 API Key。

管理台

页面	用途
概览	池规模、续期/探测状态、今日用量
账号 / 轮询	设备码、SSO 导入（进度）、JSON 导入/导出（进度）、协议注册、测活、续期
API Keys	客户端密钥
用量	Token / 请求：今日·近 N 天·累计；Key / 账号 / 模型；请求明细
任务日志	协议注册、SSO、JSON 导入导出、测活、Token 续期等后台任务结果
设置	轮询与冷却策略、协议注册默认项等

账号导入 / 导出

方式	说明
SSO Cookie	粘贴或上传；后台 Device Flow 换 token，页面显示进度条与明细
JSON 文件	支持多文件合并导入；解析 → 入库全程进度
导出全部 / 选中	后台打包，完成后自动下载；大池不阻塞页面

导入导出、测活、续期等完成后，可在 任务日志 按类型 / 状态 / 关键词查询历史结果。

协议注册

依赖 临时邮箱 + 过盾（环境变量或管理台配置，存 PG）：

邮箱：MoeMail / YYDS Mail（vip.215.im）/ GPTMail（mail.chatgpt.org.uk）
过盾：本地内联 Turnstile Solver 或 YesCaptcha

本地过盾默认与主容器同进程（127.0.0.1:5072），无需填写 URL；选 YesCaptcha 时仅用云端 Key。
邮箱有效期：MoeMail 支持 1 小时 / 1 天 / 3 天 / 永久；YYDS / GPTMail 临时邮箱约 24 小时。
新注册账号入池后默认 延迟 30s 再自动测活；可在管理台「测活等待秒」调整，或用环境变量 GROK2API_REG_PROBE_DELAY_SEC（0=立即测活）。

运维

curl -fsS http://127.0.0.1:3000/health
curl -fsS http://127.0.0.1:3000/metrics | head
docker compose logs -f grokcli-2api
# 时区
docker exec grokcli-2api sh -c 'echo TZ=$TZ; date'

仅 leader worker 跑 Token 续期与模型健康任务（Redis 选主）
备份重点：PostgreSQL 卷（grok2api_pg）；Redis 可丢
本地低停机重建：./docker-rebuild.sh
Postgres / Redis 默认不暴露宿主机端口
任务日志表 task_logs 在 hybrid 启动时幂等创建
默认时区 Asia/Shanghai（TZ / Dockerfile tzdata）

发布镜像（GHCR）

# 1) app.py 中 APP_VERSION 必须与 tag 一致（镜像路径全小写）
# 2) 推 main → edge + 版本号；推 v* tag → 额外 latest + GitHub Release
git add -A && git commit -m "release: v1.9.56"
git push origin main
git tag -a v1.9.56 -m "v1.9.56"
git push origin v1.9.56
gh release create v1.9.56 --generate-notes   # 或手写 notes
# 监视构建
gh run list --workflow=docker-publish.yml --limit 3

也可一键：./scripts/release_v1.9.56.sh

成功后拉取（必须小写）：

docker pull ghcr.io/hm2899/grokcli-2api:1.9.67
docker pull ghcr.io/hm2899/grokcli-2api:latest

CI 会把 github.repository 强制转成小写后再推送，避免 HM2899 大小写导致 docker pull 失败。

目录提示

app.py / admin_routes.py              # API 与管理路由
conversation_affinity.py              # 会话粘性 / prompt_cache_key / response 链
proxy_pool.py                         # 出站 / 注册代理池
task_log.py / store/task_logs_pg.py   # 任务日志
store/                                # Redis + PostgreSQL
migrate_json_to_pg.py                 # JSON → PG
scripts/build_admin_assets.py         # 管理台静态资源打包
scripts/release_v1.9.56.sh            # 本版本一键发布
docs/UPGRADE.md                       # 升级说明
static/                               # 管理台前端
grok-build-auth/                      # 协议注册引擎（vendored）
turnstile-solver/                     # 本地过盾（内联；懒加载 + 空闲回收）
docker-compose.yml                    # redis + postgres（内网）+ app
.github/workflows/docker-publish.yml  # GHCR 多架构（小写镜像名）

安全与免责

勿将 .env、data/、真实 Token 提交到 Git
生产务必修改 Postgres 密码与管理员密码
默认不映射 DB/Redis 端口；调试用本地 override，勿对公网暴露
导出 JSON 含完整 token，请妥善保管
协议注册与账号自动化请遵守 xAI 服务条款与当地法律；本项目仅供自用/研究集成

版本

v1.9.67（当前）
- 模型列表入库：GET /v1/models 只读 PostgreSQL models 表；管理台「同步上游模型」从 cli-chat-proxy 拉取并写入数据库（不再读写 models_cache.json）
- 启动时若表为空，自动灌入默认模型 + 本地 extras；migrate_json_to_pg.py 仍可一次性导入旧 models_cache.json
- 运行时不再写本地 JSON 镜像：hybrid 下账号 / Key / 设置只落 PostgreSQL；会话粘性只走 Redis；data/*.json 仅迁移与管理台导入导出
v1.9.66
- 续期永久失败硬删除：invalid_grant / refresh token revoked 默认直接踢出号池并删除账号（GROK2API_DELETE_INVALID_REFRESH=1）
- 启动与维护周期 purge 清掉已标记的 dead RT；设 =0 才回退 soft-disable
v1.9.65
- 断联防抖：is_disconnected 需连续命中（默认 2，GROK2API_DISCONNECT_HITS）才判定 client_gone，避免背压单次 blip 硬切
- stream_started 后置：仅在真正 yield 出站帧后锁定账号/禁止静默切号，假断联不再阻断 failover
- 继承 v1.9.64：软断开终态帧、工具参数别名/Update 合并、xhigh thinking
v1.9.64
- 偶发流中断修复：OpenAI / Anthropic / Responses 软断开不再硬切 SSE；is_disconnected 探活异常不再误判 client_gone
- 已开流时始终发出终态帧（finish/[DONE]、message_delta/message_stop、response.completed/failed），避免 sub2api/Claude Code 停调度
- 工具参数加固：Update 双 JSON 合并取更完整对象；path/oldString 等别名归一为 Claude Code schema；schema 不完整工具不刷出
- OpenAI chat 默认不限多工具（GROK2API_OUTBOUND_MAX_TOOLS_OPENAI=0）；Claude/sub2api 路径仍默认单工具
- xhigh thinking / budget_tokens 映射到 reasoning_effort=xhigh
v1.9.63
- 注册进度 404 停轮询：浏览器缓存的过期 batch_* / gba_* 在后端不存在时清理 track 并停止轮询，避免控制台刷 404
- 停止按钮对已消失 batch/session 做 not-found 降级
v1.9.62
- tool_choice 空 200 修复：sub2api/Claude Code 强制工具时的 {"type":"function","name":…} / nested function 形态映射为 "required"，避免 cli-chat-proxy 空 body 导致前端 empty envelope
- 覆盖 Anthropic tool/any tool_choice 变体
v1.9.61
- Responses 失败流修复：response.failed 前必发 response.created/in_progress；中途失败沿用单调 sequence_number（不再回绕到 0）
- 修复 Claude Code 将 bare/回绕的 failed SSE 误判为 empty or malformed response (HTTP 200)
v1.9.60
- 本地过盾就绪门闩：注册在本地过盾模式下等待 solver HTTP 就绪后再开跑
- Responses 协议修复：sequence_number 单调且 response.created 永远先发；response.completed 复用流中 item id（不再重新生成 msg_/fc_）
- 修复 Claude Code / sub2api 将乱序 SSE / id 不一致误判为 empty or malformed response (HTTP 200)
v1.9.58
- 工具参数必填键 hold：Responses 路径在 anthropic_compat 导入失败时仍按 Read.file_path / Bash.command 等本地规则 hold，避免半成品 tool 提前开 response.created 导致 Claude Code 报 empty/malformed HTTP 200
- 回归测试覆盖 local fallback + 网关拦截 body 分类
v1.9.57
- 空 200 流式切号：Anthropic message_start / Responses response.created 延后到真实模型输出后才开流，空 body / 网关拦截页可静默切号
- OpenAI chat 流仅在真正发出 content/tool 帧后才锁定账号（忽略不完整 tool 预览）
v1.9.56
- 本地部署默认时区与 prompt-cache 粘性加固后的版本号 bump
v1.9.55
- Prompt Cache 会话粘性：prompt_cache_key 单独指纹（不 fold root）；Responses response_id 链绑定 previous_response_id
- chat / messages / responses 统一 api_key_id 命名空间；流式/非流式均 bind
- 默认容器时区 Asia/Shanghai（Dockerfile + compose + .env.example）
- 合并待发布：额度冷却自动恢复、出站/注册代理池、大池测活优先扫、空 200 故障切换等（1.9.50–1.9.54）
v1.9.54：free-usage 冷却时间窗（15m→1h）到期回池；billing 恢复自动解禁
v1.9.53：空 200 / 网关拦截页可重试切号
v1.9.52：账号池出站代理池（聊天/测活/续期粘性选代理）
v1.9.51：协议注册代理池多行 + 策略 + 抽测
v1.9.50：大池测活优先扫冷却/未知；限流可复检
v1.9.49：注册任务日志 + 进度硬刷新恢复
v1.9.48：注册进度恢复；Turnstile 空闲回收加固
v1.9.47：Turnstile 懒加载 + 空闲回收；默认 workers=2
v1.9.46：Cloudflare Temp Email；续期软禁用；流式加固
v1.9.45–1.9.38：YYDS 域名、任务日志、JSON/SSO 进度、内联 hybrid 等
更早变更见 GitHub Releases

镜像 tag 与 app.py 中 APP_VERSION 一致（当前 1.9.67）。
拉取路径固定 ghcr.io/hm2899/grokcli-2api（全小写）。

License

见 LICENSE。

Name		Name	Last commit message	Last commit date
camoufox-ubo		camoufox-ubo
deploy		deploy
docs		docs
grok-build-auth		grok-build-auth
scripts		scripts
static		static
store		store
turnstile-solver		turnstile-solver
.dockerignore		.dockerignore
.env.example		.env.example
.gitignore		.gitignore
Dockerfile		Dockerfile
Dockerfile.vps		Dockerfile.vps
LICENSE		LICENSE
README.md		README.md
account_pool.py		account_pool.py
accounts.py		accounts.py
admin_routes.py		admin_routes.py
anthropic_compat.py		anthropic_compat.py
apikeys.py		apikeys.py
app.py		app.py
auth.py		auth.py
auth_store.py		auth_store.py
config.py		config.py
conversation_affinity.py		conversation_affinity.py
dev.sh		dev.sh
docker-compose.vps.yml		docker-compose.vps.yml
docker-compose.yml		docker-compose.yml
docker-rebuild.sh		docker-rebuild.sh
entrypoint.sh		entrypoint.sh
entrypoint.vps.sh		entrypoint.vps.sh
grok_build_adapter.py		grok_build_adapter.py
history_compact.py		history_compact.py
maintenance_gate.py		maintenance_gate.py
migrate_json_to_pg.py		migrate_json_to_pg.py
model_health.py		model_health.py
models.py		models.py
moemail.py		moemail.py
oidc_auth.py		oidc_auth.py
openai_responses.py		openai_responses.py
proxy_pool.py		proxy_pool.py
quota.py		quota.py
requirements-store.txt		requirements-store.txt
requirements.txt		requirements.txt
settings_store.py		settings_store.py
sso_to_auth_json.py		sso_to_auth_json.py
start.bat		start.bat
start.ps1		start.ps1
start.sh		start.sh
task_log.py		task_log.py
token_maintainer.py		token_maintainer.py
usage_stats.py		usage_stats.py

Navigation Menu

Repository files navigation

grokcli-2api

架构

功能一览

快速开始

方式 A：Docker Compose（推荐）

启动时指定打码线程数

方式 B：GHCR 镜像（注意小写）

必要环境变量

会话粘性（Prompt Cache）

本地开发热更新

从旧版（JSON 文件）升级

客户端接入

OpenAI 兼容

Anthropic 兼容

管理台

账号导入 / 导出

协议注册

运维

发布镜像（GHCR）

目录提示

安全与免责

版本

License

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

grokcli-2api

架构

功能一览

快速开始

方式 A：Docker Compose（推荐）

启动时指定打码线程数

方式 B：GHCR 镜像（注意小写）

必要环境变量

会话粘性（Prompt Cache）

本地开发热更新

从旧版（JSON 文件）升级

客户端接入

OpenAI 兼容

Anthropic 兼容

管理台

账号导入 / 导出

协议注册

运维

发布镜像（GHCR）

目录提示

安全与免责

版本

License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages