README

New API 部署与 CPA 串联笔记 §

New API = new-api，是一个 OpenAI 兼容 API 网关，用来做渠道聚合、用户管理、额度、日志和模型计费。

本笔记基于 2026-05 在腾讯云 OpenCloudOS 服务器上的实际部署整理。上游已经有一个跑通的 CPA（CLIProxyAPI），New API 负责把 CPA 包成可分发给用户的统一入口。

目录 §

文件	内容
01-overview.md	New API 和 CPA 的关系、整体架构
02-deploy.md	Docker + SQLite 部署 New API
03-network.md	腾讯云安全组、公网 IP、端口排查
04-connect-cpa.md	把 CPA 添加成 New API 渠道
05-users-and-tokens.md	用户、令牌、客户端调用方式
06-pricing.md	自用模式、分组、模型价格配置
07-troubleshooting.md	常见错误与排错
08-security.md	安全加固和备份

快速回顾（TL;DR） §

1. CPA 已经跑在服务器 8317，客户端可直接调用。
2. New API 用 Docker 起在 3000，数据落到 /root/new-api/data。
3. 腾讯云安全组放行 3000，来源填本机公网 IP，不是服务器内网 IP。
4. 首次访问 New API 页面，初始化管理员账号。
5. 在 New API 添加渠道：类型 OpenAI，Base URL 填 http://172.17.0.1:8317。
6. 若测试报“模型价格未配置”，先开启自用模式，或给模型配置价格。
7. 给朋友用时，让用户在 New API 里生成自己的 token，客户端 Base URL 改成 http://服务器公网IP:3000/v1。

关键端口 §

端口	服务	说明
8317	CPA	上游凭据层，OpenAI 兼容 API
3000	New API	网关层，后台和统一 API 入口
22	SSH	服务器管理

关键路径 §

/root/new-api/data/        # New API SQLite 数据、上传文件等持久化数据
/root/CLIProxyAPI/         # CPA 部署目录，详见 ../cpa/