QUICKSTART / iPhone · iPad

Shadowrocket 使用教程

先导入已有配置,再选定流量处理方式。打开连接后,用一次测试和一次实际访问核对结果。

01 / IMPORT

添加服务器或导入已有订阅

打开 Shadowrocket,在 Home 找到 SERVER 分组,点 Add Server。接下来要看你手里是哪一种资料:如果拿到的是协议、主机和端口等参数,就添加单台服务器;如果拿到的是用于更新一组条目的完整订阅地址,就用 Subscribe。只完成其中一条路径即可。

手动添加:先选 Type,再填字段

在 Add Server 先点 Type,选与你已有资料一致的协议。选定后再填 Host 和 Port;若界面出现 Password、Method 等字段,也应逐项照原资料填写。Host 和 Port 是两个字段,不要把带路径的完整链接填进 Host。不同协议显示的字段不完全相同,截图中的字段不是所有协议的必填清单。遇到未提供的必填值,先向配置提供方确认,不要靠猜测凑齐。

订阅导入:保留完整链接

持有订阅链接时,在 Add Server 的 Type 中选 Subscribe,把完整地址粘贴到出现的链接字段,再保存。地址末尾的查询参数可能用于访问授权,不要删掉;复制后检查首尾是否带入了换行或空格。返回 Home 后,确认订阅分组下确实出现了服务器条目。只有分组名称、没有可选条目时,先检查订阅更新结果,不要继续打开连接开关试错。

导入完成后,在 Home 点选一条你认识的服务器,核对选中标记。多个条目名称相似时,用备注区分,避免把新导入的条目和旧条目混在一起。此时只确认资料已保存、服务器已选中,还不能据此判断连接可用。下一步设置 Global Routing,决定哪些访问会使用这条服务器。

Shadowrocket 的 Add Server 页面,显示协议类型、主机、端口及认证字段
Add Server:先选 Type,再填写该协议所需的参数。

02 / ROUTING

选择 Global Routing 姿态

回到 Home,点开 Global Routing。选中的服务器决定需要代理时用哪条连接;Global Routing 则决定流量是否使用它。首次设置时,先选一个能对应测试目的的姿态,再保持其他条件不变。

配置(Config)
按当前启用的配置文件匹配规则。命中 DIRECT 的目标走直连,命中代理策略的目标走相应代理;没有命中前序规则时,再看配置中的 FINAL。适合已经有分流配置、需要分别验证不同目标的情况。
代理(Proxy)
让由客户端处理的流量按代理方式转发。首次排查时可短暂使用它来判断所选服务器能否处理测试访问,不必同时修改规则。测试完成后,恢复你实际需要的姿态。
直连(Direct)
由客户端处理的流量按直连方式访问,不经所选代理服务器。可以用它比较同一个目标在直连时的表现。它不是关闭连接开关;需要确认设备完全不经本次连接时,回到 Home 关闭顶部开关。

如果选择配置(Config),再进入底部的 Config,先确认当前启用的是哪份配置。这里的 Config 是配置管理入口,与 Global Routing 中同名的姿态不是同一个控件。打开配置的编辑页后,在 Rule 查看目标可能命中的规则。规则顺序会影响结果:前面已经命中时,不会因为后面有一条看起来更具体的规则就改用后者。

首次验证不必点击 Add Rule,也不必修改其他分段。先记下配置名称以及测试目标预期使用的策略,再回到 Home 核对 Global Routing 的选中值。规则类型、匹配范围和策略词可在术语表中进一步核对。

Shadowrocket 的 Config 编辑页面,显示 General、Rule、Hosts 等分段
Config:查看配置文件中的 Rule;姿态仍在 Home 的 Global Routing 选择。

03 / CONNECT

在 Home 打开连接开关

在 Home 先确认两项:SERVER 中选中的是刚才核对的服务器,Global Routing 显示的是本轮打算使用的姿态。然后点顶部 Not Connected 旁的开关,不要把下方的 Connectivity Test 当成连接按钮。

首次连接时,系统可能要求允许添加 VPN 配置。确认提示由刚才在 Shadowrocket 中打开开关的操作触发,再按系统提示完成授权;系统可能要求设备验证。授权结束后回到 Home,确认开关保持开启,并查看顶部连接状态是否已经离开 Not Connected。如果刚打开就回落,先记下提示,不要连续点击开关。受组织管理的设备若限制 VPN 配置,应由设备管理员确认允许的使用方式。

顶部状态改变说明连接已启动,但并不证明远端服务器可达,也不证明某个应用的访问一定走代理。例如,配置(Config)下的测试目标可能命中 DIRECT。第一次验证时,建议暂时保持当前网络、服务器和姿态不变,这样下一步的测试结果才容易解释。

Shadowrocket 的 Home 页面,顶部为连接开关,下方可见 Global Routing、Connectivity Test 和 SERVER
Home:上方开关控制连接,Connectivity Test 用于测试。

04 / VERIFY

验证测试结果与实际访问

先在 Home 点 Connectivity Test,等结果出来再切换到其他应用。记录测试时使用的网络、选中的服务器以及显示的结果。测试只反映当时的网络条件和当前测试方式;成功不等于所有目标都可访问,超时也不宜直接解释为订阅失效。若两次运行的测试方式不同,不要直接比较显示的耗时。

接着用浏览器或常用应用打开一个你已知可用、且适合当前姿态的目标,确认页面能重新加载或应用能完成实际请求。不要只看之前已打开的标签页:页面可能来自缓存。配置(Config)下,分别选一个你预期命中 DIRECT 的目标和一个预期走代理的目标,逐一核对;直连目标能打开,本身不能验证代理。代理(Proxy)下先验证一个目标即可,避免一次并行测试多个应用而难以判断失败来自哪里。

如果需要对照,先记下开启连接时的结果,再关闭 Home 顶部开关,用同一网络重新请求同一目标,最后恢复原设置。仅凭某个页面能打开,无法判断命中的是哪条规则;如果实际访问与预期不符,应返回 Config 检查规则顺序和兜底策略。测试和日常访问都符合预期,就可以保留当前设置,不必为了追求更短的测试耗时反复改动配置。

05 / TROUBLESHOOT

按失败阶段排查

先把问题分到导入、启动、测试或实际访问中的一类。每轮只改一个条件,然后重复同一操作。若 Wi‑Fi 和蜂窝网络都可用,可以保留原设置换网络对照一次;切换后不要同时换服务器,否则无法判断是哪项变化起了作用。

导入后为空,或订阅更新失败

回到 Add Server,核对是否选了 Subscribe,地址是否完整,终端当前网络能否访问日常站点。出现认证提示、链接过期,或更新后只剩空分组时,向提供链接的一方确认地址是否仍有效、返回内容是否适用于 Shadowrocket。旧条目仍能使用时,先保留旧配置,不要把删除重加当成第一步。

开关无法保持开启,或自动重新连接

开关立刻回落时,先看是否有未完成的系统 VPN 配置确认,再查看设备是否已有其他 VPN 正在运行或受管理策略约束。若手动关闭后却自动重新连接,打开 Settings 核对 On Demand 是否设置了与当前网络匹配的条件。若这是你自行设置的条件,可记录原值后暂时停用以验证手动连接,测试后按需恢复。

已连接,但 Connectivity Test 超时

先关闭连接,用普通访问确认设备网络可用,再回到 Home 核对是否选中了预期条目。手动添加的服务器应重新核对 Type、Host、Port 和认证字段;订阅导入的条目则先确认是否需要更新。随后到 Settings 查看 Test Method,记录当前方式,回到原网络复测一次。若实际访问正常、只有测试失败,不要仅凭一次超时就重建所有配置。

只有个别目标或应用异常

如果代理(Proxy)下目标可用而配置(Config)下不符合预期,优先检查当前配置、前序规则与 FINAL,不要先换服务器。若两种姿态均失败,而关闭连接后其他目标正常,可以在 Settings 查看 Diagnostics 中可用的信息,记录失败时间和提示,再联系配置提供方。一次只提交与问题相关的信息,公开前遮盖订阅地址和认证字段。

Shadowrocket 的 Settings 页面,可见 Test Method、On Demand 和 Diagnostics 等设置入口
Settings:按症状查看 Test Method、On Demand 或 Diagnostics。
免费下载 Shadowrocket