目录
一、one-api 介绍
二、部署 one-api
2.1 拉取镜像
2.2 部署 one-api
三、运行 one-api
3.1 添加规则
3.2 运行 one-api
四、添加大模型 API
4.1 添加大模型 API
五、总结
本文通过 Flexus云服务器X实例 部署 one-api。Flexus云服务器X实例是新一代面向中小企业和开发者打造的柔性算力云服务器,可智能感知业务负载,适用于电商直播、企业建站、开发测试环境、游戏服务器、音视频服务等中低负载场景。相较于Flexus应用服务器L实例,Flexus云服务器X实例的优势包含:提供丰富的公共镜像、可灵活自定义vCPU内存配比、智能感知业务动态升降配,负载范围更高等。
Flexus云服务器X实例 能够支持电商直播、企业建站、个人开发测试、游戏服务器等。
一、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
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.0
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 的功能。
3.1 添加规则
one-api 对应的端口是 3002,需要将 3002 端口加入到准入规则中。
首先,在基本信息中,找到安全组,点击进入安全组,如下所示。
然后,点击 配置规则 配置 3002 端口,如下所示。
设置优先级,然后在协议端口中添加端口,点击确定,如下所示。
可以看到 3002 端口已经被加入到安全规则中,如下所示。
3.2 运行 one-api
在浏览器中,访问 http://服务器IP地址:3002,one-api 界面如下所示。
然后,点击右上角登录按钮,默认用户名为 root,默认密码为 123456,登录后可以修改密码,如下所示。
四、添加大模型 API
4.1 添加大模型 API
添加大模型 API 是在渠道里面,如下所示。
点击添加新渠道,如下所示。
添加完成后可以点击测试按钮测试添加是否成功。
4.2 添加令牌
添加完大模型后,点击令牌生成密钥,
点击添加新的令牌,输入令牌名称,过期时间可以默认,表示永不过期,如下所示。
添加完成后,点击复制即可复制密钥,用于通过 one-api 连接大模型时填写密钥。
五、总结
通过 Flexus云服务器X实例 上部署 one-api,能够流畅支持多种大模型接入,方便了大模型的开发工作。而且, Flexus云服务器X实例提供了丰富的公共镜像,可灵活自定义镜像版本,支持智能感知业务动态升降配,负载范围更高,支持灵活自定义vCPU、内存实例规格,支持按需计费更精细和灵活的定价模式,可基于实际负载画像智能推荐规格。赶紧用起来吧!