官方手册 · 功能索引

Shadowrocket 功能与设置

先在 Home 确认连接状态与 Global Routing,再决定是核对服务器、调整规则,还是修改 Settings。下文以 iPhone / iPad 界面为例,说明每项功能的位置、用法和验证方法。

Home
查看连接状态、路由模式与服务器。
Config
确认启用的配置,检查规则与策略。
Data
比较流量计数,确认统计范围。
Settings
调整连接触发、测试与诊断选项。
01 · 连接路径

Global Routing 三种模式

先选流量处理方式,再检查服务器与配置。

在 Home 点开 Global Routing,可以选择配置、代理或直连,对应界面上的 Config、Proxy 和 Direct。这项设置决定客户端怎样处理接管的连接;它与顶部连接开关分开,切到 Direct 不等于断开系统 VPN。

界面选项连接如何处理何时使用
Config(配置) 按当前配置的规则与策略处理。 日常需要针对不同目的地分流时使用。先确认启用的是预期的配置。
Proxy(代理) 客户端接管的连接走所选代理,不按配置中的分流规则逐条选路。 规则模式下请求失败时,用同一目标短时测试代理路径。
Direct(直连) 客户端接管的连接不经代理服务器。 在同一网络下对照目标能否直接访问,或临时不使用代理路径。

排查时先记下原模式,把服务器、网络和测试目标保持不变,只切换模式,然后发起一次新请求。如果 Proxy 能访问、Config 不能,优先去 Config 查规则顺序和策略选择;如果两种模式都失败,再核对服务器参数和当前网络。对照结果用于缩小范围,不能单凭一次成功或失败判定原因。测试结束后恢复日常使用的模式。

02 · 匹配与动作

规则分流与策略

查规则顺序,也查策略最终指向哪里。

规则分流把「匹配什么」和「匹配后怎么处理」写在同一条规则里。在 Config 找到正在使用的配置,先留存副本,再进入配置的规则编辑界面。检查时从上往下读:越具体的例外越适合放在通用规则之前;没有匹配到前置规则的连接交给末尾的 FINAL。

规则类型:先确认匹配对象

  • DOMAIN 匹配完整域名;DOMAIN-SUFFIX 匹配域名后缀,适合覆盖主域名及其子域名;DOMAIN-KEYWORD 按域名中的关键词匹配,写得太宽可能影响无关域名。
  • IP-CIDR 与 IP-CIDR6 分别匹配 IPv4 与 IPv6 网段;GEOIP 依据地址归属数据匹配,不能用来判断页面语言、账号地区或网站运营方所在地。
  • USER-AGENT 依赖客户端能取得的请求字段,不是按应用名称匹配。该字段不可见时,不应把它当作稳定的分流依据。

策略动作:核对规则右侧

DIRECT 表示直连,PROXY 表示走代理,REJECT 表示拒绝连接。如果规则右侧写的是策略组名称,还要确认该组当前选中了什么。只在 Home 更换服务器,不一定会改变某条指定策略组的规则走向。

[Rule]
DOMAIN,blocked.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
03 · 连接资料

订阅与服务器管理

分别确认列表来源、当前选项和连通性。

添加单台服务器

服务器条目保存建立连接所需的参数。已有服务器信息时,从 Home 进入 Add Server,先选择与资料一致的协议,再逐项填写地址、端口和该协议要求的认证参数。Shadowsocks、VLESS 和 Trojan 的字段不完全相同;不要用同一个页面的填法推断另一种协议的参数。保存后回到服务器列表,选中刚添加的条目,再连接验证。条目出现在列表中,只说明资料已保存。

导入与更新已有订阅

订阅是由已有订阅地址维护的一组服务器条目。在 Home 打开添加入口,选择 Subscribe 并填入用户已有的完整订阅地址。导入后核对分组是否出现,再从中选择实际要用的服务器。日常更新应针对原订阅分组操作,避免重复导入同一地址。更新后如果原选项不见了,先核对该条目是否被移除或改名,并检查相关策略组是否需要重新选择。

区分订阅更新与服务器测试

订阅更新检查的是列表能否取回;Connectivity Test 检查的是所选测试方法下的连通性,两者不是一回事。列表可更新,并不代表每条服务器都能接受连接。若只有一条失败,先核对该条的协议和参数;若同组多条同时失败,先用相同网络重测一条已知可用的记录,再检查更新是否改变了条目。订阅链接和二维码可能包含账号凭据,不宜贴到公开反馈或截图中。

04 · 自动触发

On Demand 按需连接

连接触发条件与规则分流是两层设置。

On Demand 用来设置客户端何时按条件建立连接;Global Routing 决定连接建立后流量如何处理。配置前先在 Home 用手动开关验证服务器与路由模式可用,然后到 Settings 打开 On Demand,按页面可选条件设置触发网络。只添加当前需要的条件,便于确认到底是哪一项触发了连接。

保存后,在测试设备上从一种网络切换到另一种网络,发起一次新请求,再回到 Home 核对连接状态。若手动断开后又自动连上,先暂时停用 On Demand 再重测;若停用后能保持断开,回到条件列表逐项检查,而不是先删配置或服务器。只在某个 Wi-Fi 下出现问题时,也应单独核对该网络是否满足触发条件,以及它本身是否需要先完成登录。

05 · 计数与范围

Data 流量统计

用前后差值观察计数,不把计数当作路由记录。

Data 用于查看 Shadowrocket 记录的流量。进入该界面后,先认清当前显示的统计范围及发送、接收两个方向,再比较记录。观察单次操作时,可在请求前记下读数,执行一次可重复的访问,再回看数值变化。尽量保持网络和路由模式一致;后台刷新或下载也可能在同一时间增加计数。

如果读数没有明显变化,先确认 VPN 是否连着、请求有没有真正重新发出,以及前后读数是否来自同一个统计范围。浏览器命中缓存时,打开同一页面不一定产生新的网络传输。若界面提供清除计数的选项,需要保留对照记录时应先记下原值。Data 既不是系统全设备流量账单,也不能单独证明某个域名命中了哪条规则。需要确定走向时,应结合当前模式、规则和可见的连接记录判断。

06 · 常用选项

Settings 常用项

一次修改一项,记录改动前后的测试条件。

DNS:核对域名解析

DNS 负责把域名解析为地址,与 Global Routing 的选路判断不是同一个动作。在 Settings 核对 DNS;如果所用配置也定义了解析设置,再到 Config 检查那份配置。修改前记录原值,只改一处,并用同一网络重新测试同一个域名。尤其是单位或家庭网络的内部域名,可能依赖网络提供的解析服务;换用其他解析地址后,公网域名能打开,不代表内部域名仍能解析。

Test Method:选择连接测试方法

Test Method 决定如何执行 Connectivity Test。在 Settings 选择适合当前排查目的的方法,再回到 Home 对同一服务器测试。若所选方法需要访问测试地址,结果还受测试地址本身是否可达的影响。不同方法测量的环节不同,不宜把结果混在一起排序;一次测试通过也不等于所有目的地都能访问。比较前后两次结果时,保持方法、测试目标和接入网络一致。

Today Widget:系统快捷入口

Today Widget 用于从系统提供的小组件区域访问客户端的快捷操作。先在 Settings 核对应用内有关 Today Widget 的选项;系统支持时,再到系统的小组件编辑界面添加或检查入口。能否添加和显示哪些控件取决于系统支持情况。执行快捷操作后,如果需要确认 VPN 是否连上,回到 Home 查看实际状态,不把小组件的显示当成连接已建立的凭据。

iCloud:核对同步范围

iCloud 用于在符合条件的 Apple 设备之间同步应用所支持的资料。先确认两台设备登录的是同一 iCloud 账号,并在系统设置中允许应用使用 iCloud,再查看 Settings 中的相关选项。开始同步前保留目标设备上需要的配置;同步后逐台核对服务器列表、当前配置和路由模式,不要假定所有本机状态都会原样复制。系统 VPN 授权仍应在目标设备上按提示处理。

Diagnostics:记录可复现的问题

Diagnostics 用于汇集排查所需的信息。在 Settings 找到 Diagnostics,先记下当前网络、Global Routing 选项和受影响的操作,再复现一次并查看可见的诊断结果。把「无法启动连接」「已连接但请求失败」「只有特定目标失败」分开记录,避免把它们当成同一种故障。对外提交记录之前,移除订阅地址、认证字段和不宜公开的域名,保留能复现问题的步骤与不含凭据的错误提示。