DS2API

架构概览

核心能力

模型支持

OpenAI 接口

Claude 接口

快速开始

方式一:本地运行

# 1. 克隆仓库
git clone https://github.com/CJackHwang/ds2api.git
cd ds2api
# 2. 配置
cp config.example.json config.json
# 编辑 config.json,填入你的 DeepSeek 账号信息和 API key
# 3. 启动
go run ./cmd/ds2api

方式二:Docker 运行

# 1. 配置环境变量
cp .env.example .env
# 编辑 .env
# 2. 启动
docker-compose up -d
# 3. 查看日志
docker-compose logs -f

方式三:Vercel 部署

方式四:下载 Release 构建包

# 下载对应平台的压缩包后
tar -xzf ds2api_v1.7.0_linux_amd64.tar.gz
cd ds2api_v1.7.0_linux_amd64
cp config.example.json config.json
# 编辑 config.json
./ds2api

配置说明

config.json 示例

{
 "keys": ["your-api-key-1", "your-api-key-2"],
 "accounts": [
 {
 "email": "user@example.com",
 "password": "your-password",
 "token": ""
 },
 {
 "mobile": "12345678901",
 "password": "your-password",
 "token": ""
 }
 ],
 "claude_model_mapping": {
 "fast": "deepseek-chat",
 "slow": "deepseek-reasoner"
 }
}

环境变量

鉴权模式

并发模型

每账号可用并发 = DS2API_ACCOUNT_MAX_INFLIGHT(默认 2)
建议并发值 = 账号数量 ×ばつ 每账号并发上限
等待队列上限 = DS2API_ACCOUNT_MAX_QUEUE(默认 = 建议并发值)
429 阈值 = in-flight + 等待队列 ≈ 账号数量 ×ばつ 4

Tool Call 适配

项目结构

ds2api/
├── cmd/
│ ├── ds2api/ # 本地 / 容器启动入口
│ └── ds2api-tests/ # 端到端测试集入口
├── api/
│ ├── index.go # Vercel Serverless Go 入口
│ ├── chat-stream.js # Vercel Node.js 流式转发
│ └── helpers/ # Node.js 辅助模块
├── internal/
│ ├── account/ # 账号池与并发队列
│ ├── adapter/
│ │ ├── openai/ # OpenAI 兼容适配器(含 Tool Call 解析、Vercel 流式 prepare/release)
│ │ └── claude/ # Claude 兼容适配器
│ ├── admin/ # Admin API handlers
│ ├── auth/ # 鉴权与 JWT
│ ├── config/ # 配置加载与热更新
│ ├── deepseek/ # DeepSeek API 客户端、PoW WASM
│ ├── server/ # HTTP 路由与中间件(chi router)
│ ├── sse/ # SSE 解析工具
│ ├── util/ # 通用工具函数
│ └── webui/ # WebUI 静态文件托管与自动构建
├── webui/ # React WebUI 源码(Vite + Tailwind)
│ └── src/
│ ├── components/ # AccountManager / ApiTester / BatchImport / VercelSync / Login / LandingPage
│ └── locales/ # 中英文语言包(zh.json / en.json)
├── scripts/
│ ├── build-webui.sh # WebUI 手动构建脚本
│ └── testsuite/ # 测试集运行脚本
├── static/admin/ # WebUI 构建产物(不提交到 Git)
├── .github/
│ ├── workflows/ # GitHub Actions(Release 自动构建)
│ ├── ISSUE_TEMPLATE/ # Issue 模板
│ └── PULL_REQUEST_TEMPLATE.md
├── config.example.json # 配置文件示例
├── .env.example # 环境变量示例
├── Dockerfile # 多阶段构建(WebUI + Go)
├── docker-compose.yml # 生产环境 Docker Compose
├── docker-compose.dev.yml # 开发环境 Docker Compose
├── vercel.json # Vercel 路由与构建配置
├── go.mod / go.sum # Go 模块依赖
└── version.txt # 版本号

文档索引

测试

# 单元测试
go test ./...
# 一键端到端全链路测试(真实账号,生成完整请求/响应日志)
./scripts/testsuite/run-live.sh
# 或自定义参数
go run ./cmd/ds2api-tests \
 --config config.json \
 --admin-key admin \
 --out artifacts/testsuite \
 --timeout 120 \
 --retries 2

Release 自动构建(GitHub Actions)

免责声明