Shadowrocket 怎么添加机场订阅 订阅地址与节点更新完整教程

订阅下发协议与内存映射机制#

机场服务端在接收到客户端的订阅请求后，通常会根据请求头中的客户端特征，动态组装出站节点数据。常见下发格式包括传统的 Base64 聚合编码、Clash 专用的 YAML 数据树，以及现代化的 SIP008 JSON 格式。

小火箭内核在收到网络响应字节流后，首先会在内存缓冲区进行解密与解码操作。若下发内容为 Base64 编码，内核会逐行拆解出以协议 scheme 开头的节点字符串（例如以 ss://、vmess://、trojan://、vless:// 或 hysteria2:// 开头的单行链接）。解码器会对这些链接中的哈希参数、查询字符串和路径伪装字段进行反序列化，提取出远端服务器地址、端口、加密认证密钥以及 SNI 伪装域名等属性，最终实例化为一个个结构化的代理节点对象，保存在本地数据库中。

底层原理分析#

一键导入的底层逻辑依赖于 iOS 操作系统的 Universal Links 与 URL Scheme 机制。当用户在 Safari 浏览器中点击“一键导入小火箭”时，网页前端实际上执行了一段形如 window.location.href = "shadowrocket://add/sub://" + base64(subscription_url) + "?title=" + encodeURIComponent(airport_name) 的重定向指令。

iOS 操作系统拦截到 shadowrocket:// 这一专有协议头后，会检索系统中已安装的应用清单。确认 Shadowrocket 具备该协议的处理权限后，系统弹出授权确认框。用户点击确认后，操作系统即刻唤起小火箭并将整串编码参数传递给应用沙盒。小火箭的入口调度器捕获到传入的 URL 参数后，立即调用内部下载管理器，向远程服务器发送第一笔 GET 请求完成初始化同步。

实操步骤#

1. 在 iPhone 自带的 Safari 浏览器中，登录你的机场官方网站用户中心；
2. 在控制面板找到“便捷导入”或“一键订阅”功能区；
3. 点击“导入到 Shadowrocket”或“一键导入小火箭”按钮；
4. Safari 浏览器会自动弹窗提示“在‘Shadowrocket’中打开吗？”，果断点击“打开”；
5. 系统自动跳转至小火箭客户端，界面会闪过拉取进度条；
6. 稍等数秒，小火箭主界面上方会自动新增一个以机场名称命名的服务器分组，下方整齐排列着香港、日本、新加坡、美国等各地区可用节点。

光学识别与数据提取过程#

小火箭调用了苹果系统的 AVFoundation 高性能图像处理框架，能够对高密度的二维码矩阵进行毫秒级识别与纠错。电脑屏幕上的二维码通常由机场后端根据订阅地址即时生成，其承载的内容通常是经过 URL 编码的完整订阅链接或节点聚合字符串。

在对焦成功的一瞬间，扫描模块会剥离掉外围的控制位，提取出纯净的文本数据流。如果文本以 sub:// 开头，小火箭会识别出这是一个远端订阅集合，随后自动将其重定向到“添加订阅”流程；如果文本以单个节点协议开头，小火箭则会将其作为单节点独立保存。对于批量导入，务必确保扫描的是机场的“订阅二维码”，而非单一节点的连接二维码。

实操步骤#

1. 在电脑端打开机场用户后台，点击“二维码导入”或“显示小火箭订阅二维码”；
2. 拿起 iPhone 打开 Shadowrocket 客户端；
3. 观察小火箭主界面的左上角，点击小巧的“扫码”扫描图标（方框带扫描线）；
4. 首次使用时若弹出相机权限申请，必须点击“允许”；
5. 将手机镜头对准电脑屏幕上的订阅二维码，保持对焦清晰；
6. 小火箭捕捉到二维码内部包含的 sub:// 或 shadowrocket:// 协议字符串后，会发出一声清脆的提示音；
7. 软件自动解析二维码携带的完整 URL 地址，立即向远端发起节点拉取，并在主界面生成对应节点列表。

关键配置项与高级属性详解#

1. 类型（Type）选择：进入右上角加号页面后，第一行默认通常是“Shadowsocks”。千万不要直接在此处粘贴订阅链接！必须先点击类型行，在弹出的长列表中向下滑动，找到并勾选“Subscribe（订阅）”。如果在此处误保留了单节点协议类型而强行保存一串 HTTPS URL，小火箭会将整串网址误认作单个服务器地址，最终导致连接测试全线超时报错；
2. URL 输入栏：将机场后台复制好的完整订阅链接粘贴到此处。完整的订阅链接通常以 https:// 开头，且包含特定 token 鉴权参数与动态端口号；
3. 备注（Remark）栏：建议填写可读性强的名称（例如“极速专线 BGP 主力”），方便日后添加多个机场时进行清晰区分。若此处留空，小火箭会默认提取订阅域名作为分组备注；
4. 自定义请求头（User-Agent）：在高级选项中，高级用户还可以针对特定严格校验的机场注入自定义请求头字符串，防止服务端下发 403 阻断；
5. 保存与自动拉取：点击右上角“保存”按钮。小火箭会自动发起首次订阅拉取。回到主界面，点击刚刚新增的订阅条目，即可展开全部节点。

配置文件载入与规则映射深度解析#

通过配置文件挂载订阅，本质上是将“节点定义”与“路由分流策略”捆绑在一起进行一体化下发。小火箭的原生配置文件遵循标准的 ini 风格结构，通常由 [General]、[Proxy]、[Proxy Group]、[Rule] 和 [Host] 等关键段落构成。

当用户通过远程 URL 挂载此类配置文件时，小火箭会周期性拉取该文件的最新版本。在 [Proxy] 区域声明的节点会自动同步至主界面节点池；而在 [Rule] 区域编写的成百上千条分流规则（如基于域名、IP 网段、GeoIP 属性的路由指令）会瞬间覆盖本地原有的默认规则。这种方法极大方便了团队内部或家庭网络环境下的统一策略推送，使用者完全不需要手动挨个调整分流偏好。

实操步骤#

1. 在小火箭底部导航栏，点击切换到“配置”页面；
2. 观察界面右上角，点击加号（+）；
3. 在弹出的输入框中，输入机场提供的远程配置 URL 地址（例如 https://example.com/rules/firefly.conf），点击右上角“下载”；
4. 小火箭会自动将该配置文件下载至本地沙盒目录中；
5. 在配置列表中找到刚刚下载的文件，轻点选中它，在弹出菜单中点击“使用配置”；
6. 此时小火箭不仅接管了全部远程节点，还将该配置文件内置的分流路由、DNS 解析器和黑白名单策略全盘激活。

1. 手动即时更新（推荐日常使用）#

在遇到节点连通性变差或机场发送节点调整公告时，可随时执行手动即时更新：

• 全局批量更新：在小火箭主界面，用手指在屏幕顶部向下拉动并松开（如同刷新微信朋友圈），小火箭会立即对已添加的所有订阅并发发起更新请求；
• 单订阅针对性更新：在主界面找到特定的订阅分组，手指按住该分组条目向左滑动，点击弹出的黄色或蓝色“更新”按钮，仅单独同步该订阅。

2. 自动化后台定时更新（长期省心）#

为了杜绝每次翻墙前都要手动下拉的繁琐，可在小火箭设置中激活自动同步机制：

1. 点击底部导航栏的“设置”图标；
2. 找到并进入“订阅”选项；
3. 打开“打开时更新”开关：每次从后台切换回小火箭主应用时，系统自动在静默状态下检查并拉取最新节点；
4. 设置“自动后台更新”：勾选按时间间隔更新，推荐设置为“24 小时”或“12 小时”。不建议设置低于 1 小时，过于频繁的拉取不仅毫无意义，还会消耗手机宝贵的后台电量，并可能触发机场服务器的高频防护拉黑机制。

iOS 后台保活与后台静默刷新机制#

许多用户疑惑为什么开启了“自动后台更新”，有时隔了两天依然没有自动拉取最新节点。这与 iOS 系统底层的进程管理机制密切相关。

苹果为了极致的续航控制，对第三方应用的后台网络活动实施严格的沙盒限制。小火箭所依赖的后台更新是基于 iOS 的 Background App Refresh（后台应用刷新）机制运作的。系统会根据用户的日常使用习惯、手机当前剩余电量以及所处的 Wi-Fi 充电状态，动态分配数分钟的后台网络唤醒窗口。若用户经常开启低电量模式，或在系统设置中禁用了小火箭的后台应用刷新权限，后台自动更新就会被系统挂起。因此，确保在 iPhone 的“设置”->“通用”->“后台 App 刷新”中点亮 Shadowrocket 开关，是后台静默更新生效的前提。

终端抓取与 UA 校验实战#

我们可以使用 curl 模拟小火箭的原生请求头，在电脑或终端中排查订阅链接本身的可用性与服务端下发特征：

1
# 模拟小火箭客户端原生 User-Agent 发起订阅拉取测试
2
curl -ILsS -A "Shadowrocket/2247 CFNetwork/1494.0.7 Darwin/23.4.0" \
3
  "https://sub.airport-domain.example/api/v1/client/subscribe?token=secret123" | head -n 25

1
# 输出返回头中的订阅元数据 (剩余流量与过期时间)
2
curl -sI -A "Shadowrocket/2247" \
3
  "https://sub.airport-domain.example/api/v1/client/subscribe?token=secret123" | grep -i "subscription-userinfo"

在返回的 HTTP 响应头中，如果包含形如 subscription-userinfo: upload=1073741824; download=10737418240; total=107374182400; expire=1780000000 的字段，即证明该订阅在鉴权层面完全健康，小火箭能够无缝识别并展示剩余流量进度条。

进阶 UA 伪装修改实操#

如果某个机场由于特定限制暂时屏蔽了 Shadowrocket 的默认标头，用户可以在小火箭“设置”->“订阅”->“User-Agent”中，将内容手动修改为标准 Clash 标头（例如 clash.meta 或 ClashforWindows/0.20.39）。这样一来，每次小火箭向远端发送拉取请求时，均会伪装成桌面端客户端，轻松穿透服务端的访问控制策略，成功获取节点列表。

节点排序与测试模式选择#

1. 连通性测试（Ping）：在主界面点击“连通性测试”，小火箭会向所有节点并发发送极轻量级的探测包。显示为绿色数值（如 35ms、88ms）代表连接通畅；显示为黄色代表网络抖动偏高；显示为超时红字则代表节点不可用；
2. 测试方法调整：进入小火箭“设置”->“连通性测试”，可切换测速目标地址。默认通常为 Cloudflare 探针，若你在国内部分地区连 Cloudflare 存在干扰，可将其修改为 http://www.google.com/generate_204 或 http://cp.cloudflare.com/generate_204，确保延迟测试结果更加贴合实际外网体验；
3. 按延迟排序：点击主界面节点列表右侧的排序图标，选择“按延迟排序”，小火箭会将当前响应最快的节点自动置顶，便于一键选取连接。

区分 ICMP 延迟与应用层真实延迟#

许多新手容易陷入“数字越低越好”的误区。在小火箭的测速逻辑中，探测包经历的是完整的代理隧道转发测试（即从本地 iPhone 封装数据包，经由中转机、落地机，最终到达目标测试站点并返回）。

如果机场采用了优质的国内 BGP 专线入口，你测得的几十毫秒延迟主要是本地到国内入口的极速响应时间。但这并不意味着该节点下载巨额文件时一定能跑满百兆宽带。因此，在日常浏览 4K 视频或进行大文件吞吐时，建议以实际测速网站（如 fast.com 或 speedtest.net）的吞吐带宽为最终参考指标，将低延迟节点主要保留给在线实时语音、跨国证券交易以及主机联机游戏等对网络抖动极其严苛的应用场景。

案例一 点击一键导入毫无反应或浏览器提示无法打开网页#

• 故障现象：在 Safari 浏览器中点击机场“一键导入小火箭”按钮后，页面长时间转圈，或者弹出“Safari 无法打开该网页，因为网址无效”，小火箭应用未被唤醒。
• 原因剖析：第一，手机上未正确安装正版 Shadowrocket，导致 iOS 系统的 URL Scheme 注册表缺少 shadowrocket:// 关联；第二，机场网站的前端 JS 脚本与当前移动端浏览器的弹窗拦截规则冲突；第三，用户处于私密浏览模式下，受限的脚本权限阻止了跨应用跳转。
• 解决方案：
  1. 确认 iPhone 主屏幕上已存在并能正常打开 Shadowrocket 客户端；
  2. 退出 Safari 的无痕浏览模式，允许网页弹出提示窗口；
  3. 放弃一键导入，切换为手动方案：在机场后台点击“复制通用订阅链接”；
  4. 切换到小火箭主界面，点击右上角加号，类型选择“Subscribe”，将链接粘贴到 URL 栏并点击保存。

案例二 提示“导入失败 格式无法识别 (Invalid Format)”#

• 故障现象：手动粘贴订阅链接并点击保存后，小火箭弹窗报错提示“Invalid Format”或“解析错误”，订阅条目未生成任何可用节点。
• 原因剖析：第一，用户误将机场官方网站的登录主页或充值账单地址当成了节点订阅 URL；第二，用户复制链接时末尾混入了多余的中英文字符、空格或换行符；第三，机场订阅使用了纯粹的 sing-box 1.8 专用复杂 JSON 路由模板，超出了小火箭当前版本的语法解析范畴；第四，订阅链接被机场防盗链机制拦截，返回了纯文本的报错网页 HTML 代码。
• 解决方案：
  1. 返回机场后台，务必寻找带有“Clash 订阅”或“小火箭订阅”专属字样的链接，严禁复制浏览器地址栏的网站 URL；
  2. 粘贴至 URL 栏后，手动检查并删除开头和结尾的所有隐形空格；
  3. 若机场提供“订阅转换”功能，在后台将订阅格式切换为“Shadowrocket 通用格式”后重新复制添加；
  4. 使用手机浏览器直接访问该订阅链接，查看网页是否返回了有效的密文，若显示 404 或拦截页面，立即联系机场运维更新。

案例三 更新成功但节点列表全部为空#

• 故障现象：小火箭提示订阅更新成功，绿色的更新打勾动画闪过，但展开该订阅分组后，里面没有任何节点显示，或者节点全部消失。
• 原因剖析：第一，用户的机场套餐流量已耗尽，或者套餐服务已到期，机场服务器判定鉴权失败，下发了空节点列表；第二，机场后端正在执行服务器大版本割接，临时清空了节点池；第三，机场对客户端 IP 进行了风控拦截；第四，用户的订阅链接重置后旧 Token 作废，依然在用旧链接拉取。
• 解决方案：
  1. 打开 Safari 浏览器登录机场后台，检查个人仪表盘中的剩余流量数值与套餐到期时间是否充足；
  2. 检查后台公告，确认机场是否在执行全线节点维护升级；
  3. 若在后台重新生成了订阅 Token，务必将小火箭中的旧订阅条目彻底删除，重新获取新链接添加；
  4. 尝试断开当前 Wi-Fi，切换为手机 5G/4G 蜂窝网络再次尝试刷新，绕开可能的局域网 IP 拦截。

案例四 订阅更新频繁提示超时连接失败#

• 故障现象：每次下拉刷新订阅时，小火箭转圈长达数十秒，随后弹出红字警告“Timeout”或“Connection Reset”，无法同步最新节点。
• 原因剖析：机场的订阅托管域名遭遇了本地运营商（如移动、电信、联通）的 DNS 污染或防火墙干扰阻断。
• 解决方案：
  1. 临时代理法更新：如果列表中还有少数旧节点尚能连通，先在小火箭中选中该节点并开启顶部总开关进入代理状态，再下拉刷新订阅，借助代理通道顺畅拉取新节点；
  2. 开启订阅通过代理更新：在小火箭“设置”->“订阅”中，将“通过代理更新”开关彻底点亮；
  3. 配置第三方安全 DNS：在小火箭“设置”->“DNS”中，添加阿里云公共 DNS（223.5.5.5）或腾讯 DNSPod（119.29.29.29），规避宽带运营商默认本地 DNS 的递归污染；
  4. 联系机场官方客服，获取被分流保护的备用免翻墙订阅分发域名。

Q1 为什么我添加的订阅更新后一个节点都没有#

最常见的原因是机场账户状态异常。请第一时间通过浏览器登录机场后台，确认个人套餐是否已经到期，或者当月高速流量是否已经用尽。很多机场系统在用户欠费或流量耗尽后，不会返回报错提示，而是直接下发一个空的节点数据包，导致小火箭解析后列表为空。此外，若机场近期更换了订阅分发域名，而你使用的是旧的废弃链接，也会导致拉取为空。

Q2 小火箭添加订阅后 节点显示延迟几千毫秒是怎么回事#

当小火箭连通性测试显示数千毫秒（甚至提示超时）时，通常代表手机与该节点服务器之间的 TCP 握手完全失败，显示的高延时仅仅是小火箭等待超时阀值的保护性数值。请检查手机系统时间是否开启了自动对齐，或者尝试切换网络环境重试。若所有节点都报出几千毫秒，很可能是由于当地运营商阻断了该机场的入口中转服务器。

Q3 订阅链接会泄露我的手机隐私或浏览历史吗#

完全不会。订阅链接本质上只是一条带有你个人身份识别码（Token）的专用下载地址。小火箭通过它仅仅是单向拉取节点的网络连接参数。你在日常上网过程中的任何个人隐私、浏览历史或密码数据，都绝对不会回传至该订阅链接对应的托管服务器。只要你使用的是正版客户端，订阅机制在架构设计上是完全单向且安全的。

Q4 换了一台新 iPhone 原来的订阅怎么迁移过去#

迁移订阅有两种极简方式：第一，在新 iPhone 上登录机场后台，重复一次“一键导入”或“复制 URL 手动添加”操作；第二，使用小火箭自带的配置备份功能：在旧手机上进入小火箭“设置”->“iCloud”，开启自动同步，新手机登录同一个 Apple ID 打开小火箭即可无缝同步全部订阅与节点。这种方法连同你自定义的分流规则也能一并完整复刻。

Q5 为什么订阅更新会导致我正在连接的节点突然断开#

如果小火箭正在连接节点的过程中拉取了新订阅，且机场在这次更新中刚好下线或重命名了你当前正在使用的节点服务器，底层网络连接就会因为目标不存在而被迫重置。建议尽量在不进行大文件下载或在线游戏时进行全局订阅刷新。若必须刷新，可先暂时断开全局代理开关，待刷新完毕重新选中可用节点后再行开启。

Q6 订阅链接后面带的 token 参数是什么意思 能借给朋友用吗#

Token 是机场为你个人账户分配的专属加密鉴权秘钥。机场通过此 Token 来核算你的在线设备数和流量消耗。如果将包含该 Token 的订阅链接借给朋友，朋友产生的下载流量将直接扣除你的账户额度，且若超出机场允许的“同时在线设备数限制”，你的账户可能会被系统自动封禁。因此，严禁将个人订阅链接分享给他人或公开发布在社交平台上。

Q7 多个机场的订阅可以同时添加到同一个小火箭里吗#

完全支持。小火箭对订阅数量没有任何人为限制。你可以同时导入三家甚至五家不同机场的订阅。每个机场的节点会在主界面自动归类在各自独立的分组卡片中，互不干扰，你可以随时根据网络状况自由切换。拥有多套订阅能够有效互为容灾备份，当主力机场遭遇突发网络波动时，能够秒级切换至备用机场继续办公。

Q8 为什么在公司 Wi-Fi 下订阅更新总是失败 切换 5G 就正常#

很多大型企业、高校或公共机构的内部局域网部署了严格的上网行为管理系统（如各类硬件网络防火墙），会对已知的代理协议、动态域名解析以及包含敏感关键字的外部接口进行拦截封锁。遇到这种情况，只需断开公司 Wi-Fi，使用手机自带的移动数据即可瞬间完成刷新。拉取完毕后若企业 Wi-Fi 允许代理流量出站，可再切回 Wi-Fi 使用。

Q9 一键导入时提示证书无效或不受信任怎么处理#

这说明机场用来分发订阅的二级域名其 SSL 证书配置有误，或者证书已经过期。在紧急情况下，可以在小火箭添加页面将订阅 URL 中的 https 临时改为 http 绕过证书校验完成拉取，并及时向机场技术运维提交工单修复证书。另外，若你的手机系统处于越狱环境或安装了冲突的自签名根证书，也可能触发系统的证书链信任警告。

Q10 为什么设置了自动更新后 感觉手机耗电明显变快了#

如果你在小火箭设置中将自动更新的时间间隔设置得过于频繁（例如每 15 分钟或每半小时检查一次），小火箭会不断向后台申请唤醒并频繁启动无线网卡发送网络握手包，这必然导致电池电量加速流失。对于绝大多数用户，将自动更新间隔保持在 12 小时到 24 小时是最为科学的黄金平衡点。合理的时间间隔既能保证节点更新的及时性，又能将后台功耗压制在微乎其微的水平。