Sub2API安装使用以及与New-API对比-过客

一直在用New-API来做AI API整合转发，最近又发现一个类似的Sub2API，其实我是感觉它的数据面板和监控页面比较详细，于是先安装试一下。

一、安装部署

1. Docker 一键部署

使用自动化部署脚本快速搭建：

# 创建部署目录
mkdir -p sub2api-deploy && cd sub2api-deploy

# 下载并运行部署准备脚本
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/docker-deploy.sh | bash

2. 配置

在/root/sub2api-deploy 目录中会有一个**.env**环境配置文件，必须配置项：

# PostgreSQL 密码（必需）
POSTGRES_PASSWORD=your_secure_password_here

# JWT 密钥（推荐 - 重启后保持用户登录状态）
JWT_SECRET=your_jwt_secret_here

# TOTP 加密密钥（推荐 - 重启后保留双因素认证）
TOTP_ENCRYPTION_KEY=your_totp_key_here

# 可选：管理员账号
ADMIN_EMAIL=admin@example.com
ADMIN_PASSWORD=your_admin_password

# 可选：自定义端口
SERVER_PORT=8080

3. 启动

docker-compose up -d

二、基本使用

这里以阿里百炼CodingPlan为例

在浏览器中输入 http://ip:8080 就可以打开了

如果使用Nginx代理，需要添加配置。不配置会导致多账号环境下的粘性会话功能失效

underscores_in_headers on;

用前面.env配置的邮箱和密码登录。

创建OpenAI平台分组（如果需要OpenAI兼容接口的话），这是的平台要确定，设定好后不能修改，不同平台对应上游的接口类型。

创建渠道，这里主要是给渠道模型定价，这个就是给下游用户使用时扣除sub2api账户费用的价格，因为是个人自用，这里就随便填下就可以了。

创建帐号，这里就是填写你在各平台的账号和密钥，这里选择Anthropic接口类型（之前选了OpenAI的接口，死活都连不上），需要填入具体模型名，最后面还要勾选哪些分组可以使用，分组的平台要和帐号接口类型平台要一样，这一点兼容性做的没有New-API好，试过一些免费平台都连不上。其他参数根据自己的需求填写，要注意点的是这里的池模式，这也是sub2api的亮点，可以把多个账号放入到同一个池中，下游掉用池中模型时，会自动负载均衡和故障转移，以及他的粘性会话。

测试账号是否可用，点帐号“操作”后面的“...”-> 测试连接-> 开始测试。测试成功说明帐号配置没问题。

进入“我的账户”中，创建密钥，填写名称和一些限制，分组要选好，这个密钥只能使用选定分组中帐号池的账号和模型。

在小龙虾中配置使用。记得给自己账户充钱啊。我这没配置域名，直接拿IP来测试。小龙虾配置，sub2api上游是Anthropic下游也必须是Anthropic接口，没看到相关的文档，开始用了openai-completions失败了，后来换成anthropic-messages可以了。

{
  "models": {
    "mode": "merge",
    "providers": {
      "zngw-sub2api": {
        "baseUrl": "https://llm.zngw.cc/v1",
        "apiKey": "sk-xxx",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "qwen3.5-plus",
            "name": "Qwen3.5 Plus"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "zngw/qwen3.5-plus"
      }
    }
  }
}

Sub2API与New-API对比

维度	New-API	Sub2API
定位	多模型统一网关	订阅配额优化器，“拼车”神器
核心能力	模型协议转换、路由分发	订阅账号池化管理、额度分配
输入	API Key/OAUTH	订阅账号 Cookie/Token
输出	统一 OpenAI 格式	原生格式
劣势	对纯订阅号支持差	面对上游平台兼容性差，下游出口也不统一

结合使用

网上有一种推荐是二个结合来使用。

用户 → New-API（统一入口、用户管理、计费） → Sub2API（订阅调度） → 上游 AI 服务

发挥各种的长处，对下游统一入口，对上游订阅额度分配。

总结

对于个人或小团队来，还喜欢薅免费羊毛党来说，还是用New-API的好，主要是他接口兼容性好，面对上游五花八门的接口协议友好，基本只要选择哪种协议，再填写一个API地址就可以了，99.99%都能连上。

目录CONTENT

Sub2API安装使用以及与New-API对比