Docker 部署 One API 大模型 Key 分发及接口管理系统
项目简介
One API 是一个开源的 OpenAI 接口管理与分发系统。它支持多种主流大语言模型,包括 Azure、Anthropic Claude、Google PaLM 2 & Gemini、智谱 ChatGLM、百度文心一言、讯飞星火认知、阿里通义千问、360 智脑以及腾讯混元等。该系统可用于二次分发管理 API Key,提供统一的 API 入口,并具备英文 UI 界面。
核心特性:
- 统一接口管理:通过单一 API 调用所有支持的 LLM。
- 密钥管理:支持对多个模型的 Key 进行集中管理和配额控制。
- 开箱即用:提供单可执行文件及打包好的 Docker 镜像。
环境准备
在开始部署之前,请确保您的服务器满足以下要求:
- 操作系统:Linux (推荐 Ubuntu 20.04+ 或 CentOS 7+)。
- Docker:已安装 Docker Engine (版本 20.10+)。
- 网络:服务器需能访问外网以拉取镜像(如
justsong/one-api)。 - 端口:确保 3000 端口未被占用。
部署方式
项目作者提供了多种部署方案,包括 Docker Compose、手动部署、宝塔面板部署等。本教程重点介绍最通用的 Docker 部署方式。
1. SQLite 模式(适合低并发)
对于测试环境或低并发场景,可以直接使用内置的 SQLite 数据库,无需额外配置 MySQL。
docker run --name one-api -d --restart always -p 3000:3000 -e TZ=Asia/Shanghai -v /home/ubuntu/data/one-api:/data justsong/one-api
2. MySQL 模式(适合高并发)
如果预期并发量较大,建议配置 MySQL 数据库以保证性能。需要设置 SQL_DSN 环境变量。
docker run --name one-api -d --restart always -p 3000:3000 \
-e SQL_DSN="root:your_password@tcp(localhost:3306)/oneapi" \
-e TZ=Asia/Shanghai \
-v /home/ubuntu/data/one-api:/data \
justsong/one-api
注意:请将
your_password替换为您的实际 MySQL 密码,并确保 MySQL 服务可被容器访问。
初始配置
部署完成后,可以通过 http://服务器 IP:3000 访问管理后台。
1. 登录与修改密码
首次访问时,默认账号为 root,默认密码为 123456。出于安全考虑,登录后请立即修改密码。
2. 配置渠道 (Channels)
One API 的核心功能是聚合不同的大模型渠道。进入'渠道'页面,您可以添加各种模型的 API Key。
- 添加渠道:点击新增,选择对应的模型提供商(如 OpenAI, Azure, 智谱等)。
- 填写信息:输入模型名称、API Key、Base URL 等信息。
- 测试连接:保存前可点击测试按钮验证连通性。
示例:配置自定义渠道(如 coze-discord-proxy)
- 在渠道列表中选择'自定义'。
- 填写渠道名称和对应的请求头、URL 模板。


