Shadowrocket · 官方手册

Shadowrocket 使用教程

添加服务器或订阅,选择 Global Routing,连接后验证分流结果。

01 / Server

添加服务器或导入订阅

先判断手里的资料是哪一种。已有一组协议、地址、端口和认证信息时,手动添加服务器;服务商给的是用来同步服务器列表的订阅链接时,使用 Subscribe。能在浏览器中打开的链接不一定是订阅地址:如果打开后显示账号登录页或服务说明页,应回到自己的服务商处核对链接类型。

有服务器信息:使用 Add Server

打开 Home,在 SERVER 分组找到 Add Server。先点 Type 选择资料注明的协议,再填写界面显示的字段。Host 填服务器主机名或地址,Port 单独填写,不要把地址和端口一起贴进 Host。Password、Method 等字段是否出现取决于 Type;以手头资料为准,不要把其他协议的参数套用过来。

如果手头是单台服务器的二维码,可以用 Add Server 底部的 Scan QR Code 读取,再核对识别出来的协议、名称和地址。Import from Cloud JSON 有自己的导入用途,不用它替代 Subscribe。保存前检查复制内容的首尾是否多出空格或换行;如果服务器资料带有参数,不要擅自删掉其中一段。

有订阅链接:使用 Subscribe

在 Add Server 中打开 Type,选择 Subscribe,把完整的订阅链接填进对应的地址栏,再保存。回到 Home 等待列表更新;如果保存后暂时只看见订阅来源而没有服务器条目,先检查该订阅的更新结果。订阅地址可能包含访问凭据,不要把完整链接贴进公开留言,也不要连同地址栏或二维码一起截图分享。

这一阶段的完成标志是:Home 的 SERVER 分组出现了至少一条可以选择的服务器记录。能看见记录只说明资料已经写入客户端,还不能判断服务器能否连接。下一步先设定流量的处理方式,再测试连接。

Shadowrocket Add Server 界面,显示 Type、Host、Port、Password 和 Method 字段
在 Add Server 先选 Type,再核对该类型所需的字段。底部可找到 Scan QR Code。

02 / Routing

选择 Global Routing 模式

在 Home 找到 Global Routing,点开查看三个选项。选择模式之前,先确定这次要验证什么:日常使用通常需要验证某条规则是否生效;首次接入一台服务器时,可能只需要确认能否通过它访问目标。两种目的不必用同一种模式。

配置(Config)
按照当前配置的规则处理请求。适合让不同目标分别走 PROXY、走 DIRECT 或执行 REJECT。测试结果取决于当前启用的配置及其规则顺序。
代理(Proxy)
使用所选服务器处理流量。首次连接时可用来验证代理路径,避免把规则选择和服务器连通性混在一起。测试完毕后切回日常使用的模式。
直连(Direct)
流量不经所选代理服务器。适合在同一网络上做对照;即使页面能够打开,也不能据此判断代理服务器可用。

选择配置(Config)时,还要进入底部的 Config 页面确认启用的是哪份文件。Home 里的 Config 表示要按规则处理流量;底部的 Config 是查看和编辑配置文件的入口,两处不是同一个开关。右图展示的是文件编辑页,用来定位 Rule 和 Add Rule,不是 Global Routing 的模式选择菜单。

首次操作建议先用原有配置完成验证,不必同时新增规则、改 DNS 和更换服务器。如果发现目标没有走预期路径,再检查 Rule:通常先匹配到的适用规则决定策略,FINAL 处理未命中前置规则的请求。宽泛的条件放在前面,可能让后面更具体的规则没有机会生效。编辑前先保留原配置,方便恢复。更多规则写法见完整使用手册。

Shadowrocket Config 文件编辑界面,显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 与 Add Rule
Config 文件编辑页。要核对规则内容与顺序,从 Rule 开始。

03 / Connection

在 Home 打开连接

回到 Home,先在 SERVER 分组选定要测试的一条记录,再核对 Global Routing 显示的是刚才选定的模式。订阅导入后可能出现多条名称相近的记录,首次测试先固定一条;否则切换网络或模式后,很难判断变化来自哪一项。

确认这两项后,打开 Home 顶部 Not Connected 旁的开关。首次启用时,系统可能提示添加 VPN 配置。这是系统允许 Shadowrocket 接管相应网络流量的步骤。确认提示来自刚才打开的 Shadowrocket,再按系统提示授权,完成后返回 Home,等开关状态稳定。若刚才取消了提示,可回到 Home 重新发起一次连接。

如果开关立即回到断开状态,先记录屏幕提示,不要连续点击开关。如果设备正在运行其他 VPN 配置,或是由组织管理的设备,先确认是否有连接冲突或系统策略限制。不要为了测试而移除组织下发的配置;受管理设备上的授权问题应由设备管理员确认。

Home 显示已连接,只说明客户端已启动连接所需的系统通道,不等同于某个目标网站已经走 PROXY。下一步保留当前服务器和网络,分别检查服务器测试结果与实际访问结果。

Shadowrocket Home 界面,显示 Not Connected 开关、Global Routing、Connectivity Test 与 SERVER 分组
在 Home 先选定 SERVER 条目并核对 Global Routing,再打开顶部开关。

04 / Verification

验证连接与规则是否生效

先测服务器,再打开目标网页

保持同一个 Wi-Fi 或 Cellular 网络,在 Home 运行 Connectivity Test,观察所选服务器是否返回结果。测试失败时先记下出现的是超时还是其他提示,不要仅凭一次结果就删掉记录。测试成功也只表示当前测试方法得到响应,不代表所有网站、应用或协议都已可用。

接着在浏览器里重新加载一个平时使用、能确认是否正常的网页。不要只看连接前已经打开的标签页:缓存或之前建立的连接可能让旧页面继续可见。可以打开新标签页,主动刷新,查看页面内容是否确实重新载入。

用两个目标检查 Config 的分流

如果选的是配置(Config),从当前规则里找两个自己熟悉的目标:一个预期走 PROXY,另一个预期走 DIRECT。分别重新发起访问,并在界面有相应记录时用 Diagnostics 对照请求域名和实际策略。两个网页都打开,只能说明它们可以访问;路径是否不同,要以策略记录为准。留意输入的域名是否发生跳转,也不要把页面中的图片或其他资源请求误当成主页面请求。

想区分服务器问题和规则问题时,可以对同一个目标临时切到代理(Proxy)再测试一次,保持服务器、网络和目标不变。如果代理(Proxy)下可用、配置(Config)下失败,优先检查启用的配置文件与规则命中;如果两种模式都失败,再回查服务器资料和网络。需要确认基础网络时,可用直连(Direct)作对照。测试结束后恢复日常使用的模式。

还可以打开 Data,比较访问前后是否出现流量变化。它适合核对是否有流量经过客户端,但流量增加不能单独证明某条规则已命中。记下测试时的模式、所选服务器和结果,就能在出现故障时直接复现这组条件。

05 / Diagnostics

按失败现象逐项排查

从最早失败的一步开始查。列表里还没有可选服务器,就先处理导入;服务器已经选定、开关却打不开,就先检查系统授权。只有在连接能建立之后,才需要用网页访问和规则记录判断分流。

订阅保存了,SERVER 中没有可选记录

回到订阅条目检查地址是否完整,尤其是复制时容易漏掉的查询参数。确认链接是自己的服务商提供给客户端使用的地址,而不是登录页链接。已有配置能正常使用时,先保留它,不要删除整份配置来处理一次更新失败。如果同一订阅多次返回空内容或更新错误,记录错误提示并向自己的服务商确认地址是否仍有效。

连接打不开,或刚打开又断开

先查首次连接的 VPN 配置提示是否已处理,再确认当前网络在断开 Shadowrocket 时可以正常访问熟悉的直连站点。若 Wi-Fi 还需要登录,先按网络的要求完成登录,再回到 Home 测试。若手动断开后一段时间又自动连接,到 Settings 查看 On Demand 是否启用以及相应触发条件;自动重连和手动连接失败是两种现象,应分开判断。

显示已连接,但测试或网页访问失败

先比对 Type、Host、Port 和认证字段,再用相同入口重跑 Connectivity Test。到 Settings 查看 Test Method,记录当前测试方式;不同方式得到的结果不能直接横比。如果测试成功但仅某些域名失败,在 Diagnostics 中先区分域名解析异常与策略命中异常。出现解析错误时,核对当前配置的 DNS 设置;如果请求命中非预期策略,回到 Config 检查 Rule 和 FINAL,不要同时修改 DNS 与规则。

每次只改一项,改完用同一个目标复测。仍不能定位时,可到 FAQ 查找对应现象;需要保留排查记录时,记下设备类型、连接方式、模式与错误提示即可,先遮去服务器地址、认证信息、订阅链接和二维码。

Shadowrocket Settings 界面,显示 Test Method、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings 中的 Test Method、On Demand 和 Diagnostics 分别用于核对测试、自动连接和诊断信息。