项目定位#
grok2api-enhanced 是对 Grok2API 服务的一次工程化增强。它把 API 调用、WebUI、出口代理和运行配置放进同一套管理界面，减少部署后只能靠改环境变量和重启服务排查问题的成本。
核心特点#
- API 与 WebUI 分别设置访问密钥，并支持 API IP 白名单与真实客户端 IP 请求头——调用方和管理方的暴露面不同，密钥分开发放，才能各自轮换、各自收权。
- Mihomo 面板展示当前节点，可执行延迟测试、刷新和出口切换。出口质量从「进容器查日志」变成界面上可见、可测、可换。
- 网络代理支持直连、固定代理与代理池，并可为媒体资源设置独立出口——API 请求和大流量媒体走不同链路，一条出口出问题不必整体切换。
- 配置中心集中管理系统参数、任务调度、缓存和 Cloudflare Clearance 获取方式。参数有界面、有说明，也就有了被检查的机会。
部署形态#
项目把核心 API/WebUI、WARP/Privoxy、Mihomo、私有访问层和可选 Cloudflare Tunnel 拆成可组合的 Docker Compose overlay。请求可以直连，也可以统一经过 Privoxy 或 Mihomo；Admin、WebUI、节点面板和控制 API 则建议放在私有访问层后面，不直接暴露到公网。
能力边界#
Masonry 生图的 Speed 模式针对普通账号池提供 lite fallback，单个槽位失败时只标记该槽位；Quality 模式仍要求相应的高级图像账号，并会明确提示能力不足。仓库只公开脱敏模板和示例配置，不包含真实账号、节点、域名、token、Cookie 或运行日志。
这是面向自托管和学习验证的增强版，不是相关平台的官方项目；使用者仍需自行遵守上游服务条款和所在地法律法规。
项目价值#
它把「能调用 API」推进到「能运营一个 API 服务」：入口、出口和访问控制同时可见，网络故障与权限问题可以在明确的配置面中定位。
这些能力单独看都不复杂，麻烦在于它们原本是分散的：密钥在环境变量里，代理在另一份配置文件里，节点状态要进容器才能查。收进同一套界面之后，「换一个出口节点」或「查一次访问被拒」不再需要 SSH 进服务器改文件重启。
界面#
