你刚拿到一条subscription link,想把它加进 Shadowrocket(小火箭)、Clash 或者 Surge,结果对着教程Copy link → 打开 App → 找到「添加订阅」 → 长按粘贴 → 命名 → 保存,一步错就得重来?这篇教程换个思路:用 deep link(深度链接)One-tap import,在网页上点一下按钮,浏览器自动拉起客户端、自动把订阅写进去——五个主流客户端全覆盖,手动复制粘贴这套流程可以彻底告别了。
本文 2026 年持续更新,覆盖 Shadowrocket、Clash 系(FlClash / Clash Verge Rev)、Surge、Loon、Stash 五大客户端的One-tap import与手动兜底方法,文末附完整对比表。
一、先说痛点:手动复制粘贴到底烦在哪
绝大多数机场和教程,至今还在教你「手动添加订阅」。这套流程的坑非常多:
- 链接复制不全:subscription link往往很长,在手机上长按选中经常漏掉开头的
https或末尾的参数,Import后一片空白。 - 粘贴位置找不对:不同客户端「添加订阅」的入口藏在不同地方,Shadowrocket 在右上角加号、Clash 在配置页、Surge 又是另一套,新手很容易点错。
- 多设备重复劳动:手机、平板、电脑各导一遍,每次都要重新复制、重新粘贴。
- 格式不匹配直接失败:同一条订阅,Clash 要 YAML 格式、Shadowrocket 要 base64 格式,手动Import时如果客户端没拿到对的格式,就会出现「Import成功但没有节点」。
这些坑的共同根源是:把「选对客户端、选对格式、找对入口、填对链接」这四件事全甩给了用户。 而 deep link One-tap import,就是把这四件事交给机器自动完成。
二、One-tap import的原理:deep link + UA 内容协商
很多人以为「One-tap import」只是个噱头,其实它背后是两套成熟技术的组合,理解了原理你就知道它为什么更可靠。
1. deep link:让网页能「拉起」客户端
普通链接以 https:// 开头,点击后在浏览器里打开。而 deep link 用的是客户端自己Sign up的专属协议头,比如 clash://、shadowrocket://、surge://。当你点击这种链接,操作系统会识别协议头,直接唤起对应的 App,并把subscription link作为参数一起传过去。整个过程就是一次点击,没有复制、没有粘贴、没有找入口。
不同客户端Sign up的协议头和参数格式各不相同,这也是为什么「One-tap import」必须为每个客户端单独生成对应的链接(下文每节会讲到差异)。
2. UA 内容协商:同一条订阅,自动给对的格式
前面提到 Clash 要 YAML、Shadowrocket 要 base64。我们的订阅地址做了 UA(User-Agent,客户端标识)内容协商:当 Clash 系客户端来拉取订阅时,服务器识别到它的 UA,自动返回 YAML 格式;当 Shadowrocket、Loon 等来拉取时,默认返回 base64 格式。
换句话说,你永远只需要记住同一条subscription link,无论用which client,服务器都会自动把格式调成它能读懂的那一种。这就从根上消灭了「Import成功但没有节点」这类格式不匹配的问题。
一句话总结原理:deep link 负责「点一下就拉起客户端并自动写入」,UA 内容协商负责「自动给对的格式」。 两者配合,才是真正的One-tap import。
三、五大客户端分步Import教程
下面按客户端逐个讲。每节都给出One-tap import(首选)和手动添加(兜底)两种方法。One-tap import只需在Account或本页对应按钮上点击即可,浏览器会自动拉起客户端完成写入。
1. Shadowrocket(小火箭,iOS)—— 小火箭添加节点最快的方式
Shadowrocket 是 iOS 上最常用的客户端之一,Note它在中国区 App Store 已下架,需要用美区 Apple ID Download(不会弄的可以走微信代下美区 ID,这是目前最省事的办法)。
One-tap import:在Account点击「One-tap import Shadowrocket」 button.它生成的链接是通用 sub:// 格式(即 sub://{base64订阅地址}#SSRocket),点击后 Safari 会提示「在 Shadowrocket 中打开」,确认后订阅自动写入。这是目前实测兼容性最好的小火箭添加节点方式。
手动添加(兜底):
- 复制Your subscription link。
- 打开 Shadowrocket,点右上角加号 +。
- 「类型」选 Subscribe(订阅),把链接粘贴到 URL 栏,备注随意填,点右上角完成。
- 回到首页,在Nodes里下拉刷新一次即可拉到全部节点。
2. Clash 系(FlClash / Clash Verge Rev)—— Clash 添加订阅
Clash 内核覆盖面最广:Windows / macOS / Linux 推荐 Clash Verge Rev,安卓推荐 FlClash,两者用同一套Import协议。
One-tap import:点击「One-tap import Clash」按钮,生成的链接是 clash://install-config?url={订阅地址}&name=SSRocket。点击后系统会拉起 Clash Verge Rev / FlClash,并自动把订阅作为一个新的「配置 / Profile」写入。因为走的是 UA 内容协商,Clash 拉取时服务器会自动返回 YAML,节点直接到位。
手动添加(兜底):
- 复制subscription link。
- 打开客户端,进入 「订阅 / Profiles」 页。
- 把链接粘贴进「从 URL Import」输入框,点Import。
- Import后在 「代理 / Proxies」 页选节点,或选「自动 / Auto」让它挑最快的。
3. Surge(iOS / macOS)—— Surge 配置Import
Surge 功能强、规则灵活,是进阶用户的首选。它的 deep link 有一个容易踩的细节:协议头是三道斜杠。
One-tap import:点击「One-tap import Surge」按钮,生成的链接是 surge:///install-config?url={订阅地址}(Note surge: 后面跟着三条斜杠 ///,这是 Surge 的规范写法,少一条斜杠会Import失败)。点击后 Surge 会拉起并把订阅装成一个新配置。
手动添加(兜底):打开 Surge → 「配置 Profiles」→「Download配置 / Download Config」→ 粘贴subscription link → 确认。Download后在「策略组」里选节点即可。
4. Loon(iOS)—— Loon 订阅Import
Loon 在 iOS 进阶圈子里口碑很好,规则和脚本能力接近 Surge,价格更友好。
One-tap import:点击「One-tap import Loon」按钮,生成的链接是 loon://import?sub={订阅地址}&name=SSRocket。点击后 Loon 拉起并把订阅作为一个新的「订阅」条目写入。
手动添加(兜底):打开 Loon →「配置」→「订阅」→ 右上角加号 → 粘贴subscription link、填备注 → 保存 → 拉一次更新即可看到节点。
5. Stash(iOS)—— Stash 订阅Import
Stash 是 iOS 上的 Clash 内核客户端,界面清爽,和 Clash 用同一套 YAML 格式,对老 Clash 用户非常友好。
One-tap import:点击「One-tap import Stash」按钮,生成的链接是 stash://install-config?url={订阅地址}&name=SSRocket。因为 Stash 也是 Clash 内核,UA 内容协商会自动返回 YAML,Import后节点直接可用。
手动添加(兜底):打开 Stash →「配置」→ 右上角加号 →「从 URL 安装」→ 粘贴subscription link → 安装。装好后下拉刷新即可。
四、FAQ排查
问题一:Import后客户端里没有节点(空列表)
这是最常见的问题,通常有两个原因:
- 没有刷新订阅:Import只是把「名单地址」存进了客户端,节点是客户端去地址拉回来的。Import后请在客户端里下拉刷新 / 点刷新按钮更新一次订阅。
- 格式没匹配上(手动Import时):如果你是手动Copy linkImport的,且客户端 UA 识别异常,可能拿到了不匹配的格式。优先改用One-tap import按钮,让 UA 内容协商自动给对格式。
问题二:网站上换了节点,App 里没变化 / 订阅不更新
subscription link是同一条,但客户端不会自动同步。你在网站切换节点、或我们优化了线路后,要回到客户端里更新一次订阅(Shadowrocket 下拉刷新;Clash / Stash 点配置卡片上的刷新图标 ↻;Surge / Loon 同理拉一次更新)。日常更新订阅不需要重新Copy link、不需要重新Import,链接始终是同一条。
问题三:点了One-tap import按钮,没反应 / 提示「未检测到客户端」
deep link 能拉起客户端的前提是这个客户端已经装好了。如果点击后 1.5 秒内没动静、或弹出「未检测到客户端」,说明对应 App 还没安装:先去 App Store / 官网装好客户端,再回来点One-tap import。iOS 上还要Note,部分浏览器(如某些内置浏览器)会拦截 deep link,建议在 Safari 里打开本页再点Import。
问题四:UA 不识别 / Clash 拿到了 base64 not just YAML
极少数第三方修改版或老版本客户端,会发送非标准 UA,导致服务器没认出它是 Clash 系而返回了默认的 base64。遇到这种情况:优先升级到客户端最新正式版(FlClash / Clash Verge Rev / Stash 官方版 UA 都是标准的);仍不行可在客户端的订阅设置里手动指定为 Clash / YAML 解析模式。
五、五大客户端One-tap import对比表
| 客户端 | platform | deep link 协议格式 | 订阅格式 | Import难度 |
|---|---|---|---|---|
| Shadowrocket(小火箭) | iOS(需美区 Apple ID) | sub://{base64}#名称 | base64 | ★ 最简单 |
| Clash Verge Rev / FlClash | Windows / macOS / Linux / 安卓 | clash://install-config?url=… | YAML(UA 自动) | ★ 最简单 |
| Surge | iOS / macOS | surge:///install-config?url=…(三斜杠) | Surge 配置 | ★★ Note三斜杠 |
| Loon | iOS | loon://import?sub=… | 通用订阅 | ★ 简单 |
| Stash | iOS | stash://install-config?url=… | YAML(UA 自动) | ★ 简单 |
怎么选? iPhone / iPad 首选 Shadowrocket(最省心),追求规则和脚本能力选 Surge 或 Loon,习惯 Clash 生态选 Stash;电脑端和安卓统一用 Clash 系(Clash Verge Rev / FlClash),一套订阅全platform通用。
六、小结
手动复制粘贴订阅之所以容易出错,是因为它把「选客户端、选格式、找入口、填链接」全压给了用户。One-tap import用 deep link 把这些步骤自动化,再用 UA 内容协商自动匹配格式,五大客户端都能做到「点一下就装好」。记住核心一句:Import只做一次,日常换节点只需在客户端里更新一下订阅,链接永远是同一条。
No subscription yet?开通后即可在Account看到Your 专属subscription link和五大客户端One-tap import button.👉 View plans | 已有Account?前往Account | 第一次用?看图文教程