教程

Sub2API 脚本一键安装教程：5 分钟部署 Claude OpenAI 订阅转 API 中转网关

Sub2API 脚本安装完整教程：一行命令安装 Claude/OpenAI/Gemini 订阅中转网关，含 PostgreSQL/Redis 配置、安装向导、systemd 管理、Nginx 反代、一键升级和卸载，适合 Linux 新手快速部署。

2026/4/143分钟 阅读ClaudeEagle

Sub2API 是一个开源 AI API 网关平台，可以把 Claude、OpenAI、Gemini、Antigravity 等订阅账号统一转成标准 API 接口，支持多人拼车、精准按 Token 计费、智能负载均衡。

本文介绍方式一：脚本一键安装——最适合初学者，5 分钟完成部署。

适用场景

  • 你有一台 Linux 服务器（VPS）
  • 不熟悉 Docker，想用最简单的方式
  • 希望安装后直接跑在系统上，便于 systemd 管理

前置条件

组件要求
操作系统Linux（amd64 或 arm64）
PostgreSQL15+
Redis7+
权限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

脚本自动完成：

  1. 检测系统架构（amd64/arm64）
  2. 从 GitHub Releases 下载最新预编译二进制
  3. 安装到 /opt/sub2api
  4. 创建 systemd 服务
  5. 配置系统用户和权限

启动服务

bash
# 启动
sudo systemctl start sub2api

# 设置开机自启
sudo systemctl enable sub2api

# 查看状态
sudo systemctl status sub2api

服务启动后，打开浏览器访问：

http://你的服务器IP:8080

首次访问会进入安装向导，引导你完成：

  • 数据库连接配置
  • Redis 连接配置
  • 管理员账号创建

安装向导配置

数据库配置：

字段填写内容
Hostlocalhost
Port5432
Usersub2api
Password你设置的数据库密码
Databasesub2api

Redis 配置：

字段填写内容
Hostlocalhost
Port6379
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 -y

Nginx 反向代理（推荐）

如果用 Nginx 做反代，在 http 块里加一行，否则 Codex CLI 的 sticky session 会失效：

nginx
http {
    underscores_in_headers on;  # 必须加这行！
    ...
}

和其他安装方式的区别

脚本安装Docker Compose源码编译
难度⭐（最简单）⭐⭐⭐⭐⭐⭐
环境隔离无（跑在主机）Docker 隔离无
迁移便利性一般简单（tar 打包）一般
适合新手、快速部署生产环境推荐开发者

来源：github.com/Wei-Shaw/sub2api | 整理：ClaudeEagle