小火箭导入订阅失败与连接失败：Shadowrocket 排查

小火箭是 iPhone 用户使用机场订阅时最常见的客户端。它的问题往往不是「软件坏了」，而是几个小环节同时出错：下载小火箭的 Apple ID 账号、订阅的添加方式、VPN 配置授权、路由与 DNS 设置。这些环节在 iOS 上都有各自的门槛，任何一个没通过，用户看到的都是一句笼统的「连不上」。

先把现象分成两类，后面的路径完全不同：

• 导入阶段失败：添加订阅没反应、报错、节点列表为空。
• 连接阶段失败：节点有了，点连接后要么连不上，要么显示已连接但网页打不开。

先做一个 30 秒的体检

在动手之前，先回答这几个问题，它们能直接缩小范围：

问题	如果答案是「是」
这台 iPhone 能用蜂窝数据打开 Safari 吗？	排除手机本身没网
订阅链接在 Safari 里打开，能看到一串内容或下载动作吗？	机场订阅正常，问题在小火箭
刚更新过 iOS 或小火箭吗？	系统更新后常需要重新授权 VPN 配置
同一订阅在别的设备或客户端能用吗？	是则确定是这台手机的问题
面板里流量没用完、套餐没过期吗？	流量耗尽会让所有节点同时失效

如果最后一项你还没看，先去机场面板确认，节省很多时间。

小火箭失败的常见原因

原因	现象	验证办法
添加时类型选错	把订阅链接当成单个服务器添加	添加页顶部类型应为订阅（Subscribe）
链接被截断或带了多余空格	报错或无节点	重新复制，粘贴到备忘录检查整行
订阅格式不匹配	下载到的是 YAML 配置	回面板找通用订阅或小火箭专用链接
更新时走了失效的代理	一直转圈	断开 VPN 后再更新
VPN 配置未授权或被系统清掉	点连接弹窗后无反应	删除旧的 VPN 配置，重新连接授权
全局路由选了不合适的模式	国内外网站都打不开	切到「配置」，规则或默认「代理」测试
自定义规则/配置文件写错	导入后一连就断	切换回默认配置文件
DNS 冲突	能连但网页打不开	关闭自定义 DNS 或使用默认
节点协议超出当前版本支持	个别节点显示灰色或报错	更新小火箭，或换其他协议节点
低电量模式或后台限制	连了一会儿就断	关闭低电量模式，允许后台刷新

小火箭导入订阅失败：按顺序排查

第一步：用 Safari 看订阅是否真的可用

把链接粘贴到 Safari 地址栏。能看到内容或触发下载，说明机场侧没问题；若提示页面不存在或无法打开，回到面板重新复制，或联系机场确认域名。这一步和电脑端 Clash 导入失败 的第一步逻辑是一致的：永远先把机场和客户端分开。

第二步：确认添加方式

打开小火箭，点右上角加号。关键是类型要选对：粘贴订阅链接时，类型应选「Subscribe」（订阅），而不是 Type 里的各种单节点协议。不同版本界面文字略有差异。很多新手把订阅链接直接当作服务器地址填写，结果只生成一条无效节点。

许多机场的订阅链接还可以用「扫码」「剪贴板自动识别」添加。如果复制链接后打开小火箭会弹出「检测到剪贴板里的链接」，点确认即可。

第三步：把更新方式换成直连

首次导入时没有可用节点，如果 VPN 处于开启状态，订阅下载就会走一个不通的代理。操作：先关闭小火箭首页的连接开关，再下拉列表刷新订阅，或点订阅条目选择「更新」。这样下载走的是手机的直连网络。

第四步：确认列表内容

更新成功后看节点列表。最上方若有名字像「剩余流量」「到期时间」的节点，是信息条，不可连接。往下滑看是否有真正的节点。如果只有信息条，说明订阅的数据不完整，联系机场并附上第一步在 Safari 里看到的结果。

第五步：升级与重新安装

App Store 里的小火箭有更新时先更新。若更新后某个协议的节点无法使用，查看机场用的协议：以 airports.ts 中的数据为例，二猫云、光速云等以 Trojan、Shadowsocks 为主，这些在小火箭里一般都支持；新协议如 VLESS 需要较新的版本。注意：卸载重装会丢失本地配置，重装之前把订阅链接保存好。

小火箭连接失败：按顺序排查

第一步：重建 VPN 配置

iOS 的 VPN 配置由系统管理。第一次连接时会弹出「想要添加 VPN 配置」的授权框，需要输入锁屏密码或 Face ID。如果以前授权过，但近期系统升级或恢复了备份，配置可能失效。

操作：到手机「设置 → 通用 → VPN 与设备管理」（不同系统版本路径略有差异）里，删除小火箭的 VPN 配置；回到小火箭，重新点连接，让系统重新弹出授权。

第二步：测当前节点

在节点列表里长按或点测速，看延迟。如果当前节点显示超时，换另一个地区的节点再试。全部节点超时就不属于小火箭的问题，转到 节点全部超时。

第三步：检查全局路由

小火箭首页有「全局路由」选项，通常有「配置」「代理」「直连」「场景」几种。不同版本名称略有差异。排查时选「代理」让所有流量走节点，看网页能否打开：能打开，说明节点没问题，之前的配置文件规则有毛病；还是打不开，则问题在节点或 DNS。

第四步：回到默认配置文件

如果你导入过别人分享的配置文件（带自定义规则），先切回默认配置再测。网上流传的规则集有些年久失修，里面的规则源域名失效，会拖垮整个配置。

第五步：检查 DNS

不要在不明白的情况下乱改 DNS。若你之前改过，把它恢复为默认；一些情形下，错误的 DNS 会让节点连得上、网页却解析失败。判断办法：访问一个直接填 IP 的外网地址能打开，而域名打不开，基本就是 DNS 问题。

第六步：看后台限制

iPhone 开着低电量模式，或者在设置里关闭了小火箭的后台 App 刷新，连接容易在锁屏后断开。这类问题的特点是「刚连上时好用，放一会儿就断」，更详细的断线分析见 频繁断线篇。

决策树

1. Safari 能打开订阅链接？否 → 联系机场或重新复制。
2. 添加类型选的是订阅吗？否 → 重新添加。
3. 断开 VPN 后能更新订阅吗？否 → 看网络与链接，仍不行带证据提工单。
4. 列表里有真实节点吗？否 → 订阅内容问题，提工单。
5. 点连接没弹授权或无反应？是 → 删除并重建 VPN 配置。
6. 已连接但打不开网页？ → 全局路由切「代理」；不行换节点；还不行回默认配置与默认 DNS。

仍然不行怎么办

走到这里，大概率是某个节点或订阅层面的问题，而不是小火箭本身。给机场提工单时请附：

• 小火箭版本号（在设置或关于页面里能看到）、iOS 系统版本。
• 添加订阅时的操作：用的是扫码、复制链接，还是别的。
• 你在 Safari 里打开订阅链接看到的内容（可以只说「能看到节点内容」「报错 xxx」）。
• 小火箭里的错误提示，或日志（设置里有日志功能）。
• 同一订阅在别的设备或客户端上的表现。
• 面板里的流量与到期状态截图（可以打码邮箱）。

另外有一种与小火箭相关的特殊情形：App 在你所在的 App Store 里根本搜不到、或者装完不久被标记为不可用。这与 Apple ID 的地区和账号状态有关，操作步骤与风险提示集中放在 Apple ID 地区教程 里，请只在官方的 Apple 页面输入 Apple ID 密码。

如果你的机场不是通用订阅（比如 Firefly 改成了专属客户端登录，不再提供订阅链接），那就根本没法导入小火箭，别在这上面浪费时间。想确认哪些机场的订阅可以导入小火箭，看 小火箭机场推荐；也可以考虑用 Quantumult X 作为替代客户端。想了解订阅链接与单节点链接的区别，可读 订阅链接是什么。