Grok 主控 (Master Controller)

统一管理 Grok 注册节点、grok2api、代理池、邮箱配置、账号分组的中央控制系统。

免责声明

本工具仅供研究和学习用途，严禁用于任何商业目的。

• 本注册 Grok 的工具严禁用于谋取利益，仅可自用或者公益开放。
• 如需销售其注册的账号，请联系作者获取商业授权。
• 使用本工具产生的一切后果由使用者自行承担，作者不承担任何责任。
• 本工具基于 AGPL V3 开源许可证发布，如您对其修改，需要开源完整代码。

功能特性

• grok2api Docker 管理 — 一键部署、升级、监控 grok2api 实例
• 节点管理 — 管理所有被控节点，查看节点状态与心跳
• 代理池统一管理 — 集中管理代理配置，统一下发至各节点
• 邮箱配置统一 — 集中管理邮箱配置，避免重复维护
• 账号分组与 API Key 出口 — 支持多账号分组，按组分配独立 API Key 出口
• API 代理（OpenAI 兼容） — 提供 OpenAI 兼容的 API 接口，透明代理请求
• 审计日志 — 记录所有操作日志，便于追踪与审计
• 错峰刷新额度 — 避免同时刷新导致封号
• 账户分级管理 — Super/Free/Remaining 三级额度分组
• 封号检测与自动清理 — 自动检测并移除封号/限额账户

快速开始

系统要求

• Python 3.8+
• Docker（用于运行 grok2api）
• 一台可以运行被控节点的服务器

安装步骤

# 1. 克隆仓库
git clone https://github.com/Cheerimy-Studio/Grok-Master-Controller.git
cd Grok-Master-Controller

# 2. 安装依赖
pip install -r requirements.txt

# 3. 启动服务
python app.py

服务将在 http://localhost:19505 启动。

首次登录

1. 访问 http://your-server-ip:19505
2. 首次启动会自动生成管理员密码，查看日志获取密码：

   # 查看生成的密码
   cat data/.admin_password

3. 登录后可在「设置」页面修改密码

配置 Grok2API

1. 在「Grok2API 管理」页面配置 Grok2API 地址和 API Key
2. 点击「测试连接」验证配置是否正确
3. 点击「启动」启动 Grok2API 服务

配置被控节点

1. 在「节点管理」页面添加新节点
2. 填写节点的 SSH 信息（IP、端口、用户名、密码）
3. 点击「一键安装」自动部署被控节点

配置

环境变量

变量名	说明	默认值
GROK2API_BASE	grok2api 服务地址	http://localhost:8000
GROK2API_API_KEY	grok2api API Key	自动生成
MASTER_PORT	主控服务端口	19505
POLL_INTERVAL	节点轮询间隔（秒）	30

配置文件

配置文件位于 data/ 目录下：

• .admin_password — 管理员密码
• .api_key — API Key
• .secret_key — Flask 密钥

API 端点概览

管理接口

方法	路径	说明
GET	/api/dashboard	仪表盘数据
GET	/api/nodes	获取所有节点列表
POST	/api/nodes	注册新节点
GET	/api/proxies	获取代理池配置
POST	/api/proxies	添加/更新代理
GET	/api/accounts	获取账户列表
POST	/api/accounts/assign-group	分配账户到分组
POST	/api/accounts/classify-tiers	自动分级账户
GET	/api/groups	获取账号分组
POST	/api/groups	创建/更新分组
GET	/api/audit	查询审计日志

Grok2API 管理

方法	路径	说明
GET	/api/grok2api/status	获取 Grok2API 状态
POST	/api/grok2api/start	启动 Grok2API
POST	/api/grok2api/stop	停止 Grok2API
POST	/api/grok2api/restart	重启 Grok2API
POST	/api/grok2api/refresh-quotas-staggered	错峰刷新额度
POST	/api/grok2api/classify-tiers	分类账户到分组
POST	/api/grok2api/remove-banned	删除封号账户
POST	/api/grok2api/remove-exhausted	删除限额账户

OpenAI 兼容 API

方法	路径	说明
GET	/v1/models	获取可用模型
POST	/v1/chat/completions	对话补全
POST	/v1/images/generations	图片生成

许可证

本项目基于 AGPL V3 许可证开源。

相关项目

• Grok 被控 (Accused Controller) — 被控节点程序