官方手册 · 首次连接
Shadowrocket 入门指南
从导入已有订阅到验证规则分流,按顺序完成首次连接。
STEP 01
添加服务器或导入订阅
打开 Shadowrocket,进入底部的 Home,点右上角的加号进入 Add Server。先区分手上的资料:订阅链接用于同步一组服务器;单条服务器信息则包含协议、地址、端口及相应的认证参数。按资料类型选下面一种做法即可,不需要先导入订阅再逐条手填。
已有订阅链接:选择 Subscribe
点 Type,选择 Subscribe,把从你的服务商处获取的完整链接粘贴到 URL。链接若带有问号及后续参数,应一并保留;只复制前面的域名通常取不到订阅内容。保存后回到 Home,等订阅同步并展开对应分组查看条目。刚保存时列表还空着,可以在分组菜单中手动更新一次,再根据更新结果排查。
已有单条参数:按协议填写
在 Type 选服务商标注的协议,例如 Shadowsocks 或 Trojan。把地址填入 Host,端口填入 Port;表单出现 Password、Method 或其他字段时,按资料逐项对应。Host 不是订阅链接,也不用把端口再拼到地址后。切换 Type 会改变可填字段,不能把一种协议的参数套到另一种协议上。服务商若同时给了二维码,可在 Add Server 中使用 Scan QR Code 导入,再核对读出的协议和地址是否对应同一条服务器。
保存后回到 Home,在 SERVER 区域找到新条目,点选本次要用的服务器。列表里看得到条目,只说明资料已写入;选中条目后,才有了下一步分流规则使用代理时的连接目标。先保持顶部开关关闭,再去确认 Global Routing。
STEP 02
选择 Global Routing 模式
在 Home 点 Global Routing,按本次目的选择姿态。这里设置的是客户端如何处理请求,不会修改已选服务器,也不是连接开关。第一次准备按规则分流时,选配置(Config);需要分清问题出在规则还是线路时,再临时切换另外两档做对照。
- 配置(Config)
- 按当前启用的配置文件匹配请求。规则给出的
PROXY、DIRECT或REJECT等结果,分别决定请求使用代理、直接连接或被拒绝。 - 代理(Proxy)
- 让客户端接管的请求走代理。可临时用于确认同一地址通过当前服务器能否访问,测试完再切回平时所需的模式。
- 直连(Direct)
- 让客户端接管的请求直接连接。可作为访问同一地址时的对照;选中这一档并不等于关闭顶部开关。
选配置(Config)后,点底部的 Config 标签页,核对当前启用的文件。注意两个同名入口的区别:Global Routing 里的 Config 决定按规则处理,底部的 Config 则用于管理实际读取的配置文件。文件列表里有多份配置时,以当前启用的那份为准,不要只看文件名或最近编辑时间。
打开当前配置的详情,可在 Rule 中查看匹配条件和对应策略。规则通常按顺序检查:前面的规则已命中时,末尾的 FINAL 不会覆盖结果。首次连接不用先点 Add Rule。只需确认一个预计走 PROXY 的地址和一个预计走 DIRECT 的地址,留待第四步对照。如果尚不确定配置中有哪些规则,可以先用代理(Proxy)完成连通性测试,再回到配置(Config)检查分流。
STEP 03
在 Home 打开连接开关
回到 Home,先检查 SERVER 中选中的条目是否正确,再看 Global Routing 行显示的是不是刚才选定的模式。随后点顶部 Not Connected 旁的开关。第一次开启时,系统可能提示添加 VPN 配置;确认提示是这次从 Shadowrocket 发起的,再允许添加,并按设备提示完成验证。
返回 Home,等顶部状态从 Not Connected 变为 Connected。如果开关仍处于关闭状态,先确认刚才的系统操作是否完成,再尝试一次;不要连续点开关,否则难以分辨是系统尚在处理,还是刚打开又被手动关闭。若设备已有其他正在运行的 VPN,不要随意删除其配置。在允许的情况下先结束当前连接,再回到 Shadowrocket 重试;受组织管理的设备则应先向管理员确认限制。
Connected 表示客户端连接已启动,不表示所选服务器已经通过测试,也不表示每个网页都经过代理。尤其在配置(Config)模式下,某些请求直连本来就是预期结果。首次验收先用手动开关,暂不调整 On Demand,这样切换网络或从后台返回时,较容易分辨连接状态是否由本次操作引起。
接下来保留当前网络和当前服务器,先在应用内测试一遍,再去浏览器验证。如果刚打开开关就立刻回到 Not Connected,可直接跳到第五步的系统权限与开关排查,不必先改规则。
STEP 04
用 Connectivity Test 与网页验证
在 Home 点 Connectivity Test,等测试完成,再看本次选中服务器的结果。测试成功说明该服务器在当前网络下通过了这次探测;即使显示耗时,也不能据此判断目标网页一定能打开。测试失败时先确认测试对应的是哪条服务器,并确认设备本身的网络可用,不要根据一次超时立即重写配置。
然后打开浏览器,访问第二步从配置中选出的两个地址:先访问预期走 PROXY 的地址,再访问预期走 DIRECT 的地址。使用相同的完整地址重新加载,并留意页面有没有跳转到别的域名;跳转后发出的请求会按新域名单独匹配。网页里来自其他域名的图片、脚本也可能走不同策略,所以「网页打开了」只能说明访问结果,不能单独证明整页流量都走了代理。
结果不符预期时,把网络、服务器和测试地址固定住,每次只切换 Global Routing。若同一地址在代理(Proxy)下可访问,在配置(Config)下不可访问,优先检查当前配置、目标域名与规则顺序。若代理(Proxy)和直连(Direct)都失败,先核对网址、当前网络和目标站点状态,不能仅凭现象认定是规则错误。
STEP 05
按故障现象缩小排查范围
订阅已保存,但列表为空
先展开 Home 中的订阅分组,确认不是折叠状态。若仍为空,回到订阅条目检查 Type 是否为 Subscribe,链接开头、末尾和查询参数是否完整,再手动更新一次。若更新提示链接失效或访问被拒绝,向你的服务商核对订阅状态。不要把完整链接贴到公开场合:链接中的参数可能足以访问你的订阅。
开关刚打开就回落,或断开后又自动连接
立即回落时,先确认已完成系统的 VPN 配置授权,且没有其他 VPN 正在占用连接。若断开后又自动连接,在底部 Settings 打开 On Demand,检查当前网络是否符合已设置的触发条件。为了验证手动开关,可暂时关闭按需连接,保持同一网络重试;确认原因后,再按实际需要恢复原设置。
显示 Connected,但请求失败
若多条服务器的测试结果都异常,先对照 Settings 中的 Test Method,确认前后使用的是同一种测试方法,再回到 Home 重测。如果只有个别服务器失败,先复核其协议、地址、端口和认证参数;如果只是切到配置(Config)时失败,回去看对应域名是否命中较早的规则,或者没有命中任何前置规则而落到 FINAL。
需要继续定位时,可到 Settings 打开 Diagnostics 查看诊断信息。只记录复现所需的网络类型、选用模式、失败环节和错误提示;对外求助前遮盖服务器认证字段和订阅链接。分流关键词、授权提示及其他现象可查常见问题;商店地区、正版核对和换机恢复见正版指南。