官方手册 · 功能介绍

Shadowrocket
功能与常用设置

先确认 Global Routing,再检查规则、服务器与网络条件。按这一顺序设置,可以区分“走哪条路径”和“何时建立连接”,避免同时修改多个开关后无法判断原因。

  • 先保留原配置
  • 一次调整一项
  • 用同一目标复测

01 · 流量路径

Global Routing 三种姿态

Global Routing 决定客户端如何处理进入其网络通道的流量,不是连接成功与否的指示器。在 Home 中找到该项,先看当前选中的 Config、Proxy 或 Direct,再判断实际行为。

姿态与界面词 处理方式 适用情况 核对重点
配置 · Config 按当前生效配置中的规则决定策略。 日常按域名、地址或其他条件分流。 确认选中了预期配置,检查规则顺序与最终策略。
代理 · Proxy 对进入通道且未被系统或配置排除的流量采用代理路径。 临时判断问题是否来自分流规则。 确认当前服务器可用;不要把此姿态理解为覆盖所有系统通信。
直连 · Direct 对客户端处理的流量采用直连路径。 与代理路径对照,检查本地网络是否正常。 Direct 不等于关闭连接开关,也不等于删除系统 VPN 配置。

设置时先在 Home 选择 Global Routing,再选择需要的姿态。使用 Config 时,应到 Config 确认当前生效的文件,而不是仅看列表里是否存在某个文件。文件已导入、文件已编辑、文件已生效是三个不同状态。

如果同一目标在 Proxy 下能访问、在 Config 下不能访问,应优先查看命中的规则与策略。若两种姿态都失败,再检查服务器、DNS 和当前网络。对照测试结束后恢复原来的姿态,避免临时排查设置影响后续使用。

02 · 匹配与策略

规则分流与 Config

规则描述“匹配什么”,策略描述“匹配后怎么处理”。在 Config 中查看当前文件的规则内容;需要分流时,Global Routing 应使用 Config。

先看类型,再看排列位置

DOMAIN 匹配指定域名,DOMAIN-SUFFIX 匹配域名及其子域名,DOMAIN-KEYWORD 按域名中的关键词匹配。后两者覆盖范围更宽,关键词过短可能让不相关请求也命中同一条规则。

IP-CIDR 与 IP-CIDR6 用于地址范围,GEOIP 按 IP 地理数据库分类。域名解析结果、数据库内容及相关配置会影响地址类规则的判断,不能仅凭网站名称推断一定命中哪一条。

规则通常按顺序匹配,前面的有效匹配决定处理方式。把具体规则放在较宽的规则之前,并在结尾核对 FINAL。它用于前面均未匹配时的最终处理,不应被当成普通域名条件。

策略要能对应实际路径

DIRECT 表示直连,REJECT 表示拒绝,PROXY 用于代理处理。配置也可能引用自定义策略组;遇到组名时,要继续核对组内实际选中的服务器,而不只看规则末尾的文字。

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,10.0.0.0/8,DIRECT
FINAL,DIRECT

以上是说明匹配逻辑的片段,不是可直接替换现有配置的完整文件。修改前保存原文件,再用一个已知域名复测。如果请求被 REJECT 命中,换服务器通常不会改变该条规则的拒绝结果。

03 · 连接信息

订阅与服务器管理

订阅负责集中提供服务器条目,单个服务器条目保存连接参数;Config 则承载规则及其他配置。三者相关,但导入其中一种不代表另外两种也已设置完成。

Home、Add Server 与 Subscribe

操作以用户已有自己的订阅或服务器信息为前提。在 Home 的添加入口进入 Add Server,按内容选择适合的 Type;使用订阅链接时选择 Subscribe,填写完整链接并保存。返回 Home 后检查是否出现预期分组,再选中需要使用的服务器。

手动添加时,Type 必须与服务器要求一致。Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard 与 Hysteria2 的字段不完全相同,不能只改 Type 后沿用旧参数。地址、端口、认证信息及传输相关字段应逐项按已有资料填写,字段含义可参阅协议技术参考。

更新后核对选中项

在已有订阅条目的操作菜单中执行更新,再查看分组内服务器是否按预期变化。订阅更新主要刷新其管理的服务器信息,不等于替换当前 Config。更新后名称或条目数量可能变化,需要重新确认当前选中的服务器是否仍存在。

更新失败时,先确认链接是否完整、当前网络能否取得内容,以及订阅是否仍有效。不要把带有访问凭据的完整链接贴到公开截图或诊断记录中。删除订阅或条目前先确认它属于哪个分组,避免把手动维护的条目与订阅条目混在一起操作。

04 · 连接触发

On Demand 按需连接

On Demand 根据条件请求系统建立或调整连接。它回答“什么时候连接”,Global Routing 回答“连接后怎样处理流量”,两者不是同一层设置。

先手动连接,再添加条件

在 Settings 中查找 On Demand 相关设置;若当前界面从连接选项进入,则以实际入口为准。启用前先完成一次手动连接与访问测试,确认服务器和配置本身可用,再添加 Wi-Fi、Cellular 或域名相关条件。

按 Wi-Fi 名称设置时,核对名称是否完全一致。按 Cellular 设置时,需要实际切换到蜂窝网络观察;仅在 Wi-Fi 下修改选项无法验证蜂窝触发结果。域名条件涉及系统对域名请求的判断,不是按某个应用图标启动来触发。

避免条件互相覆盖

一次只添加一种条件,保存后切换到对应网络,等待系统处理,再观察连接状态与实际访问结果。多个条件共同存在时,应检查排列顺序、匹配范围及动作,不要把同一网络同时写入相互矛盾的连接与断开条件。

如果手动断开后又自动连接,先查看 On Demand 是否仍启用。排查普通连接故障时,可以暂时停用它,避免自动触发干扰复测;确认手动路径正常后再恢复。按需连接由系统参与执行,不能把它理解为任意时刻持续运行的定时任务。

05 · 使用观察

Data 流量统计

Data 用于查看客户端记录的流量情况。它适合辅助判断请求是否经过当前连接、某段时间是否有传输,不应作为服务计费或剩余额度的唯一依据。

先确认统计范围

打开 Data 后,先读当前视图的时间范围、上传与下载方向以及可用的分类维度。不同视图可能显示当前连接或累计记录;只有范围相同的数字才适合直接比较。需要清除记录时,先保存有用信息,再确认重置会影响哪个范围。

验证时可先记下当前值,再访问一个已知目标并返回 Data 查看变化。数字增加只能说明存在传输,不能单独证明目标页面完整加载,也不能单独证明命中了预期规则。还应结合实际访问结果与连接记录检查。

客户端统计与服务器侧统计可能因协议开销、统计周期和计数范围不同而出现差异。Data 中没有预期变化时,依次确认连接开关、当前姿态和请求是否被排除,不要立即据此判断服务器不可用。排查结束后保留必要记录即可,避免长期积累包含访问目标的信息。

06 · 常用选项

Settings 核对清单

Settings 中的选项可能随设备和系统能力调整。找不到某项时先核对当前应用界面;不要为了对齐教程名称而修改功能相近但含义不同的设置。

DNS:区分解析与连接

DNS 将域名解析为地址。在 Settings 的 DNS 相关选项及 Config 的全局参数中核对解析设置;配置文件也可能影响最终行为,不能只改一处就认定全部请求都使用了新设置。

先保留当前可用值,再按明确需求修改。若配置使用 dns-server = system,表示采用系统解析来源,不代表代理服务器一定正常。修改后用同一域名复测;能解析但连接失败时,应继续检查路由与服务器,而不是反复更换 DNS。

Test Method:理解测试测量对象

Test Method 决定连通性测试采用的方式。在 Settings 中找到该项,核对方法与相关测试目标,再回到 Home 执行 Connectivity Test。比较服务器时应保持方法、目标和当前网络一致。

测试数值受握手方式、目标响应及网络状态影响,不等于实际下载速度,也不保证所有网站可用。出现超时时,先确认测试目标本身能响应,再检查服务器参数;不要仅按一次测试结果删除已有条目。

Today Widget:快捷观察与操作

Today Widget 用于系统支持的快捷入口或状态展示。在 Settings 中查找相关选项,再到系统允许的组件区域配置;具体是否可添加及可操作范围,以当前设备系统和应用界面为准。

先在应用内确认连接正常,再验证组件显示或操作后的结果。组件状态可能存在刷新间隔,不能替代应用内检查。如果组件与应用显示不一致,先打开 Home 核对实际连接,不要连续重复切换。

iCloud 同步:确认内容与方向

iCloud 相关选项用于在支持的范围内保存或同步应用数据。在 Settings 中检查同步开关,同时确认系统已允许应用使用 iCloud。开启前先阅读当前提示,辨明将处理的是配置、服务器信息还是其他内容。

同步不等于完整设备备份,也不保证即时完成。换设备时先保留原设备上的有效配置,再在另一台设备确认同步内容。遇到覆盖、合并或恢复提示时先核对方向;订阅链接和认证信息同样需要谨慎管理。

Diagnostics:收集可定位的问题

Diagnostics 用于检查连接问题或收集诊断信息。在 Settings 中找到相关入口后,先按当前界面的说明启用必要记录,再复现一次问题。记下当时的网络类型、Global Routing 姿态、目标域名及出现的错误现象。

诊断记录可能包含访问域名、服务器地址或配置细节。分享前检查并移除凭据与个人信息,尤其不要公开完整订阅链接。取得需要的结果后停止额外记录;日志越长并不代表越容易定位,单次、可重复的样本通常更清楚。

07 · 修改后复测

按同一顺序验证设置

连接图标、测试数字与页面访问分别反映不同环节。至少把“已建立连接”“命中预期路径”“目标能正常使用”分开确认,才知道设置是否达到目的。

保留基线,再逐项排查

  1. 记录当前状态。确认 Home 中选中的服务器、Global Routing 姿态与 Config 文件,保留修改前的可用值;先暂停可能自动触发的 On Demand 条件。
  2. 检查基本连接。在同一网络下执行 Connectivity Test,再尝试访问固定目标。测试失败时先查参数与网络,测试成功但目标失败时继续看规则和 DNS。
  3. 对照分流结果。必要时临时切换 Proxy 与 Config,用同一目标复测。若只有 Config 失败,检查匹配顺序、策略组和 FINAL,不要同时更换协议。
  4. 恢复日常设置。确认结果后恢复预期姿态与 On Demand,停止临时诊断记录,并在实际使用的 Wi-Fi 或蜂窝网络上再验证一次。

首次导入尚未完成时,先按教程建立一条可验证的连接;需要查界面词时阅读术语表;已经能稳定复现的问题,可按常见问题逐项排除。每次只改变一个变量,才能把结果对应到具体设置。

下载 Shadowrocket