官方手册 · 入门指南
Shadowrocket
订阅导入与连接教程
先把已有服务器保存到 Home,再选择 Global Routing,最后打开连接并验证实际请求。本页以完成一次可重复检查的连接为目标,不要求先掌握整份配置文件。
已完成的步骤可以跳过;遇到问题时,回到最后一个确认正常的步骤继续检查。不同系统版本的入口位置可能略有差异,以当前界面英文名称识别功能。
STEP 01 · Home / Add Server / Subscribe
添加服务器或导入已有订阅
打开 Shadowrocket 后先停留在 Home。这里用于查看已保存的服务器、选择当前连接目标以及打开连接开关。此时先不要连接:如果列表还没有条目,应先完成导入;如果已经有条目,也要确认它来自自己的有效订阅,而不是仅凭名称选择。订阅是一组服务器信息的获取地址,单个服务器则是一条具体连接记录,两者的填写方式不同。
已有订阅链接:使用 Subscribe
在 Home 点右上角的添加按钮,进入 Add Server,打开 Type 并选择 Subscribe。将完整订阅链接粘贴到 URL,按需填写便于辨认的备注,再点右上角的保存按钮。粘贴时检查链接前后是否带入空格、换行或聊天文字;不要只复制域名,也不要删掉问号之后的参数。参数通常属于订阅身份信息,缺少其中一部分就可能无法获取内容。
保存后返回 Home,等待订阅内容加载。正常情况下会出现对应的订阅分组及服务器条目。点选其中一条,确认选择标记落在预期的服务器上。订阅名称出现但内部没有服务器,不代表已经导入完成,应先检查获取结果。需要刷新时使用该订阅条目的更新操作;具体入口可能出现在条目操作菜单中,更新后再看列表是否发生变化。
不要为了刷新而反复新建同一个订阅。重复分组会让后续选择与排查混在一起,也可能让你误用旧条目。更新会重新读取服务商返回的数据,手动改过的订阅内条目可能被新的内容覆盖。若确实需要保留独立修改,先确认保存方式,再进行更新。
已有单个服务器信息:按 Type 填写
如果拿到的是单个服务器参数,仍从 Add Server 开始,但 Type 应选择服务商给出的协议,而不是 Subscribe。依次填写服务器地址、端口、认证信息以及该协议要求的其他字段。例如需要 UUID、TLS 或 Server Name 时,应逐项对照原始资料;不能把不同协议的字段互相套用,也不要凭地址外观推断协议。
保存后回到 Home,选中刚添加的条目。若使用已有二维码,也可通过 Scan QR Code 导入,但仍需检查识别后的 Type 与地址。订阅 URL、二维码与认证字段都可能包含访问凭据,不应公开截图或转发。完成这一步后,你应能明确指出“接下来要连接的是哪一条服务器”,然后再进入路由选择。
STEP 02 · Global Routing / Config
选择 Global Routing 姿态
服务器决定代理连接使用哪个目标,Global Routing 决定请求如何处理。在 Home 点开 Global Routing,先识别配置(Config)、代理(Proxy)、直连(Direct)三种姿态。本教程使用这三种模式完成基础检查;如果界面还显示其他选项,先保持当前任务范围,不必同时配置所有功能。
配置(Config):按当前规则处理
已有适用配置文件时,日常使用可选择配置(Config)。然后进入 Config,确认真正启用的是预期文件,而不只是文件已经出现在列表里。订阅导入与 Config 不是同一件事:订阅主要更新服务器资料,Config 则控制规则、DNS 等行为。导入订阅成功,不等于已经获得适合自己需求的分流规则。
规则通常按顺序匹配,先命中的规则决定请求使用的策略。例如下面的片段表示示例域名走 PROXY,其余由 FINAL 兜底。它只用于解释匹配关系,不是一份可直接替换现有文件的完整配置;其中的 PROXY 也必须在实际配置中具有有效的策略含义。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
代理(Proxy):检查所选代理链路
还没有合适的 Config,或者正在判断问题是否来自规则时,可以暂时选代理(Proxy),用来测试经所选服务器处理的请求。它不是“自动修复”选项,也不会替你补齐错误的认证参数。系统自身流量与受系统限制的请求仍可能存在例外,不应把该模式理解成对设备每一个数据包的绝对承诺。
直连(Direct):建立本地网络对照
直连(Direct)让请求使用直连路径,可用于判断当前 Wi-Fi 或蜂窝网络本身是否正常。它不用于验证代理服务器。若 Direct 可以访问某个页面而 Proxy 不行,才有理由继续检查代理链路;若两种方式都不行,还需要考虑目标站点、本地网络或 DNS,而不是立即重建全部配置。
先记下本次选择的姿态。首次排查时不要一边改规则、一边换服务器、一边切换模式,否则无法判断是哪项调整产生了效果。规则结构与设置含义可继续阅读设置参考;眼下只需确定当前服务器与路由姿态,随后打开连接。
STEP 03 · Home / VPN
打开开关并确认系统连接状态
回到 Home,再检查一次服务器选择标记和 Global Routing。确认无误后,打开顶部连接开关。首次启动时,iPhone 或 iPad 会显示添加 VPN 配置的系统提示。阅读提示,确认这是刚才由 Shadowrocket 发起的操作后允许添加,并按系统要求完成设备认证。这是建立系统网络隧道所需的授权,不是导入订阅的步骤。
如果之前取消了授权,先返回应用重新发起连接,不要通过重复添加订阅来解决。系统授权尚未完成时,即使 Home 已经列出多条服务器,也不能据此认定连接已建立。完成提示后返回 Shadowrocket,查看开关是否保持开启、连接状态是否已更新;必要时在系统设置中查看 VPN 状态,两边应当能够对应。
遇到开关刚打开就关闭的情况,先观察应用或系统是否给出错误说明。检查是否有另一个 VPN 连接正在占用系统通道,必要时先停用另一个连接,再回到 Shadowrocket 重试。不要在没有记录现状的情况下直接删除系统配置;删除可能导致下次连接需要重新授权,也会增加判断问题的变量。
如果连接总是在手动关闭后重新出现,应检查是否启用了 On Demand,或是否存在其他系统自动连接条件。入门阶段可先记录这些设置,暂时停用相关自动连接条件,再进行一次手动连接测试。这样可以把“应用主动连接”和“系统按条件重新连接”区分开,避免误以为开关没有响应。
开关保持开启,只能说明连接流程进入了工作状态,不能保证所选服务器、域名解析与规则都符合预期。接下来不要立即连续切换多条服务器,先用同一条服务器完成下面的测试,把连接状态与实际访问结果分别记录下来。
STEP 04 · Connectivity Test
分开验证服务器、访问结果与规则
连接后先运行 Connectivity Test,查看所选服务器的测试结果。测试入口可能位于 Home 的工具或操作菜单中;如果当前界面可以选择测试方式,应在比较不同服务器时保持同一种方式。测试成功表示该测试条件下收到了预期响应,不代表每个网站、每种协议或每个应用都已经验证通过。
如果测试结果只反映网络探测响应,也不能直接据此确认认证与完整代理访问一定正常。测试方式不同,检查的链路范围也可能不同。因此下一步需要打开浏览器,访问一个你确认可用、且符合当前路由预期的页面。主动刷新或重新发起请求,避免把之前已加载的页面或缓存内容当成此次连接的结果。
验证配置(Config)时,要区分“能打开”与“按规则走”。一个页面能够打开,可能是因为它命中了 DIRECT,而不是走了 PROXY。进入应用提供的请求记录或 Log,找到刚才访问的域名,查看匹配规则与最终策略。若记录里没有对应请求,先确认时间、域名及当前连接是否一致,不要仅靠页面打开速度推断路径。
验证代理(Proxy)时,保持同一个目标页面与同一条服务器,比较连接前后的实际访问结果;验证直连(Direct)时,则用于确认基础网络。不同模式承担不同的检查任务,不需要追求所有模式都给出相同结果。尤其不要仅以状态栏 VPN 标识作为结论:系统标识说明隧道状态,不直接说明每个请求最终采用的策略。
最后做一次日常使用复查:如果刚才为了排错暂时改成了 Proxy,现在恢复计划使用的 Config,再重新发起目标请求并查看记录。可以记下当前配置文件名称、服务器名称、Global Routing 选择和测试现象,但不要把认证信息写入公开记录。只有恢复日常模式后仍符合预期,这次入门操作才算完成。
STEP 05 · 按失败阶段定位
常见失败点与下一步检查
先描述失败发生在哪一步,再决定改什么。建议记录“订阅能否更新、服务器能否测试、连接开关能否保持、目标请求是否成功”四项结果。每次只改一项,复测同一个目标;恢复正常后再撤销为了诊断而做的临时调整。这样比反复卸载重装更容易保留有效信息。
订阅没有内容或更新失败
先回到订阅编辑处核对 URL 是否完整,Type 是否为 Subscribe,链接是否仍在有效期内。如果返回的是登录页、提示文字或空内容,客户端无法把它当作服务器列表使用。此时应向自己的服务商确认订阅地址与返回格式,不要自行猜测参数。订阅获取发生在连接之前,不能把“更新失败”直接等同于“全部服务器不可用”。
已有服务器列表但本次更新失败时,先保留现有分组,确认旧条目是否仍能工作,再判断是订阅获取问题还是服务器连接问题。不要公开完整订阅地址寻求排查;描述错误现象、发生阶段与已做检查通常更有帮助。订阅含有访问凭据时,应按凭据的敏感程度处理。
服务器测试失败或连接后无法访问
逐项核对地址、端口、协议与认证字段;开启 TLS 的条目还需要检查相应名称与服务端要求是否一致。不要只改端口碰运气。若资料原本由订阅生成,优先检查订阅是否更新正确,再向服务商确认服务器状态。切换 Wi-Fi 与蜂窝网络可以作为对照,但每次切换后要重新发起测试,而不是沿用旧结果。
如果所有目标在 Direct 下也失败,先处理本地网络,例如是否需要完成 Wi-Fi 登录或网络是否已连通。若开关无法保持开启,先检查系统 VPN 授权与连接冲突;若开关正常但请求失败,再看服务器、解析与策略。把这些阶段分开,能避免在系统授权问题上浪费时间修改规则。
只有部分页面或应用失败
先用同一目标比较 Config 与临时 Proxy 的结果。若 Proxy 正常而 Config 异常,重点查看实际命中的规则、策略指向与规则顺序;若域名失败但其他请求正常,再检查 DNS 的记录与配置。不要仅凭一个现象就把所有 DNS 参数一起替换,也不要在没有备份时覆盖整个 Config。
涉及 DNS、On Demand、Log 或配置恢复的深入操作,请转到设置参考逐项阅读。更多按现象组织的说明见常见问题。提交排查信息前,隐藏订阅 URL、密码、UUID 等敏感字段,保留界面词、错误文本和操作顺序即可。
完成后保留可用的服务器选择与 Config,后续一次只调整一项设置。需要更新订阅时更新原分组,需要修改规则时先保存现有配置;每次变更后复用“连接状态 → Connectivity Test → 实际请求 → 命中策略”这条检查顺序。