规则片段阅读示例
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY第一条覆盖 example.com 及其子域；第二条覆盖所列本地地址范围；最后一条处理尚未命中的连接。此片段用于理解语法，不是完整可运行配置。
01 / ROUTING连接处理入口
Global Routing：配置、代理、直连
这是连接处理方式的总选择，不是服务器协议，也不是速度档位。
是什么：Global Routing 决定连接主要按配置规则处理，还是统一使用当前代理，或直接连接。配置、代理、直连分别对应界面中的 Config、Proxy、Direct。这里的 Config 是一种运行模式；底部 Config 页面则用于管理配置文件，两者相关但不是同一个操作入口。
在哪里、怎么设：在 Home 找到 Global Routing，打开后选择需要的模式。已有规则配置时，日常使用通常选择 Config，并确认 Config 页面已启用预期文件。需要判断问题是否由规则引起时，可短暂切换 Proxy 作对照；需要检查本地网络本身是否可用时，可切换 Direct。测试结束后恢复原模式，避免把临时排查状态当作长期设置。
| 模式 | 处理方式 | 何时使用 | 需要注意 |
|---|---|---|---|
| Config · 配置 | 按当前配置中的规则与策略处理连接。 | 需要域名、地址或其他条件分流时。 | 检查启用文件与规则顺序；导入不等于已启用。 |
| Proxy · 代理 | 主要使用当前选择的代理处理连接。 | 短暂对照规则模式，判断服务器是否可用。 | 不等于所有系统流量都必然被接管；仍受系统与相关设置影响。 |
| Direct · 直连 | 主要通过当前本地网络直接连接。 | 检查网络基础连通性，或明确需要直连时。 | 不是停止开关；当前连接状态与路由模式应分别确认。 |
02 / RULES条件与处理策略
规则分流：匹配条件与策略分开看
规则回答“哪些连接”，策略回答“怎样处理”。先检查首条命中的规则，再检查它引用的策略。
是什么：规则按配置顺序匹配，命中后交给对应策略处理。DOMAIN 匹配指定域名；DOMAIN-SUFFIX 匹配域名及其子域；DOMAIN-KEYWORD 匹配域名中的关键词。IP-CIDR 与 IP-CIDR6 分别描述 IPv4、IPv6 地址范围；GEOIP 使用地址归属数据判断；USER-AGENT 的适用性取决于客户端是否能够取得对应请求信息，不能假设所有连接都能用它识别。
在哪里、怎么设：进入 Config，先确认当前启用的配置，再保存副本并编辑规则。将范围明确的规则放在宽泛规则之前，最后用 FINAL 指定剩余连接的处理方式。DIRECT 表示直接连接，REJECT 表示拒绝连接；PROXY 在示例中表示代理处理策略，实际配置还应核对策略组或服务器名称是否存在，不能只看文字相同就认为引用有效。
修改后验证三个位置
- Global Routing 是否处于 Config。
- Config 是否启用了刚修改的文件。
- 新建连接实际命中了哪条规则、使用了哪个策略。
已有连接可能沿用原连接状态。修改后重新发起请求再观察，不用旧页面的缓存结果判断新规则。
注意什么：不要一次加入大量无法解释的规则。DOMAIN-KEYWORD 的覆盖范围可能比预想更宽；GEOIP 的结果受数据和解析地址影响；域名规则也不等于直接输入 IP 地址时仍会命中。需要拦截某个目标时，先确认实际请求域名，避免用过宽条件误伤其他连接。配置包含远程规则时，还应检查远程内容是否成功更新。
03 / SERVERS已有信息的导入与维护
Subscribe 与服务器管理
服务器信息、订阅和规则配置用途不同；导入前先确定手中的内容属于哪一种。
是什么：服务器条目保存连接所需的地址、端口、协议和认证信息。Subscribe 用于从用户已有的订阅地址更新一组服务器信息；Config 保存分流规则等配置。订阅更新成功只表示内容已获取并解析，不表示其中所有服务器都可连接，也不表示相应规则已经启用。
在哪里、怎么设：在 Home 的 SERVER 区域管理服务器，通过 Add Server 选择与已有信息一致的类型；手动填写时逐项核对地址、端口、密码或其他认证字段。已有二维码可用 Scan QR Code 导入，已有订阅可按 Subscribe 对应入口添加。完成后先检查分组和条目是否出现，再选择一个服务器运行 Connectivity Test，最后建立连接验证实际请求。
协议类型必须与已有服务器信息一致，例如 Shadowsocks、VMess、VLESS、Trojan、WireGuard 或 Hysteria2，不能为了通过测试而随意替换。传输方式、TLS、服务器名称等附加字段也应与原信息逐项一致；它们不是都可以留空的通用选项。缺少字段时，回到原始信息核对，而不是复制其他服务器的参数。
注意什么：更新订阅可能刷新条目、名称或分组，重要的手动修改应另行记录并确认保存方式。准备删除分组前，先检查其中是否有独立添加的服务器。订阅地址与二维码可能包含认证信息，分享截图或诊断内容前应遮盖完整链接、密码及识别字段。测试失败时保留原始条目，复制一份再改参数，便于比较与恢复。
04 / ON DEMAND自动触发条件
On Demand：按条件触发连接
先完成手动连接验证，再启用自动触发；不要用自动化掩盖基础连接问题。
是什么：On Demand 利用系统支持的条件触发连接，适合根据网络环境安排连接行为。它与规则分流分工不同：On Demand 关注何时建立连接，Global Routing 与 Config 关注连接建立后怎样处理请求。它也不是定时任务，不应把它理解成对任意时刻或任意应用行为的自动控制。
在哪里、怎么设：从 Settings 查找 On Demand，按当前界面提供的网络条件设置行为。先记录原状态，只添加一个可重复验证的条件，例如针对指定 Wi-Fi 环境安排连接行为。保存后切换到目标网络，观察系统连接状态，再打开一个新的请求进行验证。若系统首次要求添加 VPN 配置，应阅读系统提示并确认。
注意什么：手动关闭后又出现连接，应先检查 On Demand 是否仍在触发，而不是连续删除配置。网络切换、系统连接管理及条件顺序都可能影响观察结果。排查时可暂时停用 On Demand，验证手动连接稳定后逐条恢复条件；需要彻底停止连接时，应同时核对自动触发设置与主开关。
05 / DATA观察而非测速
Data：流量与连接记录
统计用于理解客户端处理过的连接，不能直接代替服务商计费数据或实际下载测试。
是什么：Data 提供流量和连接相关信息，具体展示维度以当前界面为准。它适合回答“请求有没有进入客户端”“修改规则后连接去了哪里”等问题。上传、下载或总量是观察指标，不是服务器质量评分；有流量增加也不代表目标页面已经完整加载。
在哪里、怎么设：打开 Data，先看统计范围，再在一次可控测试前后比较变化。如果界面提供连接详情，结合目标地址、连接时间和策略信息判断结果。准备清理记录或重置统计前，先保存需要对照的内容；确认观察口径一致后，再比较不同时间的结果。
注意什么：客户端统计范围可能与系统蜂窝数据统计、服务商用量统计不同，重复连接与后台请求也会产生流量。不要据此推断整个设备所有应用的精确用量。记录可能包含访问域名和地址，提供排查材料时只保留必要字段；如需确认速度，使用同一目标进行实际传输测试，并注明网络环境。
06 / SETTINGS按目的调整
Settings：DNS、测试、组件与同步
入口存在不等于必须修改。优先保留能稳定工作的设置，只针对明确问题调整相关项。
DNS
是什么、在哪里：DNS 将域名解析成地址，相关行为可能同时受到 Settings 与当前 Config 的影响。网站打不开时，DNS 是检查环节之一，但不应把所有连接失败都归因于解析。
怎么设：先记录当前解析设置，并检查配置文件内是否另有 DNS 定义。确定需要改变哪个解析环节后，一次只调整一项，再用同一个域名重新请求并观察结果。选择解析服务时，应理解其访问路径与隐私处理方式，不能只根据一个延迟值替换全部设置。
注意什么：输入 IP 地址可连接、输入域名失败，只是解析相关问题的线索，不是最终结论。TLS 服务器名称、缓存、IPv6 可达性也可能影响结果。更改后要区分旧缓存与新连接，确认解析出的地址与后续连接行为一致。
Test Method 与 Connectivity Test
是什么、在哪里：Test Method 用于选择连接测试方式，通常在 Settings 中查看；Home 中的 Connectivity Test 则用于对服务器运行测试。不同方法检测的环节不同，结果不能脱离方法直接比较。
怎么设：按当前界面提供的测试方法选择，并固定方法、服务器与网络环境后重复测试。若涉及测试目标，也应保持目标一致。先观察是否能完成测试，再观察结果变化，不要把偶尔较低的一次结果当作长期表现。
注意什么：端口可达不等于认证成功，完成一次请求也不等于所有目标都可访问。显示超时时，按本地网络、服务器地址和端口、协议参数、系统时间的顺序排查；不要只调整超时阈值而跳过实际失败原因。
Today Widget
是什么、在哪里：Today Widget 是系统组件相关的快捷入口，应用内相关项目可在 Settings 查找；实际添加和摆放由系统组件界面管理，能否显示及提供哪些操作以当前系统与应用为准。
怎么设：先在应用内确认服务器选择、Global Routing 和手动连接都正常，再到系统组件编辑界面添加可用的 Shadowrocket 组件。首次使用后返回应用核对状态，确认快捷操作与预期一致。
注意什么：组件是操作入口，不会替代配置管理，也不会补齐缺失的服务器信息。组件显示与应用状态不一致时，先打开应用核对，再检查系统刷新情况；不要只看组件文字就认定连接已经成功建立。
iCloud 同步
是什么、在哪里：iCloud 同步用于支持范围内的数据同步，入口可在 Settings 及系统 iCloud 设置中核对。同步与独立备份用途不同，同步可能把修改或删除传播到其他设备，不能把它视为永远保留历史副本的存档。
怎么设：先确认设备使用预期的 iCloud 账号，系统允许 Shadowrocket 使用 iCloud，再按应用当前提供的选项开启同步。首次开启或换机时，先保存一份可恢复的配置副本，等待同步后逐项检查 Config、服务器条目与相关设置。
注意什么：不要假设所有临时状态、日志和系统权限都能跨设备恢复。订阅地址等内容可能带有认证信息，导出副本应保存在受保护的位置。两台设备同时修改前先确定保留哪一份，避免在尚未确认同步结果时连续覆盖。
Diagnostics
是什么、在哪里：Diagnostics 用于收集或查看排查线索，可从 Settings 中查找对应入口。不同版本提供的工具和输出可能不同，应围绕实际失败的环节选择，而不是把所有工具依次运行一遍。
怎么设：先记下复现时间、网络类型、Global Routing 模式、所选服务器和目标现象，再复现一次问题并查看相关输出。优先保留与失败时间接近的错误信息，结合 Data 中的连接记录分析。需要完整流程时，转到问题诊断按症状检查。
注意什么：诊断记录可能包含地址、域名和认证字段。分享前遮盖订阅地址、密码及其他敏感内容，不要公开整份配置。看到单条错误时应结合上下文判断，避免将正常的重试或取消记录误认为全部连接失败。
07 / CHECK调整后的闭环
设置检查与恢复顺序
每次调整都应能回答：改了哪里、怎样复现、结果如何、怎么退回。
- 保存原状。记录 Global Routing、启用的 Config、所选服务器及 On Demand 状态，必要时导出配置副本。
- 建立基线。固定网络和目标，确认未修改前的现象；暂时关闭会干扰观察的自动触发条件。
- 单项调整。只改规则、服务器参数、DNS 或测试方法中的一项，保存后重新发起连接。
- 检查结果。结合实际访问、Data 与 Diagnostics 判断，不把一个测试数字当作全部结论。
- 恢复日常状态。测试没有改善就退回原设置；测试完成后恢复预期模式与 On Demand 条件。
尚未完成首次连接时，先阅读Shadowrocket 使用教程；遇到可重复的连接失败，进入问题诊断。已购恢复、平台选择及获取方式集中在客户端下载，不需要为排查一个设置问题反复删除应用。
获取与费用说明：iPhone / iPad 版在 App Store $2.99 一次性付费，系统要求以 App Store 页面标注为准；Mac（Apple 芯片与 Intel）、Windows、安卓、Linux 版免费，安装包通过本站 /dl/ 提供。客户端费用与用户已有服务的费用分别计算。