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 分组出现了至少一条可以选择的服务器记录。能看见记录只说明资料已经写入客户端,还不能判断服务器能否连接。下一步先设定流量的处理方式,再测试连接。
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 处理未命中前置规则的请求。宽泛的条件放在前面,可能让后面更具体的规则没有机会生效。编辑前先保留原配置,方便恢复。更多规则写法见完整使用手册。
03 / Connection
在 Home 打开连接
回到 Home,先在 SERVER 分组选定要测试的一条记录,再核对 Global Routing 显示的是刚才选定的模式。订阅导入后可能出现多条名称相近的记录,首次测试先固定一条;否则切换网络或模式后,很难判断变化来自哪一项。
确认这两项后,打开 Home 顶部 Not Connected 旁的开关。首次启用时,系统可能提示添加 VPN 配置。这是系统允许 Shadowrocket 接管相应网络流量的步骤。确认提示来自刚才打开的 Shadowrocket,再按系统提示授权,完成后返回 Home,等开关状态稳定。若刚才取消了提示,可回到 Home 重新发起一次连接。
如果开关立即回到断开状态,先记录屏幕提示,不要连续点击开关。如果设备正在运行其他 VPN 配置,或是由组织管理的设备,先确认是否有连接冲突或系统策略限制。不要为了测试而移除组织下发的配置;受管理设备上的授权问题应由设备管理员确认。
Home 显示已连接,只说明客户端已启动连接所需的系统通道,不等同于某个目标网站已经走 PROXY。下一步保留当前服务器和网络,分别检查服务器测试结果与实际访问结果。
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 查找对应现象;需要保留排查记录时,记下设备类型、连接方式、模式与错误提示即可,先遮去服务器地址、认证信息、订阅链接和二维码。