Skip to content
项目

satriyaa67/qwen2api-MultiLANG

在 GitHub 查看

satriyaa67/qwen2api-MultiLANG has 52 GitHub stars and 1 forks. GitHot measured 0 in 7 days. Last checked 2026-11-16 02:55 UTC. Last push 2026-10-19.

这些数字如何统计

实测星标增长

24小时
更新延迟
7天
0
15天
更新延迟
1个月
更新延迟

各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。

关于

qwen2API çok dilli (i18n) fork'u • Multi-language (i18n) fork of qwen2API — WebUI artık Çince, İngilizce ve Türkçe / UI now in Chinese, English & Turkish. Orijinal / Original: YuJunZhiXue/qwen2API

网站与应用

README_CN.md

原文

English | 简体中文

qwen2API

qwen2API

自托管千问 Web 协议转换网关,提供 OpenAI、Anthropic、Gemini 兼容接口。

GitHub · Docker Hub · Telegram · English README

Release Stars Docker Hub Go React License

一、项目简介

qwen2API 将千问 Web 能力转换为常见 API 协议,并提供本地 WebUI,用于管理上游账号、下游 API Key、运行配置、模型测试、图片测试和视频测试。

[!NOTE] v1.0 是旧版 Python + FastAPI 实现,仅作为历史版本说明保留。v2.0 是当前主线,采用 Go 后端 + React WebUI,也是推荐的 Docker 与本地部署版本。

1. 功能概览

模块 能力
OpenAI 兼容接口 /v1/chat/completions、/v1/responses、/v1/models、/v1/files、/v1/images/generations、/v1/videos/generations
Anthropic 兼容接口 /v1/messages、/anthropic/v1/messages、/v1/messages/count_tokens
Gemini 兼容接口 /v1beta/models/{model}:generateContent、/v1beta/models/{model}:streamGenerateContent
WebUI 账号管理、API Key 管理、运行配置、对话测试、图片测试、视频测试
账号池 多账号轮询、单账号并发控制、对话/图片/视频分用途冷却记录
运维接口 /healthz、/readyz、/keepalive、Docker Healthcheck、多架构镜像发布

2. 版本说明

版本 技术栈 状态
v1.0 Python + FastAPI/Uvicorn 旧版实现,仅保留历史说明
v2.0 Go 后端 + React WebUI 当前主线

二、快速部署

1. Docker Hub 拉取部署

大多数情况下,直接用 Docker Hub 镜像就够了。把 data 和 logs 放在 compose 文件旁边,Docker 会把它们挂载进容器;以后更新镜像时,账号、Key 和日志都还在。

mkdir qwen2api
cd qwen2api
mkdir -p data logs

创建一个简单的 .env:

HOST_PORT=7860
HOST_DATA_DIR=./data
HOST_LOGS_DIR=./logs
ADMIN_KEY=replace-with-your-own-strong-random-key

创建 docker-compose.yml:

services:
  qwen2api:
    image: ${QWEN2API_IMAGE:-yujunzhixue/qwen2api:latest}
    container_name: qwen2api
    restart: unless-stopped
    init: true
    env_file:
      - .env
    ports:
      - "${HOST_PORT:-7860}:${PORT:-7860}"
    volumes:
      - ${HOST_DATA_DIR:-./data}:/app/data
      - ${HOST_LOGS_DIR:-./logs}:/app/logs
    shm_size: "512m"
    healthcheck:
      test: ["CMD-SHELL", "curl -fsS http://127.0.0.1:${PORT:-7860}/healthz || exit 1"]
      interval: 30s
      timeout: 10s
      start_period: 120s
      retries: 3

不用手动配置 accounts.json、api_keys.json 这类内部文件路径。镜像里默认就是 /app/data 和 /app/logs,上面的 volume 映射决定它们最终落在宿主机哪个目录。

拉取并启动:

docker compose pull
docker compose up -d
docker compose logs -f qwen2api

访问地址:

  • WebUI:http://127.0.0.1:7860
  • 健康检查:http://127.0.0.1:7860/healthz
  • 保活探针:http://127.0.0.1:7860/keepalive

2. 本地 Docker 编译

当你修改了源码并需要构建自己的镜像时,使用本地 Docker 编译方式。

git clone https://github.com/YuJunZhiXue/qwen2API.git
cd qwen2API
cp .env.example .env
docker compose -f docker-compose.yml -f docker-compose.build.yml build
docker compose -f docker-compose.yml -f docker-compose.build.yml up -d

三、架构与配置

1. 运行架构

flowchart LR
  subgraph Clients["API Clients"]
    OpenAI["OpenAI SDK / Chat Completions"]
    Anthropic["Claude / Anthropic Messages"]
    Gemini["Gemini-compatible clients"]
    CLI["Claude Code / Codex / other CLI tools"]
  end

  subgraph App["qwen2API v2.0"]
    WebUI["React WebUI"]
    Router["Go HTTP Router"]
    Adapter["Protocol Adapters"]
    Tools["Tool-call / Context Pipeline"]
    Pool["Qwen Account Pool"]
    Store["JSON Stores / Data Files"]
  end

  subgraph Runtime["Runtime"]
    Docker["Docker image"]
    Data["./data volume"]
    Logs["./logs volume"]
  end

  Qwen["Qwen Web Upstream"]

  OpenAI --> Router
  Anthropic --> Router
  Gemini --> Router
  CLI --> Router
  WebUI --> Router
  Router --> Adapter
  Adapter --> Tools
  Tools --> Pool
  Pool --> Qwen
  Pool --> Store
  Store --> Data
  Router --> Logs
  Docker --> App

2. 环境变量

不要提交真实密钥。.env.example 只保留空值和注释示例。

变量 说明
ADMIN_KEY WebUI 和 /api/admin/* 管理接口 Key,请自行设置强随机值
QWEN_API_KEY、QWEN_API_KEYS、QWEN_API_KEY_N 环境变量注入的下游 API Key,仅运行时存在,不写入 data/api_keys.json,不能从 WebUI 删除
QWEN_ACCOUNT_N 环境变量注入的上游账号,格式为 token;optional-email;optional-password,不写入 data/accounts.json
KEEPALIVE_URL、KEEPALIVE_INTERVAL 可选后台保活任务;环境变量存在时会锁定 WebUI 中对应配置
TOOL_RECOVERY_MAX_ATTEMPTS 工具结果之后上游没有产出下一次客户端工具调用时的自动恢复尝试次数;默认 4,限制在 1-8
HOST_DATA_DIR、HOST_LOGS_DIR Docker 宿主机挂载路径,默认 ./data 和 ./logs
DATA_DIR、LOGS_DIR 本地非 Docker 路径覆盖;留空时使用当前项目目录

四、开发指南

1. 环境要求

  • Go: 1.26
  • Node.js: 20+
  • npm: 随 Node.js 安装
  • Docker: 仅在需要容器构建或容器部署时使用

2. 本地开发

# 1. 克隆项目
git clone https://github.com/YuJunZhiXue/qwen2API.git
cd qwen2API

# 2. 安装前端依赖
cd frontend
npm ci
cd ..

# 3. 一键启动 Go 后端和 React WebUI
go run start-all.go

3. 启动与验证

  1. 访问 WebUI:http://127.0.0.1:7860
  2. 检查健康状态:http://127.0.0.1:7860/healthz
  3. 检查保活探针:http://127.0.0.1:7860/keepalive
  4. 修改后端代码后执行:
cd backend
go test ./...
go build -trimpath -ldflags="-s -w" -o ..\bin\qwen2api-backend.exe .
  1. 修改前端代码后执行:
cd frontend
npm run build

4. Docker 本地调试

# 使用本地源码构建镜像
docker compose -f docker-compose.yml -f docker-compose.build.yml build

# 使用本地镜像启动
docker compose -f docker-compose.yml -f docker-compose.build.yml up -d

# 查看日志
docker compose logs -f qwen2api

5. 开发规范

  • 🧩 模块化开发: 协议适配、账号池、文件上下文、图片/视频能力和 WebUI 组件应保持边界清晰。
  • 🔄 提交流程: 小步修改 → 本地验证 → 提交 PR,避免把无关清理、功能改动和格式化混在一起。
  • 📚 文档更新: 新增用户可见配置、Docker 参数、接口能力或部署方式时,同步更新 README 和 .env.example。
  • 🔐 安全边界: 不要提交 data/、logs/、.env、真实 token、Cookie、密码或下游 API Key。
  • 🐳 Docker 规则: 容器内部数据路径固定为 /app/data 和 /app/logs,宿主机路径只通过 compose volume 映射控制。

五、参与贡献

1. 贡献方式

2. 贡献列表

感谢所有帮助改进 qwen2API 的贡献者。

六、其他信息

1. Star History

2. 开源协议

本项目采用 GPL-3.0 License 开源协议。

您可以自由地:

  • ✅ 使用、复制、修改和分发本软件。
  • ✅ 用于个人、自托管或商业场景。
  • ✅ 在遵循 GPL-3.0 的前提下发布修改版本。

但需要:

  • 📋 保留原始版权声明和开源协议。
  • 📋 标明对原始代码的修改。
  • 📋 分发衍生作品时遵循 GPL-3.0 的开源要求。

3. 免责声明

  • 本项目为免费开源项目,不保证绝对完善无误。
  • 本项目是自托管协议转换网关,请自行评估部署环境、账号风险和使用方式。
  • 使用前请自行确认所在地法律、平台规则和上游账号政策。
  • 严禁公开泄露真实账号 token、Cookie、密码或下游 API Key。
  • 如发现安全问题,请优先通过私密渠道反馈,避免公开敏感信息。

4. 特别鸣谢


如果 qwen2API 对你有帮助,可以考虑给项目一个 Star。

由 YuJunZhiXue 和贡献者共同维护。