Shadowrocket怎么导入订阅？扫码与订阅链接一键导入教程

1. 什么是代理订阅 (Subscription URL / Sub)#

所谓的“代理订阅链接”，本质上是一个标准的 HTTP / HTTPS 格式的网络 URL 地址（例如 https://api.airport-provider.com/link/TOKEN?sub=1）。

当用户将该 URL 导入到 Shadowrocket 并执行“更新”时，小火箭后台会通过 iOS 的网络接口向该 URL 发起一个标准的 HTTP GET 请求。收到请求后，机场的订阅服务器会根据请求头中的信息进行身份鉴权（基于 Token 参数），鉴权通过后返回一串经过加密或编码的文本流。

2. Base64 字符串解码与 URI 节点提取过程#

机场服务器返回的订阅内容绝大多数并非明文展示的节点列表，而是采用了 Base64 编码算法 进行保护与传输压缩。小火箭在拿到 HTTP 响应体 (Response Body) 后，会在内存中逐层执行以下 4 个解析步骤：

1
远程订阅 URL ──► 发起 HTTP GET 请求 ──► 获取 Base64 编码字符串 ──► Base64 解码 ──► 提取节点 URI 数组 (ss://, vmess://) ──► 实例化为首页节点列表

1. HTTP 状态码校验：小火箭必须首先确认服务器返回了 HTTP/1.1 200 OK 状态码。如果收到 301/302 重定向、403 拒绝对接或 404 页面丢失，解析流程在第一阶段中断；
2. Base64 文本解码：小火箭使用标准的 Base64 算法对字符串进行解密，得到形如 vmess://ey... 或 trojan://password@server:port... 的多行明文 URI 文本；
3. URI 协议拆解与正则表达式匹配：小火箭的解析引擎扫描每一行文本，根据前缀识别传输协议：

• ss://：Shadowsocks 协议节点；
• vmess://：VMess 协议节点（包含 base64 编码的 JSON 参数）；
• vless://：VLESS 协议节点（包含 XTLS / Vision / REALITY 参数）；
• trojan://：Trojan 协议节点；
• hy2:// 或 hysteria2://：Hysteria 2 极速 QUIC 协议节点；

4. 实例化并写入本地数据库：小火箭将拆解出的服务器 IP、端口、密钥、TLS 域名与 UUID 注入客户端的 CoreData 本地数据库中，最终在软件主界面呈现出可供点击选择的节点列表。

3. 一键导入 Scheme (shadowrocket://add/sub?url=...) 的 iOS 唤醒机制#

许多机场网页面板提供的“一键导入到 Shadowrocket”按钮，底层依赖的是 iOS 系统的 Custom URL Scheme (自定义协议唤醒) 机制。

当你在 Safari 浏览器中点击“一键导入”按钮时，网页实际上发起了一个特殊的 URL 跳转：

1
shadowrocket://add/sub?url=https%3A%2F%2Fapi.airport-provider.com%2Flink%2FTOKEN%3Fsub%3D1&title=MyAirport

iOS 操作系统识别到 shadowrocket:// 这个协议头属于已经安装的 Shadowrocket 应用，便会自动挂起 Safari 并启动小火箭。小火箭接收到系统传递的 add/sub 指令与 URL 参数后，会自动在前端弹框并自动填入订阅地址与名称，实现“零手动输入”的一键式极速导入。

4. Base64 填充字符与非标准 Base64URL 算法的兼容机制#

在计算机网络数据传输中，Base64 编码机制通过将 3 个 8-bit 的字节转换组合为 4 个 6-bit 的可打印字符（使用 A–Z, a–z, 0–9, +, / 共 64 个字符表示二进制数据），实现文本流在各种网络协议中的安全传输。

然而，不同机场后端框架在生成订阅字符串时，经常采用不同的 Base64 变体算法。例如，部分基于 Go 语言开发的机场面板在生成订阅时使用的是符合 RFC 4648 标准的 Base64URL 算法，将标准算法中的 + 替换成了 -，将 / 替换成了 _，且常常自动剥离末尾用于补位的 = 填充等号。小火箭客户端在接收到这串非标准 Base64 字符流时，底层 C 语言解析引擎会自动补全缺失的补位等号，并将 URL 安全字符还原为标准字符后再执行解码。如果用户使用的第三方客户端缺乏这种补位容错机制，解密流程会在第一阶段直接崩溃并报错。

5. HTTP GET 请求头 (Headers) 协商与客户端 User-Agent 鉴权逻辑#

当小火箭向机场订阅 URL 发起网络请求时，iOS 系统的 URLSession 网络框架会在 TCP 三次握手及 TLS 密钥协商完成后，构造并发送包含标准 HTTP Header 的 GET 请求报文。

一个典型的小火箭订阅更新请求报文中包含了以下核心 Header 字段：

• User-Agent: 标记发起请求的客户端软件型号与系统版本号（例如 Shadowrocket/2.2.50 (iPhone; iOS 18.0; Scale/3.00)）；
• Accept: 声明客户端能够接收并处理的数据类型（例如 text/html,application/xhtml+xml,text/plain）；
• Host: 声明目标订阅服务器的主机域名与访问端口；
• Connection: 设置为 keep-alive 保持 Socket HTTP 长连接，防止频繁发起握手。

机场后端的 API 服务器在收到此请求后，防火墙模块会首先读取 User-Agent 字段。如果识别出当前请求来自于已知的小火箭客户端，服务器便会在返回的 Response Header 中注入 subscription-userinfo 流量监测数据，并在 Response Body 中输出经过 Base64 编码的加密节点文本；如果发现 User-Agent 字段为空或者包含常见的自动化 Python 爬虫特征（如 Python-urllib），防火墙会直接强行终止 TCP 连接或返回 403 Forbidden 页面。

6. CoreData 本地节点数据库索引结构与存储映射机制#

小火箭通过连通性更新获取到解密后的明文节点 URI 列表后，并非仅仅将其临时保存在内存中，而是会将这些节点持久化写入 iOS 系统的 CoreData 本地 SQLite 关系型数据库 中。

小火箭在 CoreData 数据库中为每个订阅节点建立了包含数十个维度的属性索引模型：

• node_id: 系统生成的全局唯一主键 ID；
• group_title: 该节点所属的订阅分组名称（如“机场专线订阅”）；
• server_address: 节点的后端中转 Server IP 地址或出口域名；
• server_port: 节点监听的网络通信端口；
• protocol_type: 节点的代理传输协议分类（如 Shadowsocks、VMess、VLESS、Trojan、Hysteria 2）；
• security_method: 加密算法（如 aes-128-gcm、chacha20-poly1305 或 zero-encryption）；
• uuid_password: 用于代理身份验证的密码短语或 36 位 UUID 格式化字符串；
• tls_sni_name: 用于 TLS 加密握手时的 Server Name Indication 伪装域名；
• last_latency_rtt: 上一次连通性测试返回的 HTTP RTT 往返延迟毫秒数。

通过将节点参数规范化写入 CoreData 数据库，小火箭即使在完全离线无网的环境下重启软件，依然能够瞬间从本地数据库中加载出所有历史导入的节点与配置规则，保障了软件运行的高稳定性。

1. 一键点击导入 (一键导入按钮 / Scheme 唤醒)#

这是对初学者最友好、最不易出错的导入方式。

• 操作步骤：

1. 在 iPhone 的 Safari 浏览器中登录你的机场服务商后台；
2. 找到“便捷导入”或“订阅节点”区域，点击 “一键导入到 Shadowrocket” 按钮；
3. Safari 会弹窗提示“在‘Shadowrocket’中打开此页吗？”，点击 打开；
4. 系统自动拉起小火箭，软件顶部弹窗显示“添加订阅”，在 备注 (Remarks) 中输入机场名称，最后点击右上角的 保存 (Save)；
5. 返回小火箭首页，节点列表中会自动展示所有拉取的节点。

• 优点与适用场景：全自动绑定 URL 与类型，避免手动复制黏贴引入的空格错误，适合首选使用。

2. 剪贴板自动识别与手动 HTTP/HTTPS URL 填入#

当一键导入按钮失效或使用微信/Telegram 等内嵌浏览器时，剪贴板手动导入是最可靠的替代方案。

• 操作步骤：

1. 在机场后台找到 “复制 Shadowrocket 订阅链接” 按钮并点击复制；
2. 打开 Shadowrocket，小火箭通常会自动识别剪贴板中的链接并弹窗询问“是否添加该订阅？”，点击 允许 / 添加；
3. 若未自动弹窗，点击小火箭右上角 + (加号) 图标进入手动添加页面；
4. 点击 类型 (Type)，必须将其从默认的 Shadowsocks 切换修改为 Subscribe（订阅）；
5. 在 URL 输入框中长按黏贴刚复制的订阅链接，在 备注 (Remarks) 框中输入机场名称；
6. 点击右上角 保存 (Save)。

3. 扫描二维码与相册二维码 OCR 识别导入#

适用于电脑登录机场面板、使用 iPhone 扫描电脑屏幕，或者将二维码截图保存到手机相册的场景。

• 操作步骤：

1. 在电脑浏览器上打开机场面板，展示 Shadowrocket 订阅二维码（或合一节点二维码）；
2. 打开小火箭，点击首页左上角的 扫码图标 (Scan Icon) 开启摄像头；
3. 将 iPhone 摄像头对准电脑屏幕上的二维码完成扫码；
4. 相册识别：如果是朋友发给你的二维码截图，在扫码界面点击右上角 相册图标，选中照片库中的二维码图片，小火箭内置的 OCR 图像引擎会自动识别并完成节点导入。

4. 手动导入离线文件 / .conf 配置文件#

适用于离线无网环境、机场提供离线文件备份，或者导入高级分流规则配置文件的场景。

• 操作步骤：

1. 在 Safari 中下载格式为 .conf 或 .txt 的离线配置文件到 iPhone “文件 (Files)”应用中；
2. 打开小火箭，切换到底部 配置 (Config) 标签页；
3. 点击右上角 + (加号)，选择“从本地文件导入”；
4. 在文件选择器中找到刚下载的文件并点击导入。

在实际的 iOS 操作系统安全沙盒机制下，理解这 4 种订阅导入路径背后的底层通信交互，有助于在遇到特定的导入异常时进行精准的技术判断与快速恢复。

首先，针对 一键点击导入（Scheme 唤醒） 路径，iOS 系统的 UIApplicationDelegate 代理接口在接收到从 Safari 浏览器传递进来的 openURL: 消息通知后，小火箭客户端后台的网络模块会立即解析 URL 挂载的 Query String 查询参数。如果机场服务商提供的 Scheme 唤醒字符串中包含了 title 参数与 url 参数，小火箭的前端 UI 视图控制器会触发一个主线程模态弹窗，提示用户确认添加当前订阅。这种机制完全避除了用户手动复制黏贴长字符串时可能引发的标点符号截断或全角空格污染问题，因此在所有导入途径中具备最高的成功率。

其次，针对 剪贴板自动识别与手动填入 路径，iOS 14 及以上操作系统引入了严格的隐私剪贴板读取通知机制（Pasting from App Notice）。当用户打开小火箭且剪贴板中存在包含 http:// 或 https:// 的有效链接时，小火箭后台的贴纸监测引擎会发起安全校验。用户在选择手动填入时，必须特别注意将列表中的默认类型从普通节点 Shadowsocks 明确更改为 Subscribe（订阅）。如果类型误选为普通节点，小火箭会将长达数百字符的 Api 链接误认为是一个独立节点的服务器主机地址，从而失去自动拉取节点列表的能力。

再次，针对 扫码与相册二维码 OCR 识别导入 路径，小火箭集成了 Apple 官方的 Vision 框架图像识别算法。当用户使用手机摄像头对准电脑屏幕展示的订阅二维码，或者从手机相册中选中一张包含订阅二维码的屏幕截图时，Vision 框架会在毫秒级时间内对图像中的定位图案（Finder Patterns）与对齐图案（Alignment Patterns）进行矩形校正与二值化矩阵转换。如果机场生成的二维码是将上百个节点加密后编码在一个二维码图片中，图像的密文版本像素点密度会极高。这种情况下，一旦电脑显示器存在严重的屏幕反光或频闪，OCR 识别引擎容易出现判定超时。此时最好的解决方案是将电脑上的二维码图片进行放大展示，或者放弃扫码直接复制链接字符串进行文本导入。

最后，针对 离线配置文件与本地 .conf 文件导入 路径，小火箭允许用户直接通过 iOS 系统的“文件 (Files)”应用加载存储在手机本地存储空间或 iCloud 盘中的静态配置文件。小火箭解析引擎读取 .conf 文件中的 [General]、[Host] 和 [Rule] 语法块，将其持久化注入客户端内存中。这种方式完全不需要依赖远程 API 服务器的网络连通性，非常适合在机场订阅 Api 遭遇强力污染封锁时的离线应急备份场景。

表 1：4 种订阅导入方式多维度对比表#

表 2：常见主流代理订阅格式特性对比表#

步骤 1：在机场面板获取正确的原生 Shadowrocket 订阅#

1. 打开并登录机场后台，找到 “订阅中心” 或 “一键订阅” 区域；
2. 优先选择标记有 Shadowrocket 订阅 或 小火箭一键导入 的专属选项（避免错选为 Quantumult X 或 Surge 专用订阅）；
3. 点击复制订阅 URL，或者保持二维码展现在电脑屏幕上。

步骤 2：在小火箭中选择类型为“Subscribe”并保存#

1. 打开 Shadowrocket，点击右上角 + (加号) 图标；
2. 点击 类型 (Type) 栏，在弹出的下拉菜单中务必选择 Subscribe；
3. 在 URL 框中长按黏贴刚才复制的链接；
4. 在 备注 (Remarks) 框中输入机场名称（如 机场专线）；
5. 点击右上角 保存 (Save)。

步骤 3：开启自动更新策略（“打开时更新”与“自动后台刷新”）#

1. 在小火箭底部导航栏，点击 设置 (Settings) -> 订阅 (Subscribe)；
2. 勾选开启 打开时更新 (Update on Open) 开关：每次打开小火箭 App 时，软件会自动在后台校验并静默更新节点列表；
3. 勾选开启 自动后台刷新，并设置更新间隔为 24 小时（既能保证节点数据最新，又不会因高频更新触发机场 API 限流）。

步骤 4：自定义 User-Agent 规避机场 Api 封锁与阻断#

部分机场为了防止订阅地址被爬虫恶意扫段，限制了默认的 HTTP User-Agent。

1. 在小火箭 设置 -> 订阅 (Subscribe) 中，找到 用户代理 (User-Agent) 选项；
2. 将其设置为小火箭的标准 User-Agent 文本：Shadowrocket/2.2.50（或留空使用系统默认值），避免被机场 Api 拦截返回 403。

步骤 5：开启“保持节点自定义排序”与无效节点隐藏#

1. 在小火箭 设置 -> 订阅 页面中，开启 保持节点排序 (Keep Sort) 开关：这样即使机场在后台更新了节点，你手动拖拽调好的常用节点顺序也不会被乱序重置；
2. 开启 隐藏保留节点，自动隐藏已被机场弃用的超时节点，保持首页列表精简。

步骤 6：通过单节点连通性测试验证订阅有效性#

1. 返回小火箭首页，在刚导入的订阅展开列表中，点击顶部 连通性测试；
2. 观察节点右侧是否刷出绿色的毫秒数值（如 45ms）；
3. 手动选择一个节点开启代理，打开 Safari 访问网页验证实际上网体验。

在完成小火箭订阅导入后，为了确保节点列表能够始终保持最新状态且不会打乱个人习惯的节点排序，深入理解上述 6 步配置背后的最佳实践原则至关重要。

在 订阅更新策略选择 方面，许多初学者倾向于将订阅更新间隔设定得极短（例如每 10 分钟自动更新一次）。从底层协议与 Api 消耗的角度来看，这种高频更新行为极具危险性。绝大多数现代机场的后台面板（如 SSPanel-UIM 或 V2Board）都在边缘接入节点（如 Cloudflare WAF）配置了基于 IP 的 Token Rate Limiting 速率限制规则。如果小火箭在后台高频发起全量节点拉取请求，机场 Api 会判定该 IP 存在恶意爬虫打压行为，进而抛出 HTTP 429 Too Many Requests 报错并将客户端 IP 放入临时封禁黑名单。因此，将更新间隔设定为合理的 24 小时，并同时开启 “打开时更新 (Update on Open)” 选项，既能保障每次需要使用小火箭时自动静默刷新节点，又能避免触发机场服务端的 Api 频控防护。

在 用户代理 (User-Agent) 伪装与设置 方面，部分高防护机场出于防扫段防护机制，显式封禁了缺乏合法标识的空 HTTP Request Header 请求。在小火箭的订阅高级设置中，将 User-Agent 参数指定为标准的小火箭签名格式（如 Shadowrocket/2.2.50），可以让小火箭发起的网络连接请求完美契合机场 Api 服务器的白名单鉴权规则。

在 节点排序与清洗机制 方面，随着机场服务端节点的动态增删，每次订阅更新时，远程服务器返回的节点顺序可能会发生随机变动。如果在小火箭中开启了 “保持节点排序 (Keep Sort)” 功能，小火箭的 CoreData 数据库会在后台建立基于节点唯一哈希的排序索引表，确保你平时习惯使用的常用节点始终固定在首页最顶部位置，不会被新更新的节点挤到列表底部。同时，开启 “隐藏保留节点” 能自动将机场标注废弃或连通性测试持续 Timeout 的死节点从主界面中过滤隐去，大大提升了日用视图的干净程度与节点挑选效率。

1. 使用 cURL 探测机场订阅 URL 的响应状态码与 Header 头部#

1
# 适用系统：macOS Terminal / Linux Shell / Windows PowerShell
2
# 执行目的：伪装小火箭的 User-Agent，测试机场订阅 URL (假设为 https://sub.airport.com/link/token) 的响应状态码与 Header
3
curl -I -v -A "Shadowrocket/2.2.50" "https://sub.airport.com/link/token" --connect-timeout 5

• 预期结果：终端输出 HTTP/1.1 200 OK，且能在 Response Header 中看到 Content-Type: text/plain; charset=utf-8 或 subscription-userinfo 流量额度标头。
• 异常判断：如果输出 HTTP/1.1 403 Forbidden，说明机场后端防火墙拦截了你的 IP 或 User-Agent；如果输出 HTTP/1.1 302 Found 且 Location 重定向至广告页，说明订阅链接已被机场注销。

2. 使用 cURL 配合 base64 -d 命令行手动解码订阅节点列表#

1
# 适用系统：macOS Terminal / Linux Shell
2
# 执行目的：在终端直接下载订阅 Body 内容并通过管道传给 base64 命令解密，打印明文节点 URI
3
curl -s -A "Shadowrocket/2.2.50" "https://sub.airport.com/link/token" | base64 -d

• 预期结果：终端屏幕直接打印出解密后的多行明文节点，如：

1
vmess://eyJ2IjoiMiIs...
2
ss://YWVzLTI1Ni1nY206cGFzc3dvcmRAMS4yLjMuNDo0NDM=
3
trojan://[email protected]:443#HongKong-IPLC

• 异常判断：如果解密输出是一堆乱码或提示 base64: invalid input，说明机场服务端返回的并非标准的 Base64 文本，而是未经编码的 YAML 格式或压缩二进制流。

3. 使用 python3 脚本解析 vmess:// 解密节点的 JSON 参数#

1
# 适用系统：macOS / Linux / Windows (需安装 Python 3)
2
# 执行目的：将小火箭中的 vmess:// 节点字符串解密并提取内部 Server IP、Port 和 UUID
3
import base64
4
import json
5

6
vmess_str = "vmess://eyJhZGQiOiIxLjIuMy40IiwicG9ydCI6NDQzLCJpZCI6ImFiYy0xMjMiLCJwc2FmZSI6ImhrMC0xIn0="
7
encoded_data = vmess_str.replace("vmess://", "")
8
decoded_json = base64.b64decode(encoded_data).decode('utf-8')
9
config = json.loads(decoded_json)
10

11
print(f"节点名称: {config.get('ps')}")
12
print(f"服务器 IP: {config.get('add')}")
13
print(f"端口: {config.get('port')}")
14
print(f"用户 UUID: {config.get('id')}")

• 预期结果：控制台精准打印出该节点的后端中转 IP、端口及加密 UUID 结构，便于核对机场节点参数是否配置正确。

案例一：导入订阅链接时提示 Invalid URL 或 URL 格式无效#

案例二：Safari 点击一键导入提示 Safari 无法打开该网页，因为 URL 无效#

案例三：更新订阅提示 Update Profile Failed (302 Found)#

案例四：扫码导入提示 未检测到有效二维码#

案例五：更新订阅后列表中显示的全部是 404 Not Found 文本节点#

案例六：导入 Clash 格式的 YAML 订阅后显示为空#

案例七：手动添加订阅时误将类型选为 Shadowsocks 导致无法更新#

案例八：手机系统时间偏差 3 分钟导致更新订阅提示 SSL/TLS Handshake Error#

案例九：连 Wi-Fi 能正常更新订阅，但切到 5G 蜂窝流量更新超时#

案例十：开启小火箭代理时更新订阅，出现“死锁”更新失败#

案例十一：机场 Api 限制了 User-Agent 导致小火箭更新订阅返回 HTTP 403#

案例十二：复制订阅链接时微信自动将 & 转换为了 & 导致参数校验失败#

案例十三：订阅节点数量过多 (超出 500 个) 导致小火箭首页滑动严重卡顿#

案例十四：订阅导入后所有节点名称全是混乱的乱码字符#

案例十五：公网 Wi-Fi 触发 Portal 认证拦截导致订阅更新下载了 HTML 登录页#

案例十六：使用 iCloud 同步小火箭配置导致多台 iPhone 订阅发生覆盖冲突#

案例十七：机场域名更换导致原订阅链接彻底失效#

案例十八：在相册中选取二维码导入时由于图片过于模糊识别失败#

案例十九：开启了“按需连接 (On Demand)”导致后台更新订阅被系统挂起#

案例二十：机场服务端开启了基于 IP 的防刷限流，频繁手动刷新被封禁 15 分钟#

案例二十一：订阅导入后部分 Hysteria 2 节点因小火箭版本过低无法识别#

案例二十二：自定义 Module 规则强行拦截了订阅 URL 所在的域名#

案例二十三：机场订阅返回的是 SIP002 格式但小火箭未能自动展开组#

案例二十四：使用企业级 iOS 限制设备 (MDM) 导致配置文件无法写入#

案例二十五：切换双卡数据源导致小火箭网络 Socket 锁死更新失败#

案例二十六：自建订阅转换服务缺乏 SSL 证书导致小火箭拒绝 HTTPS 连接#

十、 常见问题 FAQ#

Q1: 复制机场订阅链接导入小火箭安全吗？会不会泄漏隐私？#

使用正规机场的原生订阅链接导入 Shadowrocket 是高度安全的。订阅链接本身本质上是一串包含身份 Token 的专属 Api 地址，小火箭通过该链接仅拉取节点的服务器 IP、加密端口与认证密钥，绝不会将你手机上的浏览记录、账号密码或隐私数据上传给订阅服务器。但请务必妥善保管你的订阅链接，不要随意公开发布到网络上，因为其他人拿到你的订阅链接即可消耗你的套餐流量。

Q2: 为什么导入订阅链接后，小火箭首页只显示了一个节点而不是节点列表？#

这是因为在手动添加订阅时，误将“类型 (Type)”保留为了默认的 Shadowsocks 或 VMess，而没有切换修改为 Subscribe（订阅）。当类型为普通节点时，小火箭会将整串 https://... 字符串误识别为一个独立节点的 IP 地址。解决办法是删除该错误节点，重新点击 + 号，将类型明确选择为 Subscribe 后再黏贴 URL 保存。

Q3: 小火箭怎么导入 Clash 格式的 YAML 订阅链接？#

现代版本的 Shadowrocket 已内置了对 Clash / Clash Verge 格式 YAML 订阅的解析支持。你无需手动进行格式转换，直接复制 Clash 订阅链接，在小火箭中点击 + 号，类型选择 Subscribe 并黏贴保存即可。小火箭在下载 YAML 配置文件后，会自动提取其中 proxies: 节点段落并转化为小火箭原生可用的节点列表。

Q4: 订阅链接重置后，小火箭里的节点会自动更新吗？#

不会自动更新。如果你在机场后台点击了“重置订阅链接”（例如怀疑链接泄露），旧的订阅链接会在服务器端即刻失效。你必须在小火箭中长按旧的订阅项将其删除，然后在机场后台复制生成的 全新订阅链接，重新导入小火箭中。

Q5: 为什么在小火箭里更新订阅时提示 Update Profile Failed: 302 Found？#

提示 302 Found 意味着机场的订阅服务器拒绝了节点数据请求，并向小火箭返回了一个页面重定向指令。这 99% 是因为 你在机场的套餐已到期、已欠费，或者当月套餐流量已经 100% 消耗完。机场服务器将 Api 请求重定向到了续费登录页面，小火箭无法从登录网页中解析节点从而报错。登录机场后台完成续费即可解决。

Q6: 导入订阅后，节点名称里的“香港 01 | IPLC”是什么意思？#

节点名称是由机场服务商自定义的标识文本。其中：

• “香港 / 日本 / 美国”：代表该节点最终解密流量出局的物理地理位置；
• “IPLC / IEPL”：代表该节点采用了高成本的跨境内网专线（不经过 GFW 防火墙，延迟低且极度稳定）；
• “BGP”：代表该节点采用了国内多线中转入口；
• “1.0x / 2.0x”：代表该节点的流量扣除倍率。

Q7: 小火箭可以同时导入多个不同机场的订阅链接吗？#

完全可以。小火箭支持导入无上限数量的订阅链接。导入多个机场订阅后，小火箭首页会按订阅名称分类展现多个折叠组。你可以随时在不同机场的节点之间自由切换，甚至可以使用小火箭的 url-test 自动选择策略组 跨机场调度延迟最低的节点。

Q8: 为什么开启代理后更新订阅反而失败，关闭代理后更新却成功？#

这是典型的“代理循环依赖”问题。如果你将小火箭的全局路由设为了“全局代理”，且当前选中的代理节点已经失效掉线，小火箭发起更新订阅请求的数据包就会强行送往这个已坏掉的节点转发，导致请求挂起超时。解决办法是更新订阅时将全局路由暂时切回 配置 (Config) 或 直连 (Direct)。

Q9: 扫码导入和复制订阅链接导入有什么区别？哪种更好？#

• 扫码导入：如果是直接扫描订阅二维码，效果与复制链接完全一致；但如果扫描的是单个节点的二维码，小火箭仅会导入那一个静态节点，后续机场更新节点时无法自动同步。
• 复制订阅链接导入：始终保存的是动态 API 接口，支持后续一键自动更新。强烈推荐优先使用复制订阅链接或一键导入。

Q10: 为什么更新订阅后，我之前手动调整好的节点顺序被打乱了？#

因为默认情况下每次更新订阅，小火箭会用机场返回的最新节点顺序覆盖本地数据库。要保留你习惯的节点排序，请前往小火箭 设置 (Settings) -> 订阅 (Subscribe)，开启 保持节点排序 (Keep Sort) 开关即可。

Q11: 订阅链接里的 Token 会定期更换吗？#

一般不会自动更换，除非你手动在机场后台点击了“重置订阅”按钮。只要你的机场账号正常续费，订阅链接可以长期永久使用。

Q12: 为什么小火箭更新订阅时提示 SSL Handshake Failed？#

代表客户端与订阅服务器建立 HTTPS 加密连接时 TLS 握手失败。最常见的原因是 iPhone 的系统时间与网络标准时间偏差超过 60 秒。前往 iPhone“设置”->“通用”->“日期与时间”，开启“自动设置”校准时间即可。

Q13: 在小火箭里怎么彻底删除一个不需要的订阅？#

在小火箭首页的节点列表中，找到你要删除的订阅名称分组标题，在其上 向左滑动，在右侧弹出的按钮中点击红色的 删除 (Delete) 即可彻底清空该订阅及旗下所有节点。

Q14: 为什么小火箭更新订阅后，所有节点前面都带有了国旗图标？#

小火箭会自动扫描节点名称中的国家/地区代码（如 HK、JP、US）或 ISO Emoji 字符，并自动在 UI 前端渲染出对应的国旗图标，方便用户直观识别节点位置。

Q15: 小火箭设置里的“打开时更新”会消耗很多手机流量吗？#

非常少。每次更新订阅仅仅是下载一个几十 KB 左右的 Base64 文本文件，即使每天更新数十次，消耗的流量也微乎其微（小于 1MB），完全无需担心流量损耗。

Q16: 订阅更新提示 403 Forbidden 是什么原因？#

说明机场服务端的防火墙（如 Cloudflare WAF）拦截了你的更新请求。常见原因包括：你使用了非法的 User-Agent；短时间内高频发起了数十次更新触发了防刷限速；或者你的本地出口 IP 被机场封禁。在小火箭设置中将 User-Agent 修改为 Shadowrocket/2.2.50 或更换网络后再试。

Q17: 为什么小火箭导入订阅后节点测速全都是 Timeout？#

订阅导入成功仅代表拉取到了节点配置参数。测速全盘 Timeout 说明节点无法建联，可能源于：连通性测试 URL 被墙、iOS 本地网络权限被关、机场节点中转 IP 被封锁或晚高峰骨干网拥塞。请参考专门的《Shadowrocket测速超时排查指南》进行技术定位。

Q18: 使用第三方订阅转换 (SubConverter) 安全吗？#

存在一定的隐私泄漏风险。如果你使用公共免费的第三方订阅转换服务，转换服务器的主人有能力在后台日志中记录你的真实订阅 Token 进而使用你的流量。强烈建议直接使用机场原生提供的 Shadowrocket 订阅，避免使用来源不明的第三方转换 API。

Q19: 为什么有些机场的订阅链接非常长，有些非常短？#

链接长度取决于机场 Api 的路由设计。较短的链接通常使用了短链重定向或简短的 Token 哈希，两者在功能与传输效率上没有任何本质区别。

Q20: 订阅链接可以在小火箭电脑版 (macOS) 上通用吗？#

可以。如果你的 Mac 使用了 M 系列芯片并安装了 iOS 版 Shadowrocket，或者使用的是 Clash for Windows / Surge for Mac，直接复制同一个机场订阅链接均可通用导入。

Q21: 为什么小火箭设置里勾选了“自动更新”，但隔几天看节点依然没变？#

iOS 系统对后台 App 的唤醒有着严格的电量与内存管控。如果小火箭长期处于后台冻结状态，系统可能会跳过自动静默刷新。建议开启 “打开时更新”，每次打开 App 时即可确保获得最新节点。

Q22: 小火箭导入订阅后可以手动修改某个节点的端口或密码吗？#

可以。点击节点右侧的 i 信息图标即可进入单节点编辑页面修改参数。但请注意：一旦后续再次点击“更新订阅”，机场服务端返回的数据会重新覆写并还原你手动修改的参数。

Q23: 为什么微信里接收到的订阅链接黏贴到小火箭提示格式错误？#

微信有时会在长文本链接中自动加入不可见的 Unicode 零宽空格，或者将字符 & 转义为 &。建议将微信里的链接先复制到 Safari 地址栏运行一次，再复制地址栏中的纯净 URL 导入小火箭。

Q24: 订阅导入后显示的 0.1x 优惠 节点是什么含义？#

代表低倍率流量节点。使用该节点消耗 10GB 实际网络流量，机场后台仅扣除 1GB 套餐额度，非常适合进行大文件下载、游戏更新或系统升级。

Q25: 导入订阅提示 Memory Limit Exceeded 怎么解决？#

说明订阅文件中包含了成千上万条无用的规则或超大文本，超出了小火箭的内存分配限制。联系机场客服提供精简版的原生订阅链接。

Q26: 为什么点击更新订阅后，小火箭提示 Invalid Base64 Stream？#

说明机场服务器返回的响应 Body 损坏，Base64 字符串中包含了非法的字符。通常是因为机场服务器后台数据库配置故障，需联系机场管理员修复 API。

Q27: 小火箭可以导入自建 VPS 的订阅吗？#

可以。如果你使用诸如 Sub-Store 或自建的 SubConverter 脚本，可以将自己的多台 VPS 节点打包生成自建的订阅 URL 导入小火箭统一管理。

Q28: 为什么 iPad 上导入订阅后无法同步给 iPhone？#

小火箭的节点订阅数据存储在设备本地的 CoreData 数据库中。除非开启了小火箭的配置文件云端同步，否则不同设备之间需要各自单独导入一次订阅。

Q29: 订阅节点名称前带有 [Expire: 2026-12-31] 流量信息是怎么实现的？#

机场服务器在返回订阅文本时，在首行注入了一个特殊的 Sip002 / Dummy 节点，小火箭自动读取其中的 Header 属性并在节点名称中渲染出你的套餐到期时间与剩余流量。

Q30: 订阅导入后提示 Duplicate Profile Name 怎么解决？#

说明小火箭中已经存在一个同名的订阅备注。长按旧订阅修改备注名称，或者直接覆盖导入即可。

Q31: 为什么苹果 App Store 里的伪装小火箭无法导入订阅？#

中国大陆 App Store 里的所谓“小火箭”全部是盗版伪装软件，缺乏代理协议内核。真正的 Shadowrocket 必须使用美区或外区 Apple ID 在外区 App Store 下载。

Q32: 订阅更新时提示 No Network Connection 是什么原因？#

说明手机当前处于断网状态（未连 Wi-Fi 且未开移动数据），或者小火箭在 iOS 设置中的“无线局域网与蜂窝网络”权限被误关。

Q33: 为什么有些机场提供多个不同备用域名的订阅链接？#

机场为了防止主力 Api 域名被国内 GFW 污染阻断，通常会提供 2–3 个备用订阅域名。一旦主订阅更新失败，切换为备用订阅域名即可继续同步。

Q34: 在小火箭里怎么给订阅添加自定义的代理前缀？#

长按订阅选择编辑，在“节点前缀”栏中填入自定义文本（如 [机场A]），小火箭更新后会自动在所有该订阅的节点名称前加上该前缀，方便多机场区分。

Q35: 订阅链接里的 UDP=1 参数代表什么？#

代表该订阅下的所有节点默认开启了 UDP 报文转发支持，可以正常用于外服手游语音、STUN 穿透与 FaceTime 通话。

Q36: 为什么小火箭更新订阅时进度条卡在 99% 不动？#

通常是因为订阅中某个特定节点的解析卡死，或者网络在中途遭遇丢包。划掉小火箭后台重新打开并再次点击更新即可。

Q37: 小火箭导入订阅后怎么一次性测试所有节点？#

在首页节点列表展开状态下，点击顶部右侧的 “连通性测试” 文本，小火箭即会对该订阅下的所有节点发起并发延迟测试。

Q38: 订阅导入成功后，软件主页最上方的“全局路由”应该选什么？#

日常使用务必选择 配置 (Config)。在此模式下，国内应用直连、国外网站走代理节点、广告流量自动拦截，实现无感科学上网。

Q39: 为什么有些机场的订阅链接导入小火箭后，节点名称中包含了用户流量与过期时间的提示信息？#

这是因为机场服务端在返回 Base64 订阅数据流时，在首行注入了一个特殊的虚拟 Dummy 节点，或者在 HTTP 响应头部 Header 中携带了 subscription-userinfo 字段（例如 upload=1073741824; download=10737418240; total=107374182400; expire=1767225600）。小火箭客户端在接收到标头后，解析引擎会自动读取其中的上传字节数、下载字节数、总套餐流量上限与 Unix 时间戳格式的到期时间，并在首页订阅分组的标题栏或首行节点中渲染展示为可读的流量监控提醒（如 [已用: 10GB / 剩余: 90GB / 到期: 2026-12-31]），方便用户无需打开网页即可实时掌握套餐使用情况。

Q40: 为什么小火箭连接代理后，访问国内某些银行 App 或政务网站会提示“拒绝连接”或“安全风险”？#

国内大多数银行 App、手机银行系统及政务服务平台设置了严格的网络安全风险控制体系与 IP 动态审计。当小火箭开启全局代理模式时，所有的网络数据包都会先绕道海外代理节点再折返回国内服务器，银行系统识别到当前的登录请求来自于海外机房数据中心 IP（而非用户本地运营商真实归属地 IP），会触发防欺诈防盗刷风控机制，直接阻断通信或强制退回到登录界面。因此，在日常使用小火箭时，强烈建议将主页最上方的“全局路由”设定为 配置 (Config) 模式，并通过内置规则将所有国内 IP (GEOIP,CN,DIRECT) 与国内域名划归为本地直连，确保金融安全与网络顺畅两不误。

Q41: 小火箭导入订阅后，如何给特定的节点绑定固定的域名分流规则？#

在小火箭的高级分流模块中，用户可以通过编辑配置文件的方式为指定节点绑定专属域名流量。打开小火箭底部 配置 (Config) 标签页，长按当前生效的配置文件选择 编辑 (Edit)，在 [Rule] 规则段落中添加指定规则。例如，如果你希望所有的 GitHub 流量固定走名称包含“香港 01”的专线节点，可以添加规则：DOMAIN-KEYWORD,github,Proxy,node-name="香港 01"；如果你希望特定流媒体流量走特定的美国节点，可以添加 DOMAIN-SUFFIX,netflix.com,Proxy,node-name="美国 05"。保存配置后重新加载，小火箭分流引擎就会在后台自动完成精细化的节点级域名分流。

Q42: 为什么小火箭自动更新订阅时，手机电池选项里“Shadowrocket”的耗电比例迅速上升？#

在 iOS 系统的电池功耗统计机制中，所有通过小火箭代理隧道转发的网络应用数据流量（如 YouTube 视频播放、Twitter 图片加载、Safari 网页浏览）所产生的系统无线网卡与加密 CPU 耗电，都会被 iOS 系统统一归算在“Shadowrocket”这一个应用名下。实际上，小火箭软件本身在后台静默刷新订阅仅消耗极微弱的 CPU 资源。如果在电池统计中发现小火箭耗电占比偏高，这属于 iOS 系统的正常统计特征，并不代表小火箭软件本身存在异常耗电 bug。

Q43: 使用自建 Sub-Store 或 SubConverter 转换订阅时，如何保护 Token 密码不被中转服务器抓取？#

如果你担心使用公共免费的订阅转换服务器会导致自己的机场 Token 被第三方日志记录并盗刷流量，最安全的解决方案是在本地环境或个人云服务器（如 Docker 或 Cloudflare Workers）上搭建私有独享的 Sub-Store 或 SubConverter 转换服务。在私有部署的容器中，设置严苛的访问 Key 密钥，所有 API 请求均通过个人 HTTPS 加密域名传输。这样既能灵活合并多个机场的节点订阅并过滤无用节点，又彻底杜绝了第三方服务器记录 Token 隐私的风险。

Q44: 为什么小火箭导入订阅后，部分节点显示 TCP Reset 但网页依然能打开？#

在小火箭中发起连通性测试时，客户端向测试 URL 发起三次握手。如果节点入口 IP 遭遇了 GFW DPI 设备的单向干扰，DPI 会伪造 RST 报文切断连接，导致测试界面显示 TCP Reset。但在开启代理浏览网页时，如果小火箭开启了 TLS 伪装 (SNI SNI Mux / Vision / REALITY) 或 UDP 封装，实际的数据转发报文避开了被 DPI 特征拦截的测试端口，从而实现了在测试报错的情况下依然能够顺畅访问网页的反常现象。

十一、 总结与最佳维护建议#

掌握 Shadowrocket 订阅导入与自动更新，是保障 iOS 端科学上网体验的基础。在生产环境的日常维护中，请牢记以下最佳使用习惯：

1. 导入方式首选一键或 Subscribe：手动添加订阅时务必确认 Type 选择为 Subscribe，避免误存为单节点；
2. 开启静默自动更新：在设置中开启 “打开时更新” 与 “保持节点排序”，兼顾节点最新状态与个人使用习惯；
3. 避开代理更新死锁：遇到订阅更新失败时，优先将全局路由切为 配置 (Config) 或 直连 (Direct)，排除坏掉的代理节点对更新流量的干扰；
4. 妥善保管订阅 Token：切勿将含有个人密钥的订阅链接公开发布，防止套餐流量被他人盗刷。

[相关文章：Shadowrocket (小火箭) 节点怎么选择？连通性测试与延迟优化] [相关文章：Shadowrocket (小火箭) 测速超时怎么办？超时-1与延迟无响应排查] [相关文章：Shadowrocket (小火箭) 基础设置与零基础下载安装教程] [相关文章：Clash Verge Rev 订阅更新失败：Network Error与转换异常解决]