官方手册 · 入门操作

Shadowrocket 使用教程

以 iPhone / iPad 界面为例,依次完成导入、分流选择、连接与验证。首次使用先走完手动连接流程,再调整自动化设置。

下面的顺序把“资料是否导入成功”“服务器是否能连接”和“请求是否按规则处理”分开检查。不要一开始就同时修改 DNS、规则与 On Demand,否则即使恢复正常,也很难判断是哪一项起了作用。界面中的协议类型和参数以自己的实际资料为准;不同类型出现的字段不同,不必为了与示例一致而强行填写。

01 · Add Server:添加服务器或导入订阅

打开 Shadowrocket,进入 Home。先判断手中的资料是“订阅链接”,还是“单个服务器参数”:前者通常用于取得并更新一组服务器,后者则是一套明确的地址、端口、协议与认证信息。两者的录入方式不同;不要把订阅链接当成服务器地址填写,也不要把单个服务器分享内容直接当成订阅更新地址。

已有订阅链接:选择 Subscribe

在 Home 点右上角的添加按钮进入 Add Server,打开 Type 并选择 Subscribe。在 URL 中粘贴自己的完整订阅链接,必要时填写便于辨认的备注,然后保存。粘贴前后检查链接是否被聊天软件截断、首尾是否多出空格,以及查询参数是否完整。订阅链接可能包含访问凭据,不应发到公开评论区,也不要放进可公开访问的笔记。

保存后返回 Home,等待订阅内容读取完成,查看订阅分组下是否出现服务器条目。如果只看到分组名称而没有条目,先检查是否仍在加载,再对该订阅执行更新。更新报错时应保留错误提示,确认设备当前网络能访问订阅地址;反复删除并重新添加同一个链接,通常不能解决链接失效或返回内容无法解析的问题。

已有单个服务器信息:按实际 Type 填写

如果拿到的是手动参数,在 Add Server 中选择与资料一致的 Type,再逐项填写 Address、Port 以及该协议要求的认证字段。Shadowsocks、VMess、VLESS、Trojan 等协议所需参数并不相同,不能仅凭端口或名称猜测。涉及 TLS、服务器名称或传输参数时,也应保持与原始资料一致;Address 与 TLS 使用的名称不一定是同一个值。

保存后回到 Home,点选准备使用的服务器,确认选中标记落在目标条目上。导入成功只表示客户端已读取资料,并不表示远端服务一定可用。此时暂不调整复杂参数,继续下一步选择 Global Routing。若不清楚某个协议字段的含义,可查阅协议参考,不要通过更换协议类型来试错。

02 · Global Routing:选择处理姿态

在 Home 打开 Global Routing。这里决定连接采用怎样的处理方式,不负责替换服务器的地址和密码。三种姿态写作配置(Config)、代理(Proxy)、直连(Direct)。先理解它们的用途,再选择与当前测试目标相符的一项,避免把“已打开连接开关”等同于“所有请求都经过代理”。

配置(Config):按当前配置中的规则处理

日常使用已有分流配置时选择配置(Config)。随后进入 Config,确认正在使用的是预期文件,而不是仅仅把文件添加到了列表。配置中具体规则通常从上至下匹配,命中后采用对应策略;如果规则把目标交给 DIRECT,该目标直接访问是预期结果。规则写有 PROXY 时,还要确认相应策略的服务器选择正确。

下面只是规则顺序示例,不是要求立即替换当前配置。第一条把示例域名交给 PROXY,第二条把指定私有地址段交给 DIRECT,FINAL 则处理前面未命中的请求。示例不代表所有业务都适合这一安排,首次上手应优先理解自己正在使用的文件。

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

代理(Proxy)与直连(Direct):用于明确用途或对照

代理(Proxy)将进入客户端处理范围的请求交给代理路径,可用于临时判断故障是否与分流规则有关,但它不会修复错误的服务器参数,也不等于设备所有系统流量都必然采用同一路径。直连(Direct)则使用直接连接方式,适合检查目标在基础网络下的表现;它不会自动断开系统中的 VPN 配置。

首次设置可以先选配置(Config)。如果后续发现只有特定目标异常,再临时切换姿态进行对照,完成测试后恢复原来的选择。记录切换前的状态很重要,否则一次排查可能留下与日常需求不符的设置。当前文件或规则顺序仍不清楚时,先看常见问题中的分流说明,不必在入门阶段重写整份配置。

03 · Home:打开连接开关并完成授权

回到 Home,再检查一次已选服务器与 Global Routing。准备好后打开页面上的连接开关。首次启用时,系统会显示添加 VPN 配置的授权提示;阅读提示并允许后,按系统要求完成设备认证。这里授权的是系统网络配置,不是在输入服务器密码,服务器认证信息应在之前的 Add Server 中填写。

完成系统提示后回到 Shadowrocket,观察开关是否保持开启,以及是否出现连接错误。如果开关立即回落,先记录提示文字,不要快速连续点击。可以到系统 Settings 中查看 VPN 配置是否已建立;设备受到组织管理、系统限制或已有其他 VPN 连接占用时,表现可能不同,应先确认当前设备允许添加并启用该配置。

第一次验证建议暂时关闭 On Demand,先完成一次可重复的手动连接。On Demand 会根据条件触发连接行为,在手动测试过程中可能使连接重新开启,造成“关掉后又自动连接”的误解。手动流程确认正常后,再单独设置按需条件;不要用添加自动触发条件的方式处理服务器本身无法连接的问题。

连接保持开启后,不必继续反复切换开关。系统显示 VPN 状态,只能说明相关网络配置处于连接状态,不能单独证明订阅中的每个服务器或每个目标网站都可用。接下来需要同时检查服务器连通性与实际访问结果,才能判断是否完成设置。

04 · Connectivity Test:验证是否生效

在 Home 使用 Connectivity Test 检查服务器连通性。测试前确认当前选择的测试方式,并在同一网络下对同一服务器重复观察。不同测试方式检测的范围不同,能够返回测试结果并不保证目标服务的完整业务请求成功;反过来,某一种探测超时也不能直接证明所有访问都失败。

随后打开浏览器,访问自己有权访问且知道正常情况下能够打开的目标服务。不要只看已加载的旧页面,应刷新并等待新的请求完成。先测试一个普通页面,再尝试实际需要使用的功能,例如登录后的页面或文件请求。页面主体出现而图片、登录或其他功能失败,可能意味着它们访问了不同域名,需要分别判断。

如果使用配置(Config),结合当前配置检查目标应命中的规则与策略。一个目标走 DIRECT、另一个走 PROXY,可以是正常的分流结果。必要时查看应用中的连接记录,围绕目标域名查找对应请求,核对命中的规则与处理策略;不要仅凭出口地址未改变,就判定所有规则没有生效。

需要对照时,每次只改变一项:保持同一个目标和同一个服务器,临时切换到代理(Proxy)再重试;之后恢复配置(Config)。如果前者正常、后者异常,优先检查当前配置及策略选择。如果两种姿态都异常,再继续检查服务器与基础网络。直连(Direct)的对照结果也应记录,便于区分目标自身不可用和代理路径异常。

Data 中的流量读数可以帮助确认是否有数据活动,但统计范围、应用缓存和后台请求都会影响读数,不宜把某个瞬时数字当作唯一结论。完成一次成功验证后,记下可用的服务器、姿态和网络环境即可,无需为了获得更小的测试数值连续更改设置。

05 · 常见失败点:从基础网络逐层排查

出现异常时,先判断失败发生在哪一层:订阅读不出来、服务器测试不通、开关无法保持,还是只有某个目标访问失败。把错误归类后再操作,比同时更新订阅、切换 DNS 和改规则更容易得到有效结论。下面按影响范围从大到小检查。

先确认设备本身能联网

暂时关闭连接开关,若启用了 On Demand,也先暂停它,再检查 Wi-Fi 或蜂窝网络是否正常。公共 Wi-Fi 可能需要先完成网络登录;基础网络未连通时,订阅读取和服务器测试都可能失败。可在可用的另一种网络下重复同一个测试,但不要在切换网络的同时修改服务器参数,否则无法比较结果。

区分订阅更新失败与服务器连接失败

订阅更新失败,检查链接完整性、访问有效期及返回内容,必要时向自己的服务商确认原始资料。订阅能更新但服务器不能连接,则核对被选中的具体条目,检查 Address、Port、认证信息、TLS 与传输字段。更新后服务器列表可能改变,应再次确认当前选中项,不要只看分组名称相同就认为选择没有变化。

单个服务器持续超时而其他已有服务器正常时,问题范围通常已缩小,不宜重置整个客户端。所有条目都失败时,再回头检查当前网络、设备时间和系统权限。测试结果只能帮助定位,不能替代对实际参数和远端服务状态的确认。

开关异常与局部访问失败分别处理

开关开启后立即关闭,先看系统授权是否完成、VPN 配置是否允许启用,以及当前是否有其他网络配置冲突。开关保持开启但只有部分目标异常,则优先核对 Global Routing、Config 当前文件、规则先后顺序和相关策略。不要把“删除全部配置”作为第一步;修改前保留原文件,确保能够恢复。

如果错误提示涉及域名解析或证书,再检查 DNS 设置与系统时间。设备日期明显不正确可能影响 TLS 验证;出现证书错误时不应直接关闭验证来掩盖问题。将时间设置恢复准确,确认服务器名称等字段后再测试。更深入的参数解释见协议参考,常见连接现象可继续查阅连接排查问答。

当已有服务器能够正常访问目标、配置(Config)下的分流符合预期,并且断开后能够恢复基础网络,就完成了入门流程。之后再按实际需要设置 On Demand 或整理多个配置;这些操作应建立在手动连接已验证正常的基础上,不必在首次使用时一次完成。