One API / New API 是目前最流行的开源API聚合管理工具，可以将多个AI模型渠道统一汇聚到一个入口，通过一个令牌分发出去。自建中转站的优势在于：统一管理多个上游渠道、自主定价、团队共享、数据自持。
本教程面向纯新手，从服务器选购到最终客户端配置，全程操作均通过宝塔面板的图形界面完成。
一、服务器选购
前往阿里云、腾讯云等主流云服务商，选择一台云服务器。新手首次购买可享受新人优惠，配置建议：
最低配置：2核2G（可满足轻量使用）
推荐配置：2核4G（运行更稳定）
镜像选择要点：建议选择预装宝塔面板的系统镜像，后续操作会更方便。若选择纯净系统，推荐使用Alibaba Cloud Linux或Ubuntu 22.04/24.04等仍在维护的发行版（CentOS 7 已于2024年6月停止维护，不建议选用）。
购买后，记录服务器的公网IP、root账号密码。
二、连接服务器与安装宝塔面板
使用 SSH 连接工具（如 Xshell、MobaXterm 或终端）连接服务器：
bash
ssh root@你的服务器IP
输入密码后登录成功。接着安装宝塔面板，访问宝塔官网获取最新安装命令：
bash
# 以官网提供的命令为准，示例： wget -O install.sh https://download.bt.cn/install/install_6.0.sh && bash install.sh
安装过程约3-5分钟，完成后会显示面板访问地址、用户名和密码，请保存好这些信息。
登录宝塔面板后，在“安全”菜单中放行端口3000（New API 默认端口），以及面板自身端口。
三、安装 Docker 与 New API
宝塔面板集成了 Docker 管理器，可以在“软件商店”中搜索安装。
安装 Docker 后，在 Docker 管理器中搜索并安装New API。配置项如下：
域名绑定：如有已解析到该服务器的域名，可填写（如 api.yourdomain.com）
允许外部访问：若未绑定域名，务必勾选此项
端口映射：容器默认端口为 3000，保持默认即可
点击“安装”等待镜像拉取完成（约1-5分钟）。部署成功后，通过http://服务器IP:3000即可访问 New API 面板。
四、初始化 New API 面板
首次访问时，进入安全向导：
设置管理员账号和密码
选择运营模式：
自用模式：仅自己使用
对外运营：开放给其他用户注册使用（需后续配置支付系统）
设置完成后，进入管理后台。
五、对接上游渠道
5.1 添加渠道
进入“渠道管理” → “添加渠道”：
类型：选择 OpenAI 格式（大部分上游通用）
密钥：填写上游提供的 API Key
地址：上游 API 地址（如
https://api.openai.com/v1或第三方中转地址）
点击“提交”后，点击“获取模型”按钮，系统会自动拉取该渠道支持的模型列表。
5.2 设置分组与价格
New API 支持多分组定价，便于针对不同用户设置不同倍率：
系统默认提供
default和vip两个分组可在“系统设置” → “分组模型定价”中调整每个分组的倍率（如 1.5 倍、2 倍）
建议通过“上游同步”一次性导入所有模型价格，无需逐个手动录入
价格同步后，模型广场即会显示定价。
六、创建令牌与客户端配置
在“令牌管理”中创建新令牌：
选择分组（决定该令牌适用哪套定价）
设置有效期（可设为“不过期”）
可限制该令牌仅能使用特定模型
创建后复制令牌密钥。
客户端配置（以 CodeX 为例）：
New API 面板内置了 CodeX 一键导入功能（“令牌管理”页面的 CodeX 按钮），点击后自动唤起 CodeX 客户端并填入 API 地址与密钥，点击导入即可直接使用。
也可以手动配置：
API Base URL：
http://你的IP:3000/v1API Key：填入刚才生成的令牌
七、验证与测试
在“操练场”中选择任意模型发送测试消息，若能正常响应，说明整套链路已打通。
在“使用日志”中可以查看所有请求记录，便于排查问题和统计用量。
八、其他功能说明
支付系统：如需对外开放注册付费，New API 内置了易支付接口，在系统设置中填入商户信息即可
公告系统：可在面板内发布系统公告，通知用户
仪表盘：实时查看用量统计、渠道负载等数据
九、安全提醒
登录宝塔面板后，立即修改默认的账号、密码、端口和面板路径
服务器安全组中仅放行必需端口（如 3000、22、宝塔面板端口），其余端口保持关闭
如对外运营，务必配置 HTTPS 证书，避免 API Key 在网络传输中被截获
