小白必看：sub2api 搭建保姆级教程

最近看到群里很多朋友在问 sub2api 怎么搭，刚好我自己也有这个需求，以前每次换手机或者重装 APP 都得手动复制订阅链接，实在麻烦。折腾了一番，终于把它搞定了，今天就来手把手教大家如何从零开始搭建自己的订阅转换 API。

什么是 sub2api？为什么要用它？

图示说明 sub2api 如何将原始订阅链接转换为目标客户端 API 接口的流程。

简单来说，sub2api 就是把你的订阅链接转换成一个 API 接口。这样做的好处主要有两点：

1. 多设备同步方便：你只需要维护一个订阅地址，通过 API 生成的标准配置，所有客户端都可以通用。
2. 安全性提升：避免在不可信的第三方平台上直接输入原订阅链接，保护节点隐私。

特别是如果你手里有好几个机场，或者经常折腾各种客户端，这个工具绝对是神器。

准备工作

在开始之前，你需要准备以下几样东西：

• 一台 VPS（哪怕是最便宜的 1H1G 也没问题，或者本地有 Docker 环境也行）。
• 一个域名（可选，如果用 IP 访问可以不用，但域名加 CDN 会更稳）。
• 你的订阅链接。

第一步：安装 Docker 环境

在终端中执行 docker run 命令成功启动 sub2api 服务的代码截图。

为了省事，我们直接用 Docker 部署。如果你的 VPS 还没装 Docker，执行下面这几条命令一键安装：

curl -fsSL https://get.docker.com | sh
systemctl start docker
systemctl enable docker

安装完成后，输入 docker -v 确认一下是否成功。

第二步：拉取并运行 sub2api 镜像

这里我推荐用 sub2api 这个开源项目，支持多种订阅格式的转换。直接运行下面的命令启动容器：

docker run -d \
  --name sub2api \
  -p 25500:25500 \
  -e SUB2API_API_TOKEN=your_password_here \
  -e SUB2API_DEFAULT_SUBSCRIBE_URL=your_subscribe_url \
  careywang/sub2-api

注意：

• 将 your_password_here 改成你自己的 API 密码，防止别人蹭你的接口。
• 将 your_subscribe_url 改成你真实的订阅地址。
• 25500 是端口号，可以根据需要修改。

第三步：生成并使用转换链接

容器启动后，你的转换接口就生成了。通常格式是这样的：

http://你的VPS_IP:25500/sub?target=surge&url=你的订阅链接&token=your_password_here

• target=surge：转换的目标配置，支持 sing-box、clash、quantumultx 等，根据你的客户端切换。
• 你可以把这个链接填到客户端的“从 URL 下载配置”里，或者做成短链接分享。

常见问题与解决方案

Q: 为什么访问接口显示 403 Forbidden？ A: 检查一下 SUB2API_API_TOKEN 是否正确，或者在请求头里带上 Token。如果还是不行，看看防火墙是否放行了 25500 端口。

Q: 转换后的节点怎么连不上？ A: 这通常是源订阅的问题，先直接用源订阅链接测试一下节点是否可用。另外，某些转换格式（如 Clash Meta）对特定协议支持更好，可以尝试切换 target 参数。

Q: 想要更高级的功能怎么办？ A: 支持前端面板的项目很多，比如 sub-web，你可以配合 Nginx 反向代理给它套个域名和 HTTPS 证书，体验会更佳。

总结

sub2api 的搭建其实并不难，核心就是利用 Docker 快速部署一个转换服务。对于新手来说，不用去配置复杂的后端环境，照着命令敲几行就能搞定。如果你还在为多客户端管理订阅发愁，赶紧动手试试吧！