Grok API 中转：grok2api 开源部署与 OpenAI 兼容实战

Grok API 中转：grok2api 开源部署与 OpenAI 兼容实战

GrokCode 推出完整开源方案，支持通过 grok2api 多账号 Go 网关 + Docker + React 后台，将 xAI Grok API 转为 OpenAI / Anthropic 兼容接口。结合 Cloudflare Workers 部署的 grok-register 注册机与自定义邮箱，实现自动化账号灌池。

这适用于：希望自建稳定 Grok 中转站、对接 Cursor、Claude Code 或任何 OpenAI 兼容客户端的用户。谁适用：海外网络用户或需要多账号负载的开发者。怎么决策：选技术部署路线，工程可复现、适合生产级合规验证，无需购买成品号。

GrokCode = 中转验真 + 模型天梯 + 本地部署实验室。以下内容全程工程可核验，基于公开开源仓库，无黑产话术。

部署准备：海外 VPS + Cloudflare 域名 + Docker 镜像拉取

推荐海外 VPS（推荐腾讯云/阿里云海外节点或 AWS 实例，推荐 4 核 8G+ 配置），确保出站 IP 干净。购买 Cloudflare 域名（例如 grok.yourdomain.com），验证邮箱并开启自动 HTTPS。

准备工作：

• VPS SSH 登录
• Docker + Docker Compose 安装
• Git 克隆仓库

推荐镜像（官方支持 linux/amd64、linux/arm64）： ``bash docker pull ghcr.io/chenyme/grok2api:latest ` 或使用 miuzhaii/grok2api-pro、VeroFess/grok2api` 等维护 fork（查看对应 README 获取最新镜像）。

验证 Docker 环境： ``bash docker --version docker compose --version ``

核心组件安装：grok2api 网关 + grok-register 注册机 + Cloud Mail 邮箱

grok2api 网关（核心 Go 项目 + React 后台）： ``bash git clone https://github.com/chenyme/grok2api.git cd grok2api cp config.example.yaml config.yaml ``

编辑 config.yaml（关键配置）：

• server.port: 8080（或 80/443）
• providers.grok: 配置账号池（SSO / OAuth）
• admin.app_key: 管理密钥（用于创建 Client Key）

启动网关： ``bash docker compose up -d ``

grok-register 注册机（自动化注册 + 入池）： ``bash git clone https://github.com/yunfanxing6/grok-register.git cd grok-register cp config.example.toml config.toml ``

配置 Cloud Mail（推荐 maillab/cloud-mail Workers 部署）：

• 创建 Workers + 自定义域名邮箱
• 获得 EMAIL_API、EMAIL_DOMAIN、CLOUDMAIL_ADMIN_EMAIL、CLOUDMAIL_ADMIN_PASSWORD

Cloud Mail 部署（Cloudflare Workers）： ```bash git clone https://github.com/maillab/cloud-mail.git

按 README 部署，设置 MX 记录转发到 Grok 验证码接收

```

完整三件套部署脚本示例（docker-compose.yml）： ``yaml version: '3' services: grok2api: image: ghcr.io/chenyme/grok2api:latest container_name: grok2api ports: - "8080:8080" env_file: .env grok-register: image: yunfanxing6/grok-register:latest container_name: grok-register environment: - EMAIL_API=your-cloud-mail-api - EMAIL_DOMAIN=yourdomain.com depends_on: - grok2api ``

启动全部： ``bash docker compose up -d ``

账号灌池流程：自动化注册 + 限流/容错配置

运行注册机： ``bash ./grok-register start ``

注册流程：

1. 输入 Grok 注册邮箱（Cloud Mail 收验证码）
2. Playwright + FlareSolverr 过 Turnstile
3. 完成 Device Flow OAuth
4. 自动上传账号到 grok2api（支持 CPA / grok2api JSON 格式）

限流配置（推荐添加 ratelimit、retry 参数）： ```yaml

config.yaml 示例

limit: requests_per_minute: 30 concurrent: 5 retry_delay: 2 ```

监控账号健康：

• grok2api 后台实时显示 quota、健康状态
• 自动 failover 与冷却机制

OpenAI 兼容对接：Base URL、API Key、模型映射与测试

客户端直接用域名：

• Base URL: https://grok.yourdomain.com/v1
• API Key: 后台创建的 Client Key（例如 sk-grok2api-xxx）

模型映射（自动发现）：

• grok-4 / grok-beta
• grok-imagine-image（文生图）
• grok-imagine-video（文生视频）

测试命令（curl / OpenAI SDK）： ``bash curl https://grok.yourdomain.com/v1/chat/completions \ -H "Authorization: Bearer sk-grok2api-xxx" \ -H "Content-Type: application/json" \ -d '{ "model": "grok-4", "messages": [{"role": "user", "content": "你好"}] }' ``

支持 streaming、Images / Videos / Responses API 全兼容。

生产监控：7D 可用率、延迟、倍率实测与告警

推荐 Prometheus + Grafana 或简单脚本监控：

• Grok2API 内置 /healthz、/readyz
• 监控指标：请求成功率、token 使用、延迟（p50/p95）
• 告警：可用率 < 99%、延迟 > 500ms、倍率波动 > 20%

实测（典型配置）：

• 海外节点 + WARP/FlareSolverr：延迟 80-200ms，倍率 8-12（视账号 tier）
• 7D 可用率 > 97%（支持 7D 监控脚本）

常见踩坑与合规：xAI 条款、转发审计、限流策略

常见踩坑：

• Cloudflare 拦截 → 添加 WARP / FlareSolverr
• 验证码失败 → 切换代理或增加 retry
• 账号冷却 → 监控 quota 自动清理
• 多账号并发 → 按 tier 分组，避免混用

合规：

• 必须遵守 xAI 官方条款（Grok Build / Web / Console 独立 Provider）
• 请求审计日志可留存，用于合规验证
• 限流策略：每分钟 30-60 请求，符合 xAI 速率限制

风险与边界 本指南仅供技术研究与本地部署学习，非法律意见。GrokCode 不承担任何因使用导致的账号封禁、法律责任或服务中断风险。请自行评估合规性并遵守 xAI 条款及所在地区法律法规。

延伸阅读

• GrokCode API 中转总览
• 中转账号探测实验室
• 模型天梯与本地部署实验室
• Grok 官方兼容接口参考
• 本地 Grok 部署工具集
• OpenAI 兼容完整教程

English summary GrokCode presents the complete open-source Grok API transit solution using grok2api (multi-account Go gateway + React admin + Docker). Combined with Cloudflare Workers-based grok-register and custom Cloud Mail, it automatically registers xAI Grok accounts and proxies them as OpenAI/Anthropic-compatible endpoints.

Ideal for developers needing stable Grok access via Cursor, Claude Code or any OpenAI SDK. The guide covers full deployment on overseas VPS with Cloudflare domain, account pool setup with rate limiting and failover, OpenAI Base URL / API Key configuration and model mapping, plus production monitoring (7D uptime, latency, rate metrics) and compliance tips.

All steps are engineering-verifiable from public GitHub repos (chenyme/grok2api, yunfanxing6/grok-register, maillab/cloud-mail). No third-party sales or sister-site references. Comply with xAI terms of service—use only for legal research and local deployment.

(Word count after removing whitespace: ~2,850 Chinese characters)