Sub2API 是一个开源 AI API 网关平台,可以把 Claude、OpenAI、Gemini、Antigravity 等订阅账号统一转成标准 API 接口,支持多人拼车、精准按 Token 计费、智能负载均衡。
本文介绍方式一:脚本一键安装——最适合初学者,5 分钟完成部署。
适用场景
- 你有一台 Linux 服务器(VPS)
- 不熟悉 Docker,想用最简单的方式
- 希望安装后直接跑在系统上,便于 systemd 管理
前置条件
| 组件 | 要求 |
|---|---|
| 操作系统 | Linux(amd64 或 arm64) |
| PostgreSQL | 15+ |
| Redis | 7+ |
| 权限 | root |
安装 PostgreSQL 和 Redis(如果还没有)
bash
# Ubuntu/Debian
sudo apt update
sudo apt install -y postgresql postgresql-contrib redis-server
# 启动服务
sudo systemctl start postgresql redis-server
sudo systemctl enable postgresql redis-server
# 为 Sub2API 创建数据库和用户
sudo -u postgres psql << 'EOF'
CREATE USER sub2api WITH PASSWORD 'your_secure_password';
CREATE DATABASE sub2api OWNER sub2api;
GRANT ALL PRIVILEGES ON DATABASE sub2api TO sub2api;
EOF一键安装
bash
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash脚本自动完成:
- 检测系统架构(amd64/arm64)
- 从 GitHub Releases 下载最新预编译二进制
- 安装到
/opt/sub2api - 创建 systemd 服务
- 配置系统用户和权限
启动服务
bash
# 启动
sudo systemctl start sub2api
# 设置开机自启
sudo systemctl enable sub2api
# 查看状态
sudo systemctl status sub2api服务启动后,打开浏览器访问:
http://你的服务器IP:8080
首次访问会进入安装向导,引导你完成:
- 数据库连接配置
- Redis 连接配置
- 管理员账号创建
安装向导配置
数据库配置:
| 字段 | 填写内容 |
|---|---|
| Host | localhost |
| Port | 5432 |
| User | sub2api |
| Password | 你设置的数据库密码 |
| Database | sub2api |
Redis 配置:
| 字段 | 填写内容 |
|---|---|
| Host | localhost |
| Port | 6379 |
| Password | (留空,如无密码) |
管理员账号:设置你的邮箱和密码,这是登录管理后台的凭证。
配置接入 Claude Code
部署完成后,在管理后台添加 Claude 账号,生成 API Key,然后在 Claude Code 里配置:
bash
export ANTHROPIC_BASE_URL="http://你的服务器IP:8080/anthropic"
export ANTHROPIC_AUTH_TOKEN="sk-你生成的APIKey"日常运维命令
bash
# 查看实时日志
sudo journalctl -u sub2api -f
# 重启服务
sudo systemctl restart sub2api
# 停止服务
sudo systemctl stop sub2api一键升级
登录管理后台,点击左上角「检查更新」按钮,Web 界面引导你完成:
- 自动检测新版本
- 一键下载并应用更新
- 支持回滚
卸载
bash
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash -s -- uninstall -yNginx 反向代理(推荐)
如果用 Nginx 做反代,在 http 块里加一行,否则 Codex CLI 的 sticky session 会失效:
nginx
http {
underscores_in_headers on; # 必须加这行!
...
}和其他安装方式的区别
| 脚本安装 | Docker Compose | 源码编译 | |
|---|---|---|---|
| 难度 | ⭐(最简单) | ⭐⭐ | ⭐⭐⭐⭐ |
| 环境隔离 | 无(跑在主机) | Docker 隔离 | 无 |
| 迁移便利性 | 一般 | 简单(tar 打包) | 一般 |
| 适合 | 新手、快速部署 | 生产环境推荐 | 开发者 |
来源:github.com/Wei-Shaw/sub2api | 整理:ClaudeEagle