缥缈墟 - 发布页

iPhone Shadowrocket 使用指南：安装、订阅导入与连接排查

更新于 2026-11-01 · piaomiaoxu.site

简答：如果你刚开始使用 Shadowrocket，先完成三步：在 App Store 核对应用信息，准备有效订阅链接并通过 Home →“+”→ Subscribe 导入，选中节点后开启连接并按提示允许 VPN 配置。没有订阅、导入后无节点、显示 VPN 仍打不开网页，应分别排查，不要一开始同时修改规则、DNS 和协议参数。本文只讲 iPhone 上的 Shadowrocket，不覆盖其他客户端、具体服务商评价或节点购买。

定义：Shadowrocket 是运行在 iPhone 上的规则代理客户端，应用本身不自动提供节点或连接服务，用户需要另外准备订阅链接、二维码或完整服务器参数。

先看现象：三分流速查表

本文是缥缈墟整理的第三方使用指南，不是 Shadowrocket 或 Apple 的官方页面。菜单名称以 iPhone 当前显示为准，应用版本、商店地区和 iOS 界面可能造成细节差异。

Shadowrocket 新手先查什么
现象最小检查动作下一步
安装后 SERVER 为空确认是否已有订阅 URL、二维码或完整服务器参数。没有连接资料时先向资料提供方获取；客户端不会自动生成节点。
订阅保存后没有节点检查是否选择 Add Server → Subscribe，URL 是否完整且无多余空格、换行。确认当前 Wi-Fi 或蜂窝网络能访问订阅地址，再重新更新。
显示 VPN 但网页打不开确认已选节点，运行 Connectivity Test，再打开实际网页。只更换一个节点或临时对比路由模式，记录网络和错误现象。

关键结论：导入成功、VPN 图标出现、Connectivity Test 成功和网页可访问是四个不同结果。任何一个结果都不能单独证明全部连接正常。公开参考文档也建议将节点、路由模式、连接测试和实际访问分开验证。查看 Shadowrocket iOS 功能与排查参考文档

安装前：如何核验 App Store 应用

  1. 优先使用 App Store 产品页：不要仅凭搜索结果中的名称、图标或第三方下载页判断应用来源。
  2. 核对开发者和应用 ID：本次检索到的 App Store 页面显示开发者为 Shadow Launch Technology Limited，应用 ID 为 932747118。打开产品页时，应确认地址中包含对应 ID。
  3. 核对兼容性：本次 App Store 页面显示 iPhone 需要 iOS 13.0 或更高版本；发布或安装时应重新查看设备当前页面，不能把本文的核验结果当成永久不变的版本承诺。
  4. 核对应用用途：App Store 将其描述为规则代理工具，并明确说明应用不包含代理服务或服务器资源，用户需要自行提供配置。查看 App Store 产品页

如果开发者、应用 ID、图标或产品页信息对不上，先停止安装并回到 App Store 核验。本文不提供第三方安装包、共享 Apple 账户或绕过商店限制的方法。

准备连接资料：订阅、二维码和单个节点有什么区别

安装完成后，先判断手里的资料属于哪一类：

  • 订阅 URL：用于获取并更新一组服务器条目，通常应在添加菜单中选择 Subscribe。
  • 二维码：用于读取已有的连接资料，扫描后仍需检查导入结果和节点类型。
  • 单个服务器链接：通常只描述一个连接条目，应使用与该链接匹配的导入方式。
  • 完整服务器参数：包括地址、端口、协议、认证以及可能的传输或 TLS 参数，需要按资料指定的类型填写。

订阅和路由规则不是一回事：导入订阅只负责取得服务器条目，不会自动保证当前规则文件、Global Routing 或策略组符合你的使用需求。不要为了测试而猜测协议、端口、TLS 或传输参数；资料缺失时，应向提供配置的一方核对。

订阅 URL 可能包含访问凭据。不要把完整链接、二维码或带密码的截图发到公开群组、工单或日志中。公开参考文档也建议在分享排查材料前隐藏订阅参数。查看订阅、服务器与路由设置参考

iPhone 上导入订阅：按这个顺序操作

  1. 打开 Shadowrocket，进入 Home。
  2. 点击右上角的 +，进入添加页面。
  3. 选择与资料类型对应的选项；已有订阅 URL 时选择 Subscribe。
  4. 将完整 URL 粘贴到订阅地址输入框，检查开头、结尾、参数和意外换行。
  5. 保存后返回 Home，确认 SERVER 区域出现预期的服务器或分组。
  6. 选中一个节点，再运行 Connectivity Test。测试条件保持不变，便于后续比较。

停止条件：如果保存后 SERVER 仍为空，不要马上修改 DNS、规则或协议。先检查链接是否被聊天软件截断、是否误用了账号管理页、当前网络是否能访问该地址，以及返回内容是否为客户端可读取的配置格式。

验证边界：订阅导入成功只说明客户端读到了配置条目，并不代表每个节点都可用。更新订阅前，还应区分哪些条目由订阅管理、哪些条目是手动添加；订阅更新可能替换或移除订阅提供的条目。

首次连接：节点、路由模式与 VPN 授权

  1. 先选节点：在 SERVER 区域选择一个具体节点，不要停留在空分组或未选择状态。
  2. 再看 Global Routing：Config 按当前配置文件中的规则处理请求，Proxy 用于通过选定节点进行对比测试，Direct 用于直连对比。首次排查时只改变一个变量。
  3. 最后打开连接：首次启用系统 VPN 功能时，iOS 通常会弹出添加 VPN 配置的授权提示；具体提示内容以当前 iOS 和应用界面为准。确认请求确实由刚刚发起的 Shadowrocket 连接操作触发后，再完成系统认证。
  4. 连接后验证：先运行 Connectivity Test，再打开一个实际网页。VPN 图标只表示系统层配置已启用，不等于远端节点、规则和网页访问都正常。
Global Routing 三种模式的使用边界
模式作用排查时看什么
Config按照当前配置文件的规则和策略处理请求。当前配置是否已选中、规则顺序是否合理、策略名称是否存在。
Proxy用于通过选定节点进行连接路径对比。选定节点的地址、协议和认证参数是否完整。
Direct用于比较不经过代理时的直连结果。直连结果不能证明代理节点可用，也不是自动选最快节点。

规则通常按顺序检查，较宽泛的规则如果排在前面，可能先于更具体的规则生效。切换模式完成测试后，应恢复原来的模式，并确认当前配置文件仍是预期文件。查看 Global Routing、规则顺序与 Connectivity Test 说明

四种常见故障：按现象逐项排查

1. SERVER 为空：先确认有没有连接资料

最小动作是检查是否已经获得订阅 URL、二维码或完整服务器参数。Shadowrocket 本身不会自动生成节点。如果没有这些资料，继续修改路由模式或 DNS 没有意义。

2. 订阅导入失败或保存后无节点：先查 URL 和当前网络

  1. 确认使用的是完整订阅 URL，而不是登录页、介绍页或单个节点分享链接。
  2. 检查是否出现首尾空格、换行或被聊天软件截断。
  3. 确认当前 Wi-Fi 或蜂窝数据能够访问订阅地址。
  4. 确认链接没有过期、撤销或要求额外网页登录。
  5. 确认返回内容是客户端可以读取的配置格式。

如果以上条件都满足仍失败，应向配置提供方核对链接状态和返回格式，不要凭一次失败判断所有节点都不可用。

3. 开关打不开或一开启就关闭：先查授权、节点和冲突

  1. 确认 SERVER 中存在并选中了节点。
  2. 确认首次连接时的系统 VPN 配置授权已经完成；如果取消了授权，重新发起连接并按当前系统提示操作。
  3. 检查系统设置中是否有需要处理的 VPN 配置、设备管理限制或其他网络过滤功能。
  4. 暂停其他 VPN、代理或网络过滤功能后单独测试。
  5. 记录错误提示和测试网络，不要连续快速点击连接开关。

4. 显示已连接但网页打不开：先分离测试结果

  1. 运行 Connectivity Test，记录测试方法、当前网络和选定节点。
  2. 打开一个实际网页，确认问题是所有网页都存在，还是只影响某些域名或应用。
  3. 只更换一个节点进行对比，不要同时修改规则、DNS 和协议参数。
  4. 如果 Config 模式失败，可临时用 Proxy 模式进行对比；完成测试后恢复原模式。
  5. 如果测试成功但网页失败，继续检查 DNS 解析、规则匹配和目标网站本身，不能把测试结果当成网页访问保证。

公开参考文档明确区分 Connectivity Test、DNS、规则匹配和实际网页请求；单次测试成功不能证明所有网站或应用都能正常访问。查看连接授权、导入失败与网页访问排查参考

连接变慢或应用异常：低风险回滚顺序

如果导入后连接变慢、部分应用异常或只有某些网站打不开，先不要开启 HTTPS Decryption、导入陌生规则文件或一次性修改多个高级选项。建议按下面顺序回滚：

  1. 记录当前 Wi-Fi 或蜂窝网络、节点、配置文件和 Global Routing 模式。
  2. 恢复到修改前能复现的配置，暂时停用后来新增的规则、脚本或重写项。
  3. 只更换一个节点，再运行同一种 Connectivity Test，并访问同一个网页。
  4. 分别测试 Wi-Fi 和蜂窝数据，判断问题是否只出现在某一种网络。
  5. 如果问题只影响某个应用或域名，比较浏览器与该应用的结果，再检查规则和 DNS。
  6. 仍无法定位时，保留错误信息、复现步骤和测试条件，向配置提供方核对服务端参数。

完成排查后，如果问题没有改善，恢复原设置并停止继续叠加修改。端口、节点名称或测试延迟只能作为排查线索，不能单独证明长期可用性或实际访问质量。

安全提醒与版本边界

  • 不要公开完整订阅 URL、二维码、密码、密钥或包含认证参数的截图。
  • 不要把个人 Apple 账户密码交给他人，也不要登录来历不明的共享账户的 iCloud。
  • 不要安装无法确认来源的描述文件、证书或网络配置。
  • 首次出现 VPN 授权提示时，先确认它是由当前 Shadowrocket 连接操作触发的。
  • App Store 页面显示的开发者、应用 ID、兼容性和版本信息可能变化；本文发布前核验到的 iOS 13.0 兼容性只代表当时页面显示，安装时以当前 App Store 页面为准。
  • 应用购买与连接服务是两件事。App Store 产品页说明该应用不包含代理服务或服务器资源，连接资料需要用户自行准备。

本文只提供客户端使用和基础排查路径，不对任何具体订阅、节点、线路或服务状态作保证。

常见问题

Shadowrocket 买完以后就自动有节点吗？

没有。App Store 购买的是客户端使用权，不等于连接服务或节点订阅。你还需要准备自己的订阅 URL、二维码或完整服务器参数。App Store 页面也说明该应用不包含代理服务或服务器资源。

订阅链接应该填在哪里？

打开 Home，点击右上角“+”，选择 Add Server 中的 Subscribe，再粘贴完整订阅 URL。不要把订阅链接填进普通节点的 Host 字段，也不要把服务商登录页或介绍页当成订阅地址。

首次连接时一定会出现 VPN 授权提示吗？

首次启用系统 VPN 功能时通常会出现授权提示，但具体是否出现、提示文字和路径取决于当前 iOS、应用状态和已有系统配置。授权只完成系统层配置，不会自动导入节点，也不能证明远端连接已经可用。

为什么已经显示 VPN 图标，网页还是打不开？

VPN 图标主要说明系统 VPN 配置已启用，不代表节点、规则、DNS 和网页访问都正常。请依次确认选中节点、运行 Connectivity Test、打开实际网页，再根据现象检查规则和 DNS。

订阅导入后没有节点，应该先改 DNS 吗？

不建议。先检查是否选择 Subscribe、URL 是否完整、有没有空格或换行、当前网络能否访问订阅地址，以及返回内容是否为可读取的配置格式。导入阶段不要同时修改 DNS、规则和高级协议参数。

Global Routing 中 Config、Proxy、Direct 怎么选？

Config 按当前配置文件规则分流，Proxy 适合临时通过选定节点进行对比，Direct 用于直连对比。首次排查时只改变一个变量，测试完成后恢复原来的模式并确认当前配置文件仍然选中。

Connectivity Test 成功是不是代表所有网页都能打开？

不是。Connectivity Test 只反映特定测试方法、节点和网络条件下的结果，网页访问还可能受到 DNS、规则匹配、目标网站响应和应用自身网络行为影响。测试后应访问一个实际网页进行验证。

相关阅读

参考资料

  1. Apple App Store：Shadowrocket 产品页、开发者、应用 ID、兼容性与应用说明
  2. Shadowrocket iOS 公开参考文档：订阅导入、Global Routing、规则与 Connectivity Test（shadowrocketiphone.com）
  3. Shadowrocket 公开参考文档：订阅、服务器、路由、DNS 与测试方法（shadow-official.com）
  4. Shadowrocket 公开参考文档：App Store 核验、VPN 授权与连接排查（shadow-official.com）