目录
one-api%20%E4%BB%8B%E7%BB%8D-toc" style="margin-left:0px;">一、one-api 介绍
one-api-toc" style="margin-left:0px;">二、部署 one-api
2.1 拉取镜像
one-api-toc" style="margin-left:40px;">2.2 部署 one-api
one-api-toc" style="margin-left:0px;">三、运行 one-api
3.1 添加规则
one-api%C2%A0-toc" style="margin-left:40px;">3.2 运行 one-api
四、添加大模型 API
4.1 添加大模型 API
五、总结
本文通过 服务器X实例>Flexus云服务器X实例 部署 one-api。服务器X实例>Flexus云服务器X实例是新一代面向中小企业和开发者打造的柔性算力云服务器，可智能感知业务负载，适用于电商直播、企业建站、开发测试环境、游戏服务器、音视频服务等中低负载场景。相较于Flexus应用服务器L实例，服务器X实例>Flexus云服务器X实例的优势包含：提供丰富的公共镜像、可灵活自定义vCPU内存配比、智能感知业务动态升降配，负载范围更高等。
服务器X实例>Flexus云服务器X实例 能够支持电商直播、企业建站、个人开发测试、游戏服务器等。
one-api%20%E4%BB%8B%E7%BB%8D">一、one-api 介绍
one-api 是一个 OpenAI 接口管理 & 分发系统，目前支持 Azure、Anthropic Claude、Google PaLM 2 & Gemini、智谱 ChatGLM、百度文心一言、讯飞星火认知、阿里通义千问、360 智脑以及腾讯混元，可用于二次分发管理 key，仅单可执行文件，已打包好 Docker 镜像，一键部署，开箱即用。
one-api 特性：
（1）支持多种大模型；
（2）支持配置镜像以及众多第三方代理服务；
（3）支持通过负载均衡的方式访问多个渠道；
（4）支持 stream 模式，可以通过流式传输实现打字机效果；
（5）支持多机部署，支持令牌管理，设置令牌的过期时间、额度、允许的 IP 范围以及允许的模型访问；
（6） 支持兑换码管理，支持批量生成和导出兑换码，可使用兑换码为账户进行充值；
（7）支持渠道管理，批量创建渠道。 支持用户分组以及渠道分组，支持为不同分组设置不同的倍率；
（8） 支持渠道设置模型列表，支持查看额度明细。 支持用户邀请奖励。 支持以美元为单位显示额度等。
one-api">二、部署 one-api
2.1 拉取镜像
首先，先从远程镜像仓库中拉取 one-api 镜像，执行如下命令拉取。
root@flexusx-7305:~# docker pull swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/justsong/one-api:v0.6.0
v0.6.0: Pulling from ddn-k8s/docker.io/justsong/one-api
4abcf2066143: Pull complete
c2f30ece0032: Pull complete
213fae9f6ab5: Pull complete
f2605c032589: Pull complete
Digest: sha256:416dc625c8c5a905e70db79b40bed5325fa0bc26aecf9cf9181e89b653595e14
Status: Downloaded newer image for swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/justsong/one-api:v0.6.0
swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/justsong/one-api:v0.6.0one-api 镜像拉取成功。
one-api">2.2 部署 one-api
拉取完 one-api 镜像后，one-api 镜像会存储到本地，如下所示。
root@flexusx-7305:~# docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/gitea/gitea 1.22.1 b3de72970178 2 months ago 167MB
swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/justsong/one-api v0.6.0 36bd98ce5a7c 6 months ago 48.4MB
daocloud.io/library/mysql 8 26d0ac143221 3 years ago 546MB
daocloud.io/library/mysql latest 8457e9155715 3 years ago 546MB
root@flexusx-7305:~# 复制镜像名称，通过 docker 部署 one-api，执行如下命令。
root@flexusx-7305:~# docker run --name one-api -d --restart always -p 3002:3000 -e TZ=Asia/Shanghai -v /root/data/one-api:/data swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/justsong/one-api:v0.6.0
89bb9f7a3dd119008c678243464bdf10df377dc4d482b123be3c077d7a675ac8
root@flexusx-7305:~# docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
89bb9f7a3dd1 swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/justsong/one-api:v0.6.0 "/one-api" 2 seconds ago Up 2 seconds 0.0.0.0:3002->3000/tcp, [::]:3002->3000/tcp one-api
ef512af0c1c5 swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/gitea/gitea:1.22.1 "/usr/bin/entrypoint…" 2 days ago Up 2 days 0.0.0.0:3000->3000/tcp, :::3000->3000/tcp, 0.0.0.0:222->22/tcp, [::]:222->22/tcp gitea
65fe1c102df6 daocloud.io/library/mysql:8 "docker-entrypoint.s…" 2 days ago Up 2 days 3306/tcp, 33060/tcp root_db_1
root@flexusx-7305:~# 通过 docker ps 可以查看正在运行的容器，可以看到 one-api 已运行，端口是 3002，对应容器内部端口 3000。
one-api">三、运行 one-api
通过上面的步骤，one-api 已经部署成功，下面就来详细看下 one-api 的功能。
3.1 添加规则
one-api 对应的端口是 3002，需要将 3002 端口加入到准入规则中。
首先，在基本信息中，找到安全组，点击进入安全组，如下所示。
然后，点击 配置规则 配置 3002 端口，如下所示。
设置优先级，然后在协议端口中添加端口，点击确定，如下所示。
可以看到 3002 端口已经被加入到安全规则中，如下所示。
one-api%C2%A0">3.2 运行 one-api
在浏览器中，访问 http://服务器IP地址:3002，one-api 界面如下所示。
然后，点击右上角登录按钮，默认用户名为 root，默认密码为 123456，登录后可以修改密码，如下所示。
四、添加大模型 API
4.1 添加大模型 API
添加大模型 API 是在渠道里面，如下所示。
点击添加新渠道，如下所示。
添加完成后可以点击测试按钮测试添加是否成功。
4.2 添加令牌
添加完大模型后，点击令牌生成密钥，
点击添加新的令牌，输入令牌名称，过期时间可以默认，表示永不过期，如下所示。
添加完成后，点击复制即可复制密钥，用于通过 one-api 连接大模型时填写密钥。
五、总结
通过 服务器X实例>Flexus云服务器X实例 上部署 one-api，能够流畅支持多种大模型接入，方便了大模型的开发工作。而且， 服务器X实例>Flexus云服务器X实例提供了丰富的公共镜像，可灵活自定义镜像版本，支持智能感知业务动态升降配，负载范围更高，支持灵活自定义vCPU、内存实例规格，支持按需计费更精细和灵活的定价模式，可基于实际负载画像智能推荐规格。赶紧用起来吧！
