小白零基础：5分钟搞定 Sub2API 大模型中转站搭建与全自动管理（独家优化版）

适合人群：手头有 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 终端，粘贴执行以下命令：

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 终端的任何目录下，输入：

sub2api

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

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

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

开源项目地址

• GitHub 仓库：https://github.com/yys9253462-gif/sub2api-vps
• 欢迎体验、提建议并顺手点个 Star ⭐️！