Shadowrocket 教程：安装、添加订阅与排错

Shadowrocket 教程的核心只有三步：从 App Store 安装应用，拿到与 Shadowrocket 对应的订阅链接，再在应用中找到订阅导入位置完成添加。不同版本的位置和文字可能不同，请以设备实际显示为准。导入后可用应用内的连通性或延迟测试观察结果，再选择节点和路由方式；整个过程不需要手写节点参数。

本文把 VilaVPN 的兼容流程与 Shadowrocket 的通用导入思路放在一起说明。Shadowrocket 是网络工具，不提供服务器，VilaVPN 新用户应先使用 VilaNet，只有确有兼容需求时再使用第三方客户端。

一、先准备好应用与订阅

1. 从官方渠道安装

1. 在 App Store 搜索 Shadowrocket，核对开发者为 Shadow Launch Technology Limited。不要把来路不明的安装包、共享账号或所谓“免费节点”当作教程的一部分。
2. 首次打开时，按设备实际出现的准备提示完成设置；本文不把未核对的按钮文字当作固定步骤。
3. 如果你是 VilaVPN 新用户，先看官方应用选择说明并安装 VilaNet；本文的 Shadowrocket 流程适合已经确定要使用兼容客户端的人。

2. 在 VilaVPN 客户区复制链接

1. 登录 VilaVPN 客户区，打开对应产品的详情页，点击“复制订阅链接”。不要把链接粘贴到公开聊天、截图或工单中。
2. 如果页面要求先“激活订阅”，完成激活后再复制。订阅链接已经泄露或不再可用时，在产品详情页使用“重置订阅链接”，然后只保留新的链接。
3. 请使用 Shadowrocket 对应的订阅链接。VilaVPN 的服务端会按客户端选择不同的渲染器，不能把一个客户端的输出格式随意替换成另一个客户端的格式。

二、Shadowrocket 添加订阅

1. 打开 Shadowrocket，在首页找到添加订阅或添加配置的位置；不同版本可能使用图标或不同文字，按实际显示选择。
2. 在添加表单中选择用于远程订阅的类型，而不是单个节点的手工配置类型。
3. 把刚复制的链接粘贴到订阅地址输入框，保持字符完整并放在同一行。
4. 提交表单后回到首页，检查是否出现订阅条目或节点列表。
5. 如果列表暂时为空，使用该订阅条目提供的刷新或更新动作，再观察结果并记下出现的提示。

Shadowrocket 还支持其他导入方式，本文聚焦于 VilaVPN 的订阅导入。实际版本的位置和文字请以设备显示为准。使用订阅可以一次导入服务端下发的参数，手工填写会增加漏项风险；后续更新时继续使用原订阅条目。

三、协议、节点与路由模式怎么选

VilaVPN 当前在售 VilaNet 计划的协议是 Shadowsocks、Hysteria2 和 AnyTLS。VilaVPN 订阅接口（官方数据）会为 Shadowrocket 格式处理这三类服务端节点，并生成对应的订阅条目。因此，导入后看到的名称和数量以你的产品、有效期和当时可用节点为准，不需要自行补写协议参数。

如果你误用了 v2rayN 的订阅格式，AnyTLS 不会出现在该格式的输出中；这时应回到产品详情页重新复制 Shadowrocket 对应链接。不同客户端的订阅格式不是“换个软件名”这么简单，格式选错时，节点少或协议缺失并不代表 Shadowrocket 本身异常。

可以把路由方式理解为四类功能：按规则分流、把流量交给所选节点、全部直连，或根据网络环境切换预设。具体名称和可用项请以实际版本为准。

理解应用内的连通性测试

如果应用提供基于 CONNECT 的测试，它对应的是 HTTP 隧道语义。RFC 9110 第 9.3.6 节把 CONNECT 定义为请求接收方建立到目标的隧道；收到成功的 2xx 响应头后，连接进入隧道模式，后续数据在双方之间转发。这样的结果只能说明这次隧道建立请求是否成功，不能代替网页完整加载或文件传输测试。

在 iOS 上，VPN 客户端还要通过 Apple Network Extension 管理系统级隧道：NETunnelProviderManager 用于创建和管理自定义协议的 VPN 配置，NEPacketTunnelProvider 是数据包隧道提供程序扩展的主体类。Shadowrocket 的测试位置、名称和显示方式请以设备版本为准。

第一次连接的顺序

1. 完成应用的首次准备后，在应用中选择一个可用节点并运行一次应用内测试；之后再开启 VPN。若导入内容未出现或连接未建立，分别记录各自提示。
2. 连接后打开常用网页，确认能正常加载；不要只看一个瞬间的状态文字。
3. 同一设备测试时只运行一个 VPN 客户端。若你准备从旧客户端迁移到 VilaNet，先确认 VilaNet 能正常使用，再断开旧客户端；两个客户端同时接管系统 VPN 权限可能互相冲突。

排查时每次只改一个选项，并记录改动前后的结果。这样才能区分订阅、节点、协议和当前网络的影响；一次改动太多，后面即使恢复也很难知道真正起作用的步骤。

四、常见问题

Q1：导入后显示 “Not Service” 怎么办？

这是订阅请求没有匹配到有效服务的提示，常见原因是链接复制不完整、链接已重置，或复制了旧链接。回到产品详情页重新复制；如果你刚执行过“重置订阅链接”，旧链接应立即停止使用。

Q2：显示 “Not Active” 是 Shadowrocket 出错吗？

不是。VilaVPN 的订阅端会在服务未处于 Active 状态时返回这个正文。先检查产品状态和到期时间，再回到 Shadowrocket 刷新该订阅并观察新的提示；不要通过反复安装应用来解决服务状态问题。

Q3：提示 “Subscription not activated…” 如何处理？

回到 VilaVPN 产品详情页完成“激活订阅”，然后在 5 分钟内重试。服务端提示本身已经说明需要在产品详情页激活；如果仍失败，保留完整英文提示、应用版本和 iOS 版本，联系官方支持时不要发送订阅链接、二维码或密码。

Q4：导入成功，但节点比预期少？

先确认你使用的是 Shadowrocket 对应的订阅格式。当前 VilaVPN 计划的协议范围是 Shadowsocks、Hysteria2 和 AnyTLS，而 v2rayN 订阅格式不含 AnyTLS；换错格式时，节点列表自然会不同。确认格式后再刷新一次订阅，不要手工拼接缺失节点。

Q5：能连上，但实际使用不稳定怎么办？

先用应用内测试比较不同节点，再切换协议；随后分别用 Wi-Fi 和蜂窝数据做一次真实任务，并在高峰、非高峰各观察一次。若只有某个网络或某个节点失败，记录节点名称、时间、测试结果和确切错误；不要把一次短暂失败直接归因于某个协议。

五、VilaVPN 的更简单路径

VilaVPN 目前销售的是 VilaNet Standard、Supreme、Extreme 计划。新用户建议直接使用VilaNet 官方下载页上的应用；已经有 Shadowrocket 使用习惯、且确实需要第三方兼容时，再按本文导入。你还可以继续阅读v2rayN 订阅添加说明、协议对比文章和VPN 故障排查指南。

访问 VilaVPN查看当前套餐和账户页面。订阅链接属于账户凭证，请只在官方页面复制和更新。

参考来源

1. Apple App Store：Shadowrocket
2. RFC 9110：CONNECT 方法
3. Apple NetworkExtension：NETunnelProviderManager
4. Apple NetworkExtension：NEPacketTunnelProvider
5. VilaVPN 帮助中心：第三方 V2Ray 客户端
6. VilaVPN 帮助中心：选择合适的 VilaNet 应用

VilaVPN 编辑部