官方手册 · 首次设置
Shadowrocket 使用教程
添加已有订阅或服务器,选择 Global Routing,打开连接,再用 Connectivity Test 和实际访问结果核对。
第 1 步 · 准备服务器条目
Add Server:添加服务器或导入订阅
在 Home 找到 Add Server,先判断手里的资料是哪一种。如果服务商给了协议类型、地址、端口和凭据,就手动添加单台服务器;如果给的是用于取得一组服务器的订阅链接,就选择 Subscribe。同一份资料只走一种路径。订阅链接通常以网址形式提供,但它不是服务器地址,不能直接填入 Host 当成一台服务器。
填写单台服务器
进入 Add Server 后,先用 Type 选中服务商注明的协议,再填写出现的字段。Host 填提供的主机名或 IP 地址,Port 填对应端口。截图中可见的 Password 和 Method 是这类表单的字段示例;切换 Type 后,必填项会随协议改变。不要照抄截图里的字段组合,也不要靠轮换协议来补全缺失资料。
保存之前,从上到下对照原始资料一次。复制地址时,检查首尾有没有空格或换行;端口按资料单独填写。若手里是服务商提供的二维码,可在同页找 Scan QR Code,识别后仍需核对导入类型与服务器地址。Import from Cloud JSON 对应 JSON 导入,不是普通订阅链接的入口。
导入一组服务器
在 Add Server 的 Type 中选择 Subscribe,粘贴服务商提供的完整订阅链接后保存。复制时不要漏掉链接末尾的参数,也不要把说明文字一并粘进去。订阅地址可能带有访问凭据,记录问题时只保留报错文字与发生时间,不公开原链接或包含链接的截图。
进入下一步前:回到 Home,确认 SERVER 中出现了刚保存的条目,或展开订阅分组后能看到实际服务器。分组名称出现不等于已经取得服务器列表;如果只有空分组,先跳到常见失败点,不要带着空列表继续测试连接。
第 2 步 · 确定请求去向
Global Routing:选择配置、代理或直连
在 Home 点开 Global Routing。这里决定连接开启后,客户端如何处理流量;它与在 SERVER 里选中哪台服务器是两项独立设置。把服务器设为当前条目,并不会自动把 Global Routing 改成 Proxy。先选定要验证的模式,再用下一步的开关启动连接。
按本次验证的目的选模式
- 配置(Config)
- 按当前生效的配置文件处理请求。遇到域名或网段匹配时,用规则指定的策略;前面的规则都未匹配时,查看
FINAL指定的去向。已知配置内容、要验证日常分流时选这一项。 - 代理(Proxy)
- 让客户端接管的流量走当前选中的代理服务器,而不是逐条按 Config 中的规则分流。首次排查时可以短暂使用它,把“服务器能否处理访问”与“目标是否匹配了预期规则”分开检查。
- 直连(Direct)
- 让客户端接管的流量直接访问目标,不经过所选代理服务器。它不是把顶部连接开关关掉;用它做对照时,开关仍可保持开启。
选 Config 时,核对正在使用的文件
如果选了 Config,再进入底部的 Config 页确认当前启用的是哪份文件。点开对应文件查看 Rule,先找到与目标有关的条件和策略,再看这些规则的排列顺序与末尾的 FINAL。例如一条指向 DIRECT 的匹配规则,可以解释为什么连接已开启而该请求仍然直连。
进入下一步前:回到 Home 核对 Global Routing 旁显示的模式。首次验证不必同时修改规则与服务器;先记录当前模式,等拿到验证结果,再决定是否需要调整。规则关键字的含义见术语手册。
第 3 步 · 启动连接
Home:选中服务器并打开连接
确认圆点指向要测试的服务器
回到 Home,在 SERVER 中找到本次要用的服务器,点选条目并确认圆点标记移到了这一行。如果导入的是一组名称相近的条目,先对照备注或地址,避免点到上一次使用的条目。只展开分组或进到详情页,并不等同于选中服务器。选好后保留当前 Global Routing,这样下次测试还可以用同一模式对照。
处理首次出现的系统确认
Home 顶部出现 Not Connected 时,点同一行的开关。首次开启可能会收到系统添加 VPN 配置的提示;确认是刚才从 Shadowrocket 发起的操作后再允许,并按系统提示完成验证。若此前已添加过相应配置,本次可能不会重复提示。若不小心取消了确认,回到 Home 重新发起,不需要再导入一份同样的订阅。
系统确认结束后回到 Home,等状态稳定,确认开关保持开启。如果开关很快跳回关闭,先不要连续开关或切换多个服务器。把系统提示与开关变化记下来,按排错一节处理。开关开启说明本地连接已启动,并不能单独证明选中服务器可用,也不能说明某个目标已经按预期分流。
第 4 步 · 比对两项结果
Connectivity Test:结合实际访问验证
连接开启以后,在 Home 使用 Connectivity Test,等结果返回。把结果与同一时刻的服务器、Global Routing 和网络环境对上,例如记录当时用的是 Wi-Fi 还是蜂窝网络。测试反映的是当时所用测试方式下的可达情况,不代表所有应用、域名或请求都会有相同结果。看到单次测试失败,也不必立刻重装或清空配置。
接着在浏览器访问一个平时可用、确实需要验证的页面。尽量打开需要重新加载的内容,不要只看已经显示的旧标签页;缓存内容可能在没有发出新请求时仍然可见。验证 Config 时,可各选一个预期走 DIRECT 和一个预期走 PROXY 的目标,分开记录是否能访问。页面能打开只说明访问成功,不能只凭这一点判断它经过了哪种策略。
如果测试正常、只有某个目标打不开,先保持服务器不变,核对该目标与 Rule 的匹配;网页加载还可能涉及主地址之外的资源域名,不要只看地址栏里的主域名。若需要做对照,临时切换一次 Proxy,用同一网络再打开同一页面。如果 Proxy 下可以访问而 Config 下不行,优先检查规则顺序和兜底策略。对照结束后恢复日常所用的模式,并回到 Home 确认显示已恢复。
第 5 步 · 从异常出现的位置回查
Settings:按失败位置排查
先用 Home 判断故障出现在哪一层:列表为空、开关无法保持、测试失败,还是只有目标页面异常。不要同时改协议、换服务器和改规则。下列情况按发生顺序排,前一层未通过时,不必先动后一层的设置。
订阅分组存在,但没有服务器
先确认保存时选择了 Subscribe,再对照自己的原始订阅信息核对链接是否完整,尤其是查询参数。如果订阅分组有更新操作,确认网络正常后手动更新一次,再返回 SERVER 看有没有实际条目。仍是空列表时,可向提供这份订阅的服务商确认链接状态和返回内容;反复添加同一链接只会增加待核对的分组。
开关关闭后又自动打开,或无法保持开启
如果开关打不开,先回查系统是否允许添加 VPN 配置,并确认是否有另一条 VPN 连接正在占用;受管理的设备请遵循设备管理要求。若问题是手动关闭后又自动连接,进入 Settings 查看 On Demand 是否启用以及当前网络是否满足其条件。记下原设置,再按需要做一次对照,避免把自动触发误当成开关失灵。
开关保持开启,但测试失败
确认设备基础网络可用,再回到 Home 核对圆点所指的条目。如果是手动添加,逐项对照 Type、Host、Port 与协议所需字段;不要用猜测的端口覆盖原设置。若调整过 Settings 的 Test Method,先记录当前选项。不同测试方式的结果不宜直接比较;复测时保持方式一致。
测试成功,但日常访问和预期不一致
先检查当前是否仍在用于对照的 Proxy 或 Direct,再确认 Config 下激活的是预期文件。只有一部分目标异常时,优先检查这些目标的规则条件、顺序与最终策略,不必先更改 TCP、UDP 或其他设置。需要进一步定位时,可查看 Diagnostics;转述结果前遮盖订阅地址、服务器凭据及不必要的访问记录。
下一步:照验证步骤复测一次。如果已确定在哪一层失败,查阅 FAQ 对照具体症状;需要解释协议字段或比较协议类型时,转到技术参考。