Shadowrocket 使用指南：从安装到连接排错

更新于 2026-11-02 · vpnpn.shop

简答：Shadowrocket 本身是规则代理客户端，不自带线路、订阅或服务器。使用前先在 App Store 核对开发者 Shadow Launch Technology Limited、应用 ID 932747118，再根据手里的订阅链接、二维码或单节点参数选择导入方式。完成导入后，依次检查服务器、Global Routing、系统 VPN 权限和实际网页访问结果；只看到 VPN 图标不能证明连接可用。

定义：Shadowrocket 是一款用于导入代理配置、选择路由规则并建立系统网络连接的客户端，应用购买与连接服务是两回事。

先看速查卡：你手里是什么资料，就选什么入口

本文按 iPhone、iPad 的常见界面说明，菜单名称可能随版本或系统语言变化。Shadowrocket 的 App Store 页面显示，它是独立的规则代理工具，不包含代理服务或服务器资源；截至 2026-11-02，页面显示的美国区参考价格为 2.99 美元，实际购买金额应以你当前 App Store 页面为准。查看 App Store 产品页

Shadowrocket 首次配置入口对照

你已有的资料	应选入口	成功标准	不要这样做
完整订阅 URL	Home → Add Server → Type → Subscribe	Home 的 SERVER 区出现订阅分组和至少一个条目	不要把账户管理页当订阅地址
二维码	Add Server → Scan QR Code	扫描后核对 Type、地址、端口和协议字段	不要把二维码图片本身当作可用性证明
单节点分享链接	复制完整链接，按应用提示导入	SERVER 区出现单个服务器条目	不要把整条分享链接粘贴进 Host
Host、Port、Password、UUID 等参数	Add Server → 选择对应 Type → 手动填写	保存后条目字段与原始资料一致	不要混用不同协议的字段
兼容的 Cloud JSON	Add Server → Import from Cloud JSON	应用能读取并生成配置	不要把普通订阅 URL 当作 JSON 文件

先试这一步：如果你已有订阅链接，优先使用 Subscribe；如果只有一个节点或二维码，不要反复尝试 Subscribe。订阅、单节点和规则 Config 是不同对象，导入其中一个不会自动补齐另外两个。参阅公开使用说明中的导入区分

安装前核验：避免买错应用或误以为自带线路

在 App Store 搜索时，不要只看名称和图标。打开产品页，核对开发者是否为 Shadow Launch Technology Limited，应用 ID 是否为 932747118，并检查兼容设备、价格和更新记录。App Store 搜索不到，不等于应用一定下架，也可能与当前 Apple Account 的商店地区有关。核对 Apple App Store 页面
购买前确认你使用的是自己的 Apple Account 和 Media & Purchases 账户。不要为了下载而把陌生账号登录到 iCloud；如果页面要求使用陌生账号、安装来源不明的描述文件或下载非 App Store 安装包，应停止。
理解三层关系：App 是客户端，订阅服务或服务器资料负责提供连接参数，Config 文件负责组织规则和路由。购买 App 不会自动产生可用服务器或订阅。查看购买、订阅与配置的区分说明
如果你以前购买过，换设备或重装时先检查 App Store 的 Purchased 或购买记录。购买记录恢复不等于应用内服务器、订阅 URL 和自定义规则自动恢复，所以更新或重装前应先保存必要配置。

订阅 URL 可能包含账户识别参数。不要把完整链接放进公开截图、群聊、工单或论坛；如需求助，只提供报错文字和脱敏后的界面信息。

Shadowrocket 导入与首次连接：最短闭环

1. 导入订阅链接

打开 Shadowrocket，进入 Home，找到 Add Server。
在 Type 中选择 Subscribe，把完整订阅 URL 粘贴到 URL 字段并保存。不要删掉问号后的参数，也不要混入换行、空格或说明文字。
返回 Home，检查 SERVER 区是否出现订阅分组和条目。导入成功的判断不是“保存按钮出现”，而是至少能看到可选择的服务器，并且 Type、Host、Port 等信息与提供方资料相符。

2. 手动添加单节点

在 Add Server 中选择与原始资料一致的协议 Type，再填写 Host 和 Port。
根据该协议实际要求填写 Password、Method、UUID、TLS、SNI、传输方式等字段。不同协议字段不通用，不能因为某个字段为空就随意补值。
保存后回到 Home，选中刚添加的服务器。若能保存但无法连接，优先重新核对地址、端口、认证信息和协议字段，而不是先修改 DNS 或规则。

3. 二维码或分享链接导入

二维码只是一种携带配置的方式，不代表其中参数一定正确。扫描后仍要核对协议、地址、端口和关键认证字段；扫描失败时检查二维码是否完整、清晰，且内容是否为客户端可识别的配置。单节点分享链接应完整复制，并按应用提示导入。查看 Add Server 字段与导入说明

4. 选择路由并授权

Home 中的 Global Routing 通常包含 Config、Proxy、Direct。Config 按当前选中的规则文件处理请求，Proxy 便于测试是否能统一经过代理，Direct 则用于对照当前网络的直连结果。它们不是服务器选择器；服务器仍需在 SERVER 区单独选中。

首次连接时，iOS 可能要求添加 VPN Configuration。只有在确认该提示由 Shadowrocket 的连接操作触发后，才按系统提示授权。授权只代表系统允许客户端建立本地网络配置，不代表服务器参数已经正确。

5. 验证“真的可用”

确认 Home 显示已连接，且选中的 SERVER 不是空分组或旧条目。
运行 Connectivity Test 或应用内连通性测试，记录测试时间、网络环境和所选服务器。
再访问一个你平时能打开的网页。测试成功不保证所有网页都能加载，因为 DNS、规则匹配、目标站响应和当前路由模式都可能影响结果。
如果只有部分域名异常，优先检查 Config 规则和 DNS；如果所有网页都失败，优先检查网络本身、订阅有效性、服务器字段和系统权限。

Config、Proxy、Direct 怎么选：先定位问题，再恢复常用模式

Global Routing 模式的使用场景

模式	作用	适合什么时候用	注意事项
Config	按照当前启用的配置文件和规则处理请求	日常使用，且你已确认规则来源和匹配逻辑	确认 Config 页面真正选中了正在编辑的文件
Proxy	让请求统一经过当前选择的代理路径	排查规则是否导致某个请求走错方向	不能修复错误的服务器参数
Direct	按当前网络直接访问	与 Proxy 结果对照，判断问题是否来自代理路径	直连成功不代表代理配置正确

排查时一次只改一个变量。例如先保留同一服务器，在 Config 与 Proxy 之间切换；记录结果后再检查 DNS 或规则。不要同时换节点、换 Config、改 DNS 和重装应用，否则无法判断是哪一步产生了变化。规则文件中，较宽泛的规则如果排在前面，可能先匹配并覆盖后面的更具体规则；修改前应保留原文件。

常见故障分流：按现象处理，不要盲目重装

订阅导入后分组为空

先确认使用的是完整订阅 URL，而不是登录页、介绍页或单节点分享链接；再检查 URL 是否仍有效、当前网络能否访问，以及返回内容是否为客户端能读取的格式。不要立即删除原订阅，先保留原链接和现有配置。

出现 timeout 或连接开关立即回落

先核对当前选中的服务器、Host、Port、Password、UUID、TLS、SNI 和传输参数。若系统 VPN 权限被取消、设备管理策略限制或其他 VPN 功能同时运行，也可能导致开关无法保持。暂停其他 VPN 功能后，只重新测试一个已核对的条目。

显示已连接但网页打不开

先关闭 Shadowrocket，确认 Wi-Fi 或蜂窝网络本身能正常工作。
重新连接，确认选中的是正确 SERVER 条目。
判断是所有网页失败，还是只有少数域名失败。
全部失败：检查订阅、节点参数、DNS 和系统权限；部分失败：检查 Config 规则、DNS 和目标域名。
可临时使用 Proxy 做一次对照测试，完成后恢复原来的路由模式。

更新后节点列表没变化

确认更新的是当前正在使用的 Subscribe 条目，而不是同名旧条目；检查是否有更新报错，以及服务端是否实际返回了新内容。列表不变不一定代表更新失败，也可能是订阅内容没有变化。

安全与回退清单：什么时候应该停止

无法互相印证 App Store 开发者、应用 ID 和产品页时，不要购买或安装。
无法确认订阅 URL 来源、账户归属、有效期或服务条款时，不要继续导入。
不要公开分享包含令牌、密码、UUID 或密钥的订阅链接和截图。
更新、重装或删除配置前，先保存订阅 URL、手动节点参数、当前 Config 和自定义规则；删除或重置可能影响关联设置，应以系统提示和当前应用界面为准。
如果修改一次后仍无法判断问题，回退到最近一次可工作的配置，换回原网络环境，再逐项验证。

本文只提供客户端识别、配置导入和网络连接排查框架，不替用户判断任何订阅服务的信誉、可用性或合规性。

常见问题

Shadowrocket 是不是买了就能直接使用？

不是。App Store 购买的是客户端本身，不包含订阅、服务器或线路。你仍需准备自己的订阅链接、二维码、单节点分享链接或完整服务器参数，然后在应用中导入。

Shadowrocket 在 App Store 搜不到怎么办？

先打开产品页并核对开发者 Shadow Launch Technology Limited、应用 ID 932747118、价格和兼容性。若当前 Apple Account 的商店地区不提供该应用，搜索结果可能为空；不要改用名称相似的应用，也不要登录陌生 iCloud 账号。

订阅链接应该在哪里导入？

进入 Home → Add Server → Type → Subscribe，粘贴完整 URL 并保存。导入后必须回到 Home 检查订阅分组和服务器条目，不能只以保存成功作为判断。

二维码扫描成功，但为什么仍然连不上？

二维码只负责携带信息，不能证明地址、端口、认证字段或服务器状态正确。扫描后核对 Type、Host、Port 以及协议要求的 Password、UUID、TLS、SNI 和传输参数。

VPN 图标出现了，是否代表 Shadowrocket 已经可用？

不一定。VPN 图标通常只能说明系统网络配置已建立；还要确认选中的服务器、连通性测试和实际网页访问结果。若只有部分网页异常，重点检查规则和 DNS；全部网页异常则先查节点、订阅和网络。

Config、Proxy、Direct 有什么区别？

Config 按当前配置文件规则处理，Proxy 便于测试统一经过代理，Direct 用于直连对照。它们不是服务器列表，也不能修复错误的 Host、Port 或认证参数。