OFFICIAL MANUAL / GETTING STARTED

Shadowrocket 使用教程:
导入、连接与验证

以 iPhone / iPad 界面为例,按五步完成第一次连接。先确认信息完整,再调整规则;每一步都保留一个可检查的结果。

Subscribe Global Routing Connectivity Test

阅读顺序:第一次设置请从头操作;已经能够连接、只有个别请求异常,可直接查看验证与排错步骤。截图用于定位界面,设备上的字段以实际显示为准。

STEP 01 / ADD SERVER

添加服务器或导入 Subscribe 订阅

订阅是一组服务器信息的更新入口;单个服务器则需要逐项填写。两种方式选择一种即可,不必把同一份信息重复添加。

已有订阅链接:选择 Subscribe

打开底部的 Home,在 SERVER 区域找到 Add Server,或点右上角添加入口,进入 Add Server。点 Type 查看类型列表,选择 Subscribe,然后将从你的服务商处获取的完整订阅链接填入 URL。名称只用于自己辨认,可以按用途填写;真正决定能否获取内容的是 URL,不是名称。

粘贴后先检查开头、结尾与中间是否有多余空格或换行。有些链接带有查询参数,这些内容也是地址的一部分,不要只复制域名,也不要删除看起来较长的尾部。保存后回到 Home,等待订阅内容载入,再展开对应分组检查是否出现服务器条目。若应用提示获取失败,先处理链接或当前网络,不要反复新建同名订阅。

已有单个服务器:按 Type 填写字段

仍从 Add Server 进入,但 Type 要选择资料中指定的协议,而不是 Subscribe。随后对应填写 Host、Port,以及该协议要求的 Password、Method 或其他认证字段。不要根据截图猜参数:不同 Type 显示的字段不同,某个字段在截图里出现,并不意味着所有协议都要填写。TLS、SNI 等附加项也应与服务商给出的信息一致。

如果已有可用的二维码,可以使用 Scan QR Code 读取后再核对;Import from Cloud JSON 只适用于已经持有对应格式资料的情况。不要把普通订阅链接随意放进不匹配的导入入口。手动录入完成后先保存,再回到 SERVER 查看条目,后续连接使用的是这里保存的服务器,而不是编辑页面尚未提交的内容。

此步的完成标志是:Home 中出现了可选择的服务器,打开条目能够看到预期的类型与地址。订阅分组名称出现但没有任何服务器,还不能进入连接验证。字段含义不清时可查术语表,获取失败的分支说明见疑难解答。

Shadowrocket Add Server 官方截图,显示 Type、Host、Port、Password、Method 及底部导入入口
Add Server:先选 Type,再填写对应字段。截图中的字段组合不作为你的服务器参数。
STEP 02 / GLOBAL ROUTING

选择 Global Routing 姿态

服务器决定连接到哪里,Global Routing 决定请求如何处理。两者是不同设置,选好服务器后仍需要检查分流姿态。

先区分配置(Config)、代理(Proxy)、直连(Direct)

回到 Home,点 Global Routing 打开选择项。配置(Config)按当前配置文件中的规则决定请求策略;代理(Proxy)用于让可接管的请求按代理路径处理,适合短时间对照测试;直连(Direct)按直连路径处理,因此顶部开关打开也不等于请求一定经过所选服务器。三种姿态不是速度档位,也不会修正填错的认证信息。

准备按规则使用时,先选择配置(Config),再打开底部 Config,确认已经选中需要的配置文件。若存在多份文件,仅导入一份新文件不代表它已经成为当前配置,需要检查实际选中状态。进入文件编辑页可以看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段;第一次连接不需要逐项修改,也不需要启用所有功能。

检查规则顺序,而不是一次改完整份配置

Rule 中的规则通常按顺序匹配,具体条件应先于兜底条件。下面只用于理解语法:example.com 及其子域名匹配 PROXY,指定局域网网段匹配 DIRECT,其余请求由 FINAL 处理。实际配置中的策略名称必须存在;只有规则文本、没有对应策略时,不能据此判断连接已准备完成。请勿为了照抄示例而替换整份现有配置。

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

如果尚不确定问题来自服务器还是规则,可以记下原姿态,临时切换代理(Proxy),完成后续连接与验证,再恢复配置(Config)做对照。代理(Proxy)能够访问而配置(Config)失败,才值得重点检查规则和策略;两者都失败时,应先回查服务器与基础网络。第一次设置期间保持修改范围小,避免同时更换订阅、配置和 DNS,导致结果难以比较。

Shadowrocket Config 官方截图,显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 分段与 Add Rule
Config 文件编辑页:本步主要确认配置已选中,并理解 Rule 的作用,不要求修改全部分段。
STEP 03 / HOME

选定默认服务器,打开连接开关

先选择实际使用的服务器,再打开开关。进入条目编辑页与选择默认服务器是两个不同动作。

在 SERVER 中确认选中项

从 Config 返回 Home,在 SERVER 分组内找到刚才导入的服务器,点该条目左侧的圆点,确认选中标记移到目标条目。若点名称后进入编辑页面,先返回列表,再检查选择状态。订阅中有多个服务器时,本次先固定一个进行验证,避免每次测试前都换一个,使错误现象失去可比性。

再次查看 Home 的 Global Routing,确认与上一步计划一致,然后打开顶部连接开关。首次使用时,系统可能询问是否允许添加 VPN 配置;阅读提示,确认操作来自 Shadowrocket 后允许,并按系统要求完成设备验证。若取消授权,服务器条目仍会保留,但连接无法依照这次操作建立。之后重试时应重新检查授权结果,而不是重新录入全部服务器。

连接状态是第一项检查,不是最终结论

返回 Home,观察顶部是否仍显示 Not Connected,或已切换到连接状态。如果开关刚打开就退回,先停止连续重试,记录提示文字,并查看系统是否存在其他正在运行的 VPN 连接。首次排错期间保留一个连接来源,避免两个配置互相接管。不要通过删除不认识的系统配置来试错,受管理设备还可能存在管理员限制。

开关保持开启只说明客户端已进入连接工作状态,不能单凭这个状态判断远端认证、域名解析和实际目标访问全部成功。此时不要立即启用 On Demand,也不要把自动触发失败当作服务器失败。先保持手动连接,按下一步运行测试并访问目标应用;只有手动链路得到验证后,再考虑自动连接条件。

需要停止时,回到 Home 关闭顶部开关,确认状态恢复。日后切换服务器或修改关键参数,建议先断开、保存更改,再重新连接并复测。这样更容易确认新设置何时开始使用,也能避免把已有连接的结果误认为新参数的结果。

Shadowrocket Home 官方截图,显示顶部 Not Connected 开关、Global Routing、Connectivity Test 以及 SERVER 与 Add Server
Home:依次检查 SERVER 选中项、Global Routing 和顶部连接状态,再运行 Connectivity Test。
STEP 04 / CONNECTIVITY TEST

验证是否生效:测试与实际请求

按“客户端状态 → 测试请求 → 目标应用”的顺序检查,避免把单次测试结果扩大为整条链路的结论。

运行 Connectivity Test

保持刚才选定的服务器和连接状态,在 Home 点 Connectivity Test,等待本次测试完成。先看是否出现明确的成功或失败结果,不必比较不同服务器的数值。测试会受方法、目标与当前网络影响;测试请求成功,说明本次测试所经过的路径可用,不代表每个应用、每个域名都会采用相同路径。

如果测试失败,先看当前是否处于直连(Direct),以及选中的服务器是否与预期一致。必要时到 Settings 查看 Test Method,记录现有选择后再比较。不要仅为取得一个成功结果不断切换方法;更重要的是把当前方法、网络和实际访问结果对应起来。

产生一次新的实际请求

打开需要使用的应用或页面,主动刷新或发起新请求。已经打开的页面、缓存内容和既有连接都不适合用来证明新设置生效。回到 Shadowrocket,在 Data 中查看与本次操作时间对应的记录;若有规则与策略信息,核对目标请求实际命中了什么,而不是只看开关是否亮起。

“测试通过但目标应用失败”和“测试、目标应用都失败”是两类问题。前者优先检查目标请求的规则、DNS 与应用行为;后者先检查服务器、认证和当前网络。页面能打开也不能单独证明它经过代理,因为配置(Config)可能按规则将该目标交给 DIRECT。

STEP 05 / SETTINGS & DIAGNOSTICS

按失败环节排查,一次只改一项

先分清导入失败、连接失败和请求失败。它们发生在不同阶段,不需要采用同一种处理方式。

先确认基础网络,再检查导入结果

关闭连接后,先确认设备自身能正常访问原本可用的网络资源。若基础网络就不可用,优先处理 Wi-Fi 登录、蜂窝数据权限或网络断开。订阅无法获取时,核对 URL 是否完整,以及服务商处的订阅是否仍有效;不要把订阅链接作为搜索关键词提交,也不要公开发送给他人。导入阶段尚未得到服务器列表时,切换 Global Routing 通常不能解决获取问题。

开关退回与连接后超时分别处理

开关立即退回时,重点检查系统 VPN 授权、其他 VPN 的连接状态,以及是否存在设备管理限制。开关保持开启但请求超时,则核对当前服务器的 Host、Port、Type 和认证字段,特别留意复制粘贴带入的空格。若服务商提供多种接入资料,不要把一组资料的地址与另一组资料的认证字段拼在一起。保存修正后重新连接,再按同样的测试方法验证。

只有部分请求异常:回查 Config

如果代理(Proxy)下可用、配置(Config)下不可用,回到 Config 检查实际选中的文件,再查看失败请求命中的规则与策略。留意过宽的 DOMAIN-KEYWORD、提前出现的兜底规则,以及策略引用是否指向预期服务器。先保留原配置副本,修改一项后重新发起请求;不要为解决单个目标,把所有请求长期固定成另一种姿态。

保持手动连接,再使用 Diagnostics

在 Settings 中检查 On Demand。首次排错先关闭自动触发,保持手动连接,避免 Wi-Fi 或网络切换导致状态变化被误判为随机断线。手动连接稳定后,再单独设置 On Demand 并验证每个触发条件。Test Method 用于理解测试结果,Diagnostics 用于收集诊断线索;Proxy、TCP、UDP 等设置不应在没有明确原因时成组改动。

需要继续排查时,记录错误原文、出错步骤、网络类型、Global Routing 姿态,以及是否每个服务器都出现同样现象。分享 Diagnostics 或 Data 信息前,先隐藏订阅链接、认证内容及不必要的访问记录。常见现象的进一步分支见疑难解答;界面词与规则关键字见术语表。若问题停留在 App Store 可见性、购买或已购恢复环节,阅读正版指南,不必重新调整连接参数。

Shadowrocket Settings 官方截图,显示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 与 UDP
Settings:排错时重点记录 Test Method、On Demand 与 Diagnostics,暂不批量更改其他选项。