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 模板。
