Kitty Network

Shadowrocket 使用教程：从订阅导入到首次连接排查

更新于 2026-10-27 · kitty.christmas

简答：Shadowrocket 的正确使用顺序是：先确认安装的是 App Store 中的目标应用，再准备订阅链接或单个节点资料，完成导入、更新、选节点、授权连接和实际业务验证。客户端不等于订阅，导入成功也不等于节点可用；如果开关已打开但网页仍打不开，应按“资料—节点—路由—系统网络”顺序排查。本文为第三方使用指南，不代表产品官方。

定义：Shadowrocket 是一款面向 Apple 设备的规则代理客户端，用于导入已有服务器或订阅资料并按规则处理网络请求，本身不等于线路或订阅服务。

先试这一步：准备资料并完成首次连接

如果你只是想让 Shadowrocket 先完成一次有效连接，不要一开始修改 DNS、规则或 HTTPS 解密。先准备一条完整订阅链接，或者准备单个节点所需的协议、服务器地址、端口和认证信息。App Store 将 Shadowrocket 描述为规则代理工具，并列出 iPhone、iPad、Mac、Apple TV 等兼容设备；实际系统要求、商店显示内容和应用界面仍应以你当前所在地区的 App Store 页面为准。App Store：Shadowrocket 产品页面

  1. 核对应用：在 App Store 搜索 Shadowrocket，检查应用名称、开发者、图标、系统要求和当前商店信息。不要因为名称相同或相似就从不明网页下载安装包，也不要把共享 Apple ID 当作长期安装方案。
  2. 准备资料：如果你拿到的是订阅链接，就使用订阅导入入口；如果只有服务器地址、端口、协议和密码，就使用对应的单节点入口。不要把订阅链接粘贴到 Host、Port 等单节点字段中。
  3. 导入订阅：打开应用，进入 Home，点击加号或 Add Server，寻找 Subscribe、URL 或类似订阅入口，粘贴完整链接并保存。不同版本、语言和设备的菜单名称可能不同，应以当前界面中含有 Subscribe、URL、Add Server 的入口为准。
  4. 更新并确认列表：保存后执行更新或刷新，确认页面确实出现节点或服务器组。只有保存了订阅地址、但列表仍为空，不代表导入成功。
  5. 选择节点：先选一个测试结果正常、延迟相对较低的节点。延迟只反映测试请求的响应时间，不能单独代表网页打开速度、视频缓冲或文件传输速度。
  6. 选择路由：首次排查可以先选择 Proxy 做连通性对照；确认节点可用后，再根据配置规则使用 Config；Direct 用于不经过代理的对照测试。Config、Proxy、Direct 是流量处理方式，不是速度等级。
  7. 允许系统连接：首次开启连接时，系统可能要求确认网络或 VPN 相关权限。只有在确认请求来自已经安装的应用后再授权。不要把“VPN 与设备管理”中的配置描述文件页面，误认为是所有应用连接状态的统一管理页面；Apple 对配置描述文件的查看和删除路径是“设置 → 通用 → VPN 与设备管理”。Apple：在 iPhone 上安装或移除配置描述文件
  8. 验证实际业务：不要只看开关是否变绿或状态栏是否出现连接标识。打开一个你明确知道应当能够访问的网页或应用，再切换 Direct 做同一目标的对照；记录节点、路由模式和结果。

最短闭环：准备资料 → 导入或编辑 → 保存 → 更新 → 选节点 → 选择路由 → 授权连接 → 查看状态 → 用实际网页或应用验证。

客户端、订阅、节点和配置文件有什么区别

Shadowrocket 新手最容易卡在“应用已经安装，但不知道下一步做什么”。App Store 页面说明它是网络工具和规则代理客户端，应用本身不会替你生成订阅或服务器资料。因此，客户端购买、订阅服务和节点可用性是三个不同问题，不能用其中一个结果推断另外两个一定正常。App Store：Shadowrocket 功能说明

项目负责什么常见入口或表现不要混淆的地方
客户端读取资料、处理规则并建立本地网络连接App Store 安装安装客户端不代表已经拥有节点
订阅链接批量获取或更新服务器列表Home → 加号或 Add Server → Subscribe不能当作单个服务器地址填写
单个节点保存一个服务器的协议、地址、端口和认证参数Add Server → 对应协议类型缺少协议或认证字段时无法据此判断节点故障
配置文件定义规则、策略组和流量如何分流Config 或配置相关入口配置文件不等于服务器列表
路由模式决定当前请求采用规则、代理还是直连Config、Proxy、Direct 或 Global Routing切换路由不能修复失效订阅或不可达节点

如果你只有一条订阅链接，优先使用 Subscribe 或类似订阅入口；如果你只有一组单独参数，才选择具体协议并逐项填写。若当前版本提供二维码或文件导入入口，也应在导入后检查服务器类型、地址和名称，避免把扫码成功误认为连接成功。

Config、Proxy、Direct 怎么选：先用对照法定位问题

首次配置时，建议一次只改变一个变量。先用 Proxy 测试选中的节点，再用 Direct 访问同一个目标做对照，最后回到 Config 检查规则是否按预期分流。这样可以把“节点不可达”和“规则没有命中”分开，而不是反复切换设置后失去判断依据。

现象或目标先选择验证方法结果意味着什么
刚导入订阅，想确认节点是否能连Proxy选一个节点，连接后访问同一个已知可用网址如果 Proxy 成功，说明至少当前节点和基本路由存在可用迹象，但不代表所有业务都正常
日常按规则分流Config检查活动配置、规则命中和目标域名对应策略如果特定域名不通，优先检查规则或策略组，不要先更换所有节点
判断是否是代理导致异常Direct保持同一网络和同一目标，关闭代理后再次访问Direct 成功、Proxy 失败时，应继续检查节点、协议、DNS 或代理规则
所有节点看起来都超时先不要反复切换模式用 Direct 访问一个已知可用网址，随后重新更新订阅并测试其他节点Direct 失败只能说明该次直连对照未成功，不能单独证明本地网络完全正常

App Store 页面还列出网络速度测量、DNS 相关和规则处理等功能，但具体按钮名称和测试结果展示可能随版本变化；不要把单次延迟数字直接当成长期速度或稳定性结论。App Store：Shadowrocket 功能列表

Shadowrocket 连接失败：按“现象—检查—验证”处理

现象优先检查处理步骤验证结果意味着什么
订阅保存后没有节点链接是否完整、是否有空格或换行、更新请求是否完成重新复制完整链接，删除后重新添加并执行更新；不要擅自删掉问号后的参数仍为空时，问题可能在订阅返回内容、链接有效性或应用解析结果，需向资料提供方核对
节点列表出现但全部超时当前 Wi-Fi 或蜂窝网络、订阅有效性、节点地址和端口先用 Direct 访问一个已知可用网址做对照，再更新订阅并测试不同节点或另一种网络只在一个网络超时，优先检查该网络环境；不同网络都超时，再核对订阅和节点资料
显示已连接但网页打不开活动配置、路由模式、DNS、目标网页和其他网络工具从 Config 切到 Proxy 做对照，再访问普通网页；记录是否所有网页都失败只有特定域名失败，重点看规则和 DNS；全部失败，继续检查节点和系统网络
只有某个 App 不通应用自身连接方式、规则是否命中、局域网权限或服务端限制用同一节点访问其他网页和应用，再临时切到 Proxy 对照；不要直接关闭所有安全校验其他业务正常而单个 App 失败，不能直接判定节点失效
连接一会儿就断Wi-Fi 与蜂窝网络切换、其他 VPN、过滤器或安全软件关闭其他网络工具后单独测试，并分别记录 Wi-Fi 和蜂窝网络结果只在网络切换时断开，优先记录切换时刻和系统状态，再定位网络环境或应用兼容性

Apple 的排查建议也涉及检查 VPN、过滤器和第三方安全软件。删除或调整设备上的配置前，先确认它不是学校、公司或其他管理机构下发的配置；不确定来源时不要直接删除。Apple：检查 VPN 和第三方安全软件

下载、权限和订阅安全：哪些操作要谨慎

下载时，优先从当前地区的 App Store 页面核对应用名称、开发者和系统要求。商店页面显示的兼容设备和系统版本可能因地区、设备和系统变化而不同，不能把其他地区页面的显示内容当成你设备一定支持的结论。

首次连接需要系统授权时，只在确认请求来自已安装应用的情况下同意。Apple 的配置描述文件页面用于查看和移除已安装的配置文件；如果删除配置文件，相关设置、应用或数据可能一并受到影响，因此不要把它当作普通“清理缓存”操作。Apple：配置描述文件的查看与移除

订阅链接应按私密资料处理：不要把完整链接放到公开截图、论坛或群聊中，也不要在求助时粘贴包含鉴权参数的完整地址。需要反馈时，可遮盖敏感参数，只保留错误类型、发生时间、网络类型、节点名称和路由模式。

App Store 页面列出 HTTPS 解密、规则重写和 DNS 相关功能，但这不代表所有场景都应开启。涉及证书、流量查看或请求改写的功能，应先确认用途、来源、影响范围和撤销方式；没有明确需求时保持默认关闭，不要为了排错随意安装陌生证书或关闭安全验证。App Store：Shadowrocket 功能与隐私说明

首次连接后的自查清单

完成自查后仍无法连接，建议保留错误时间、当前网络类型、节点名称、路由模式和应用提示，再向资料提供方核对订阅有效性或服务器参数。公开求助时不要发送完整订阅链接、密码、设备截图中的个人信息或证书内容。

常见问题

Shadowrocket 安装后为什么没有节点？

因为客户端和订阅服务是两回事。Shadowrocket 负责读取你提供的配置或服务器资料，不会因为安装完成就自动生成节点。你需要导入已有订阅链接，或手动填写单个节点的协议、地址、端口和认证信息。App Store 产品说明</a>

Shadowrocket 订阅链接在哪里导入？

通常可在 Home 中点击加号或 Add Server，寻找 Subscribe、URL 或类似订阅入口，然后粘贴完整链接并保存、更新。不同版本、语言和设备的入口名称可能变化，应以当前界面中对应的订阅字段为准。不要把订阅链接填入 Host 字段。

Shadowrocket 的 Config、Proxy、Direct 有什么区别？

Config 通常按配置规则分流，Proxy 用于选择节点处理请求，Direct 用于不经过代理的对照测试。它们是路由方式，不是速度等级；首次排查建议先用 Proxy 与 Direct 访问同一个目标，再回到 Config 检查规则。

Shadowrocket 显示连接成功但网页打不开怎么办？

先确认系统连接授权已完成，再用 Proxy 和 Direct 访问同一个已知可用网址做对照；随后检查活动配置、规则、DNS、其他 VPN、过滤器和安全软件。若只有单个 App 不通，不要直接判定所有节点失效。<a href="https://support.apple.com/en-gb/102281">Apple：VPN 与第三方安全软件排查</a>

订阅更新后节点全部消失怎么办？

先检查订阅链接是否完整、是否过期或被截断，再重新复制并更新。若仍没有节点，向资料提供方核对返回内容和订阅有效性；不要在公开渠道发送完整订阅链接。

Shadowrocket 支持哪些设备？

当前 App Store 页面列出 iPhone、iPad、Mac、Apple TV 等设备和对应系统要求，但商店内容会因地区、设备和系统版本变化。最终应以你当前地区的 App Store 页面和设备实际兼容性为准。<a href="https://apps.apple.com/us/app/shadowrocket/id932747118">App Store：兼容性信息</a>

“VPN 与设备管理”里没有 Shadowrocket，是否代表连接失败？

不一定。Apple 的“VPN 与设备管理”页面主要用于查看和移除配置描述文件，不应单独作为所有应用连接状态的判断依据。应结合应用内连接状态、系统提示和实际网页或应用访问结果判断。<a href="https://support.apple.com/en-gb/guide/iphone/iph6c493b19/27/ios/27">Apple：配置描述文件管理说明

相关阅读

参考资料

  1. App Store：Shadowrocket 产品页面
  2. Apple：在 iPhone 上安装或移除配置描述文件
  3. Apple：检查 VPN 和第三方安全软件以排查网络问题