官方手册 · 首次设置

Shadowrocket 使用说明

在 iPhone 或 iPad 上完成服务器导入、分流选择和连接验证。第一次设置,先用一条已有服务器跑通流程,再检查具体规则。

01 导入

在 Add Server 添加服务器或订阅

先看手里的资料是哪一类:订阅链接用于导入一组服务器,之后还可以更新订阅;单台服务器信息则对应一条记录,通常包括协议、地址、端口和认证参数。只需走其中一条路径,不必把同一条链接同时填进两个入口。

已有订阅链接:选择 Subscribe

  1. 从你的服务商处复制完整的订阅链接。不要复制成账户页面地址,也不要只截取链接开头;问号之后可能还有订阅所需的参数。
  2. 打开 Home,点 Add Server,在 Type 中选择 Subscribe。把链接粘贴到订阅地址栏,核对首尾没有多余空格;如果有备注栏,可写一个能辨认来源的名称。
  3. 保存并回到 Home。展开相应订阅分组,确认 SERVER 中出现可选的服务器。看到分组名称并不等于已取得服务器列表;首次导入后若分组仍为空,先完成订阅更新,再检查是否有条目。

已有单台服务器信息:按协议填写

从 Home 打开 Add Server,在 Type 选择资料注明的协议,再填写对应字段。Host 填服务器地址,Port 填端口;地址和端口分开,不要把整段分享链接塞进 Host。Password、Method 等字段是否出现,取决于所选协议。不要把截图中某一种协议的字段套到其他协议上。

如果你已有服务商提供的单台服务器二维码,可在 Add Server 使用 Scan QR Code。扫码后先核对 Type、Host 和 Port,再保存。二维码或分享链接也可能包含认证信息,不要将它们贴到公开讨论区。

Shadowrocket 的 Add Server 界面,显示 Type、Host、Port、Password、Method 与 Scan QR Code
Add Server:先选 Type,再填该类型要求的字段;截图展示的是单台服务器的表单。
02 分流

在 Global Routing 选择分流模式

回到 Home,点 Global Routing。这里决定接下来如何处理流量;在 SERVER 里选服务器,只是确定代理请求可使用的服务器,并不会自动把分流模式切成代理。

配置(Config)
按当前启用的配置文件逐条匹配请求。已经有需要使用的配置文件,且希望部分请求走代理、部分请求直连时,选这一项。
代理(Proxy)
让客户端接管的流量走代理,而不是按配置文件里的分流规则逐项决定。首次判断服务器是否能处理代理请求时,可以短时间用它做对照。
直连(Direct)
让客户端接管的流量直接访问目标,不经所选代理服务器。用于建立对照:如果直连也打不开同一地址,不能只凭这个结果认定代理服务器有问题。

选择 Config 前核对配置文件

底部的 Config 用于查看和管理配置文件;Global Routing 里的 Config 则表示使用配置文件来分流。先到配置文件列表确认当前启用的是预期文件,再回 Home 确认 Global Routing 显示 Config。仅打开某个文件的编辑页,不等于已启用该文件。

在配置文件中,Rule 的匹配顺序会影响结果:如果同一域名既能命中上方的宽泛规则,也能命中下方的具体规则,先命中的规则决定走向;FINAL 处理前面未命中的请求。首次连接不用编辑 Rule,先记下所用配置和模式,方便验证时对照。

Shadowrocket 的 Config 配置文件编辑界面,显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 与 Add Rule
Config:这是配置文件编辑页。选择分流模式要回到 Home 的 Global Routing。

选好模式后回到 Home,检查 Global Routing 一行显示的选项是否和刚才的选择一致。若暂时没有明确的分流目标,可以先用 Proxy 验证一条服务器,再返回 Config 验证规则。

03 连接

在 Home 打开连接开关

  1. 先选服务器。在 Home 的 SERVER 中点选一条刚导入的记录,确认选中标记落在目标条目上。若列表里有多个相似名称,核对分组和备注,避免后面的测试对着另一条记录做。
  2. 打开顶部开关。首次操作时,iPhone 或 iPad 可能弹出系统提示,要求允许 Shadowrocket 添加 VPN 配置。确认弹窗来自系统后,按提示允许;如果需要设备认证,只在系统界面完成。若之前取消过,回到 Home 再打开一次开关。
  3. 等待状态更新。顶部从 Not Connected 变为 Connected,表示本机连接已建立。若开关弹回、状态一直不变,或系统提示被管理策略限制,先按第五步检查,不必反复导入同一份资料。

Connected 描述的是本机连接状态,不代表每个请求都经过服务器,也不代表目标网页一定可访问。例如,Global Routing 选的是 Direct 时,顶部仍可显示 Connected,但请求按直连方式处理。要判断实际访问是否正常,还需要下一步的测试。

如果设备平时会自动连到其他 VPN,先核对当前系统使用的是哪一项。只有在设备归你管理、且这些连接不是工作或学校要求时,才暂停其他 VPN 做对照。不要移除不属于自己的配置。

Shadowrocket 的 Home 界面,顶部显示 Not Connected 开关,下方有 Global Routing、Connectivity Test、SERVER 和 Add Server
Home:选中 SERVER 中的记录,再打开顶部开关。Connectivity Test 位于 Global Routing 下方。
04 验证

用 Connectivity Test 和网页访问验证

把测试分成两件事:先看服务器在当前测试方式下有没有响应,再看浏览器能不能访问你关心的地址。第一项通过,不代表第二项也通过;能打开网页,也不能单凭这一点判断请求走的是代理还是直连。

  1. 记下本次测试条件。在 Home 确认顶部状态、选中的服务器和 Global Routing 模式。复测时尽量使用同一个 Wi-Fi 或蜂窝网络;换网和换服务器都可能改变结果,不要同时进行。
  2. 运行 Connectivity Test。在 Home 点 Connectivity Test,等结果更新,再看所选服务器对应的结果。如果超时,记下是仅这一条记录失败,还是其他已有记录也有同样表现。测试响应时间只反映本次测试条件,不能当作网页加载速度。
  3. 重新请求一个已知可用的地址。切到浏览器,用一个新标签页打开你平时能访问的普通网页;也可刷新页面并点开同站另一页,避免误把先前已加载的内容当成新请求成功。若出现错误,记下是找不到主机、连接超时,还是页面开始加载后中断。
  4. 需要确认分流时再做模式对照。保持网络、服务器和目标地址不变,在 Home 分别选 Proxy、Direct 并重新访问同一地址,然后回到 Config 复测。若只有 Config 的表现不同,优先核对当前配置文件和实际命中的 Rule。测试完恢复你要日常使用的模式。
05 排错

按失败阶段定位问题

先确定是没导入记录、没建立连接,还是已连接但访问异常。从最早失败的环节查起,每改一项就复测一次。重装客户端、换订阅和改配置如果一起做,即使恢复了也很难判断原因。

订阅保存了,但 SERVER 里没有服务器

先确认分组没有折叠,并且普通网页在当前网络下能打开。核对订阅地址有没有截断,或粘贴成了账号页面地址。如果是更新失败、旧列表仍在,旧条目只能说明之前导入过;先保留现有记录,确认新地址能够读取后再替换,不要一开始就删除仍可用的分组。

开关打开后仍显示 Not Connected

回到 Home 确认选中了一条服务器,并检查首次添加 VPN 配置时是否取消过系统提示。若系统有其他 VPN 正在运行,按第三步先确认当前连接。若手动断开后又自动连上,在 Settings 核对 On Demand 是否正在按条件触发;在允许调整的个人设备上,可以先关闭 On Demand,再做一次手动连接对照。

显示 Connected,但测试超时或网页打不开

先用 Direct 对照。如果直连也无法打开多个平时可用的网页,先检查当前网络是否需要登录,或设备本身是否能正常上网。如果直连正常、Proxy 失败,回到 Add Server 的对应记录核对协议、地址、端口和认证参数。服务商资料未明确要求修改的字段,先保持原值。

只有 Config 模式下某个域名表现异常

核对 Config 中启用的文件,再看 Rule 中有没有更靠前的宽泛匹配。如果报错是找不到主机,则先记录域名和发生时间,再检查当前配置的 DNS,而不是一开始就改所有 DNS 设置。涉及规则和 DNS 的细项,可转到设置手册逐项核对。

Shadowrocket 的 Settings 界面,显示 Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings:测试结果前后不一致时核对 Test Method;自动重连时检查 On Demand;定位请求时查看 Diagnostics。

如果仍需要排查,先记下失败发生在哪一步、当前网络类型、Global Routing 的选项和错误文字,再按疑难解答对应分类继续。分享截图或诊断记录前,遮住订阅链接、二维码、服务器认证参数和其他敏感信息。