Copilot Hub

GitHub Copilot 账号共享网关。将多个 Copilot 账号池化，对外提供兼容 OpenAI / Anthropic 标准的统一 API，带有 Web 管理界面。

---

功能概览

核心能力

• 多账号池化：多个 GitHub Copilot 账号统一管理，自动负载均衡
• 配额感知调度：优先选择剩余配额充足的账号，避免 429
• 会话亲和：同一 API Key 的连续请求尽量命中同一账号
• 第三方供应商：支持接入 MiniMax、GLM、Gemini 等第三方 API

API 兼容层

端点	协议	说明
POST /v1/chat/completions	OpenAI Chat	流式 / 非流式
POST /v1/messages	Anthropic Messages	流式 / 非流式
POST /v1/embeddings	OpenAI Embeddings	文本向量化
GET /v1/models	OpenAI Models	可用模型列表

---

快速开始

环境要求

操作系统	依赖
Linux / macOS	Python 3.12+, Node.js 18+, uv, pnpm
Windows	Python 3.12+, Node.js 18+, uv, pnpm
Docker	Docker 20.10+

---

方式一：Docker (推荐)

# 克隆项目
git clone https://github.com/2ndElement/copilot-hub
cd copilot-hub
# 创建数据目录
mkdir -p data
# 启动服务
docker-compose up -d

访问地址：http://localhost:8000

方式二：Linux/macOS

git clone https://github.com/2ndElement/copilot-hub
cd copilot-hub
bash dev.sh

方式三：Windows

git clone https://github.com/2ndElement/copilot-hub
cd copilot-hub
powershell -ExecutionPolicy Bypass -File install.ps1
cmd /c start.bat

---

Docker 详解

快速命令

# 启动服务
docker-compose up -d
# 查看日志
docker-compose logs -f
# 停止服务
docker-compose down
# 重新构建
docker-compose build --no-cache

使用预构建镜像

# 拉取镜像
docker pull 2nde1ement/copilot-hub
# 运行容器
docker run -d \
--name copilot-hub \
-p 8000:8000 \
-v $(pwd)/data:/app/data \
-e PORT=8000 \
-e REGISTRATION_MODE=open \
2nde1ement/copilot-hub

自定义构建

# 构建镜像
docker build -t my-copilot-hub .# 运行
docker run -d \
--name copilot-hub \
-p 8000:8000 \
-v $(pwd)/data:/app/data \
my-copilot-hub

环境变量

变量	默认值	说明
PORT	8000	监听端口
DB_PATH	/app/data/copilot_hub.db	数据库路径
REGISTRATION_MODE	open	注册模式: open / invite / closed
HTTPS_PROXY	-	代理地址
SESSION_AFFINITY_TTL	300	会话亲和时间(秒)
API_KEY_DEFAULT_EXPIRE_DAYS	0	API Key 过期天数

---

生产部署

Linux (systemd)

# 一键部署
bash deploy.sh
# 仅更新后端
bash deploy.sh --no-build

Docker + Nginx (生产)

# docker-compose.prod.ymlversion: '3.8'services:
copilot-hub:
build: .restart: unless-stoppedvolumes:
- ./data:/app/dataenvironment:
- PORT=8000
- DB_PATH=/app/data/copilot_hub.dbnginx:
image: nginx:latestrestart: unless-stoppedports:
- "80:80"
- "443:443"volumes:
- ./nginx.conf:/etc/nginx/nginx.conf:ro
- ./data/certbot:/etc/letsencryptdepends_on:
- copilot-hub

---

API 使用

# OpenAI 格式
curl http://localhost:8000/v1/chat/completions \
-H "Authorization: Bearer lab-sk-xxxx" \
-H "Content-Type: application/json" \
-d '{ "model": "claude-sonnet-4.6", "messages": [{"role": "user", "content": "你好"}] }'# Anthropic 格式
curl http://localhost:8000/v1/messages \
-H "Authorization: Bearer lab-sk-xxxx" \
-H "x-api-key: lab-sk-xxxx" \
-H "Content-Type: application/json" \
-d '{ "model": "claude-sonnet-4.6", "max_tokens": 1024, "messages": [{"role": "user", "content": "你好"}] }'

---

项目结构

copilot-hub/
├── Dockerfile # Docker 镜像构建
├── docker-compose.yml # Docker Compose 配置
├── .dockerignore # Docker 忽略文件
├── main.py # FastAPI 入口
├── config.py # 配置管理
├── database.py # SQLite 建表
├── crypto.py # Token 加解密
├── deploy.sh # Linux 部署脚本
├── dev.sh # 开发启动脚本
├── start.bat # Windows 启动脚本
├── install.ps1 # Windows 安装脚本
├── routers/ # API 路由
├── services/ # 业务逻辑
└── frontend/ # Vue 3 前端

---

许可证

MIT License