Sub2API 部署教程：搭建 AI API 中转站服务器

先说结论

如果你想自己搭一个可用的中转站，Sub2API 这类开源项目通常就够用了。最核心的流程很简单：先准备一台 Linux 服务器，再把服务部署上去，完成数据库和管理员初始化，最后把对外的 Base URL 和 API Key 发给使用者。

适合什么场景

Sub2API 更适合这几类人：

• 想把多个上游账号统一管理
• 想给团队成员分发统一的 API Key
• 想自己控制充值、权限和转发规则
• 想先跑一个可用的私有中转，而不是立刻上复杂平台

如果你只是想临时测试一个接口，也可以先用它的演示环境理解流程，但正式使用还是建议自己部署。

部署前准备

部署前先准备三样东西：

1. 一台 Linux 云服务器，推荐 AMD64 或 ARM64 架构
2. PostgreSQL 和 Redis，或者直接用 Docker Compose 一起带上
3. 一个能正常解析到服务器的域名，方便后续接证书和访问面板

如果你打算反向代理到 Nginx，记得在 http 段开启 underscores_in_headers on;，否则某些多账号场景会出问题。

推荐部署方式

Sub2API 官方文档里更推荐两种方式：

• 一键脚本安装：适合快速上线，脚本会自动下载二进制、创建服务和初始化目录
• Docker Compose：适合你想更清楚地控制数据目录、迁移和备份

如果你是第一次搭，Docker 方式通常更直观；如果你偏生产环境和 systemd 管理，脚本安装也很顺手。

方式一：Docker 部署

大致流程是：

mkdir -p sub2api-deploy && cd sub2api-deploy
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/docker-deploy.sh | bash
docker compose up -d

脚本通常会帮你准备：

• docker-compose.local.yml
• .env
• 安全密钥
• 本地数据目录

这样后续迁移服务器时，也更容易把整套数据一起打包走。

如果你想看运行状态，可以继续执行：

docker compose logs -f sub2api

方式二：脚本安装

如果你更习惯直接跑 systemd 服务，可以用官方的一键安装脚本。它会把程序装到服务器上，再创建服务和初始化向导。

curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash

装完后通常会在 http://服务器IP:8080 打开初始化页面，继续配置数据库、Redis 和管理员账号。

初始化时要看什么

初始化面板里，优先确认这几件事：

• 数据库是否连通
• Redis 是否正常
• 管理员账号是否创建成功
• 端口是否对外开放
• 域名和反代是否已经接好

如果你打算给别人一起用，最好在初始化阶段就把管理员和普通用户的边界想清楚，别后面再返工。

接入使用者

面板跑起来之后，你就可以把这两个东西交给使用者：

• Base URL
• API Key

使用者在 Claude Code、Codex、Cursor 或其他兼容工具里填上这两个信息，就能把请求打到你的中转站，再由中转站转发到上游服务。

这类中转站的本质

你可以把它理解成一个“中间层”：

用户先把请求发给你的中转站，中转站再根据你配置的上游账号、模型和规则，把请求转出去。这样你就能统一管理账号、权限、计费和分发方式。

常见坑

• Nginx 头被吞：如果用了反向代理，注意保留下划线请求头
• 数据库或 Redis 没起：初始化面板能打开，不代表后端依赖都正常
• 域名没配好：面板能访问，不代表对外 API 地址也能正确调用
• 账号授权失败：通常先检查浏览器、代理和回调地址，再看上游账号状态

结尾

如果你是第一次搭中转站，别一开始就把结构做得很复杂。先跑通一个最小可用版本，确认面板、账号、转发和调用都正常，再慢慢补域名、证书、代理和更多上游账号。