← 返回项目库

CCX AI API 统一代理网关｜本地预览

面向多上游 AI 服务的统一代理与渠道编排控制台。

提供渠道配置、故障转移、模型能力测试、指标观察和对话调试等 Web 管理能力；本次发布以本地演示数据完成可验证预览，未接入外部服务。

真实界面

项目截图

共 6 张

渠道编排
渠道编排
渠道编排
渠道编排
渠道编排
驾驶舱

Capabilities

核心功能

✓多协议 AI API 统一代理
✓Messages、Responses、Chat、Gemini 与图像渠道管理
✓多渠道优先级与故障转移编排
✓API 密钥与渠道状态管理
✓模型能力测试与请求指标观察
✓对话驾驶舱与本地预览数据验证

适用场景

统一接入多个 AI 服务并切换上游
为团队提供可视化渠道运维控制台
在本地演示协议代理和故障转移流程

适合谁

需要统一管理多个 AI API 上游、协议转换和渠道故障转移的开发者与小型团队。

商业化思路

开源软件部署、运维与定制服务；商业使用、再分发和二次修改需遵循上游 MIT 许可证及版权声明。

你会拿到什么

  • ✓经过门禁验证的中文源码包
  • ✓Go 后端、Vue 前端与 LICENSE
  • ✓构建、健康检查和 UI 截图审计证据

部署流程

  1. 1在服务器准备 Go 运行环境并配置 PROXY_ACCESS_KEY 与 ADMIN_ACCESS_KEY
  2. 2执行 make build 构建前端并编译 backend-go/dist/ccx-go
  3. 3配置上游渠道后运行 ccx-go --config PATH --statedir DIR --logdir none
  4. 4通过 /health 和管理界面检查服务状态

真实验证结果

已通过 Go 后端健康检查、前端生产构建、前端 10 个测试文件 172 项测试、截图语义门禁和本地 API 读回验证。

部署前须知

本地预览使用隔离的演示渠道数据，未验证任何真实外部上游；桌面端未作为本次 Web 发布入口。

部署难度

中等

最低配置

建议 1 vCPU、1 GB 内存；需要 Go 构建环境或直接运行已构建的 ccx-go；外部上游 API 需由部署者自行配置。

开源许可证

MIT

最后验证

2026-09-02

技术栈

Go Gin 后端Vue 3、Vite 与 Vuetify 前端多协议 API 转换与渠道调度

授权说明

交付包保留上游 LICENSE 与版权声明；修改、再分发和商业使用请遵循 MIT 许可证条款。

Release notes

版本记录

1 个已发布版本

v2.8.25 当前推荐

补齐中文核心协议标签、修复无浏览器环境下认证 Store 的 localStorage 初始化问题，并移除源码中的推广跟踪链接。

部署要求：Go 1.25+、Bun 或等效 Node 包管理器；生产环境必须配置非默认访问密钥。

已知问题：本地截图只证明隔离预览数据和 Web 控制台流程，不代表外部 AI 上游可用性。

登录后领取