教程

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

相关文章推荐

教程Sub2API 源码编译部署教程:Go + Vue 3 自定义构建 AI API 中转网关开发者指南Sub2API 源码编译完整指南:Go/Node.js/pnpm 环境搭建、前后端分别编译、-tags embed 嵌入前端、config.yaml 详细配置、开发热重载、Ent/Wire 代码生成、systemd 生产部署,面向开发者和需要自定义的用户。2026/4/14教程Sub2API Docker Compose 部署教程:生产环境最佳方案,含迁移和 Nginx 配置Sub2API Docker Compose 生产环境部署完整指南:一键脚本自动生成密钥、手动配置精细控制、本地目录版和命名卷版对比、升级、tar 一键迁移、Nginx 反代 HTTPS 配置,官方推荐方案。2026/4/14教程Hermes Agent 六种安装路径详解:VPS、Mac、WSL2、Docker、Pinokio、ServerlessHermes Agent 六种安装方式完整指南:VPS 一键部署(推荐)、Mac 本地 + Ollama、Windows WSL2、Docker Compose、Pinokio 无命令行、Modal/Daytona Serverless,含从 OpenClaw 迁移方法和常见报错解决。2026/4/15教程Hermes Agent 安装配置教程:从零到 Telegram 控制 AI Agent,含 Docker 沙箱Hermes Agent 完整安装配置教程:一键安装、OpenRouter/Anthropic/Ollama 提供商选择、Telegram Bot 配置、Docker 沙箱部署、MCP 工具接入和社区技能安装,含常见报错解决方案。2026/4/13教程Claude Code 新手入门完整教程:安装、登录、第一个任务全流程(2026 最新)Claude Code 新手入门完整教程:从安装到第一个任务全流程,涵盖 macOS/Windows/Linux 安装、常见报错处理、核心命令速查和 5 个高频使用场景。2026/4/9教程OpenClaw Windows 安装完全指南:WSL2 配置、PowerShell 安装与常见问题OpenClaw 在 Windows 上的完整安装教程:为什么推荐 WSL2、WSL2 安装与配置步骤、PowerShell 一键安装脚本、Windows 防火墙与端口设置、Telegram/Discord 频道配置、开机自启动设置,以及 Windows 特有的常见问题排查(路径问题、权限问题、WSL 网络访问)。2026/3/17