> ## Content Index
> Fetch the complete content index at: https://isoziyuan.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# 小白零基础：5分钟搞定 Sub2API 大模型中转站搭建与全自动管理（独家优化版）
- URL: https://isoziyuan.com/p/100164/
- Published: 2026-09-19T15:47:02.000Z
- Updated: 2026-09-19T15:50:02.000Z
- Description: Sub2API 生产级 Linux VPS 一键部署与全能运维管理脚本：支持零配置自动 HTTPS、独创自适应双模、独家解决 Gemini 400 与 Thinking 思考标签污染，自带全套终端运维面板。
- Author: Isoziyuan
- Tags: 教程, 脚本, AI

> **适合人群**：手头有 Linux VPS、想自建 AI API 分发网关、搭建大模型拼车车队、或解决 Gemini 工具调用报错的小白及开发者。

---

## 什么是 Sub2API？

**Sub2API** 是一款开源的高性能 AI 订阅分发与网关系统。它可以将各种平台的订阅（如 OpenAI、Claude、Gemini 等）整合并转化为标准的 OpenAI 格式 API 接口，供 NextChat、Chatbox、LobeChat、Codex 等各种客户端调用。

官方原生部署需要手工配环境、装 Docker、搭数据库和反代，小白容易踩坑。为此，我们制作了这套**生产级全自动部署运维脚本**，一行命令搞定所有繁杂配置！

---

## 独家特色与升级亮点

相比官方原版，本套脚本专门针对小白与实际生产场景做了深度优化：

1. **零配置自动 HTTPS**：内置 Caddy 2 网关，只要域名解析到 VPS，全自动申请并终身自动续期 SSL 证书。
2. **独创自适应双模（不炸现有网站）**：
3. **纯净 VPS**：自动占用 80/443 配置域名 HTTPS。
4. **已有网站/节点的 VPS**：自动检测端口冲突，无缝切换为自定义端口共存模式（如 18080），现有业务零中断。
5. **独家内置 Gemini 双向适配层**：
6. **防报错**：自动修复客户端传参携带 `const`/`anyOf` 导致 Gemini 原生接口频报 `400` 的顽疾。
7. **防污染**：流式/非流式全场景自动剥离 `<thinking>` 思考标签并转为标准的 `reasoning_content`。
8. **全套终端运维面板**：在终端随时输入 `sub2api` 即可呼出图形化菜单（支持状态查看、分流日志、一键备份、热重启、在线更新）。

---

## 极速搭建步骤（三步搞定）

### 第一步：准备一台 VPS 并放行端口

- **系统推荐**：Ubuntu 20.04/22.04/24.04、Debian 11/12、CentOS 7+、AlmaLinux。
- **端口放行**：
- 如果使用域名直连：请放行 **80** 和 **443** 端口，并将域名 A 记录解析到 VPS IP。
- 如果已有现有网站共存：请放行自定义端口（默认 **18080**）。

### 第二步：运行一键安装命令

以 `root` 用户 SSH 连接到 VPS 终端，粘贴执行以下命令：

```bash
curl -fsSL https://raw.githubusercontent.com/yys9253462-gif/sub2api-vps/main/sub2api.sh -o sub2api.sh && chmod +x sub2api.sh && bash sub2api.sh

```

### 第三步：按提示输入信息

终端会弹出交互向导，根据提示一路回车或输入： 1\. **模式选择**：若检测到端口冲突，按推荐选择 `1`（独立端口共存）；纯净机器直接输入绑定的域名。 2\. **管理员邮箱与密码**：输入你的登录邮箱和自定义密码（支持回车使用随机安全密码）。 3\. **Gemini 适配层**：直接回车选择 `Y`（开启优化）。

稍等 1\~2 分钟，脚本会自动安装 Docker、拉取镜像、初始化数据库并启动。屏幕最后会打出登录地址和账号密码！

---

## 日常运维：输入 `sub2api` 即可管理

在 VPS 终端的任何目录下，输入：

```bash
sub2api

```

即可随时打开运维控制台： - **查看状态与端口** \- **查看各组件实时日志** \- **一键全量备份**（自动备份 PostgreSQL 数据库与 Redis，权限自动锁定） - **平滑重启 / 停止 / 启动服务** \- **在线一键更新 Sub2API 至最新版**

也可以直接带命令行参数执行快速操作：

```bash
sub2api status   # 查看运行状态
sub2api restart  # 重启所有服务
sub2api backup   # 执行全量热备

```

---

## 开源项目地址

- GitHub 仓库：[https://github.com/yys9253462-gif/sub2api-vps](https://github.com/yys9253462-gif/sub2api-vps?ref=isoziyuan.com)
- 欢迎体验、提建议并顺手点个 Star ⭐️！