主机资讯与使用指南
New API 部署教程:官方 Compose、初始化与渠道配置
部署 New API 的官方 Compose 组合,设置数据库、管理员和模型渠道,再建立应用调用令牌。
New API 用于管理模型渠道和调用令牌
已经有模型服务账号、希望统一管理调用入口,可以部署 New API。本文采用官方 Compose 项目,当前默认组合包含 PostgreSQL 与 Redis,不沿用旧文章里的默认账号或单容器配置。
取得项目并修改配置
git clone https://github.com/QuantumNous/new-api.git
cd new-api打开仓库中的 docker-compose.yml,按文件说明修改数据库密码、会话密钥和持久化目录。模型渠道凭据在初始化后添加,不写进公开仓库。
已有应用使用宿主机 3000 端口时,修改 New API 的宿主机映射端口。由宿主机 Caddy 代理时,可把映射写成 127.0.0.1:3000:3000;不要直接发布数据库与 Redis 端口。
启动并查看日志
sudo docker compose config --quiet
sudo docker compose up -d
sudo docker compose ps
sudo docker compose logs --tail=100 new-api服务名以下载到的官方文件为准。持续退出时查看日志中的数据库、Redis 或参数错误,再调整对应配置。
初始化管理员与模型渠道
通过域名打开初始化页面,建立自己的管理员账号。添加模型提供方渠道,填写对应地址、密钥和可用模型,再使用渠道测试检查连接。
为调用应用建立独立令牌,并按用途设置可用模型与额度。Open WebUI 等应用填写的是 New API 提供的兼容调用地址和令牌,不是管理账号密码。
保存数据库与配置
数据库保存账号、渠道、令牌与调用管理数据,应用配置保存数据库连接和运行参数,两者一起备份。升级前查看所选版本的说明;首次安装的示例密码改动,不等于已经修改了现有数据库用户密码。