规则类型：识别请求
DOMAIN 匹配完整域名，DOMAIN-SUFFIX 匹配域名本身及其子域，DOMAIN-KEYWORD 按域名中的关键字匹配。地址相关条件可用 IP-CIDR、IP-CIDR6 与 GEOIP；其中 GEOIP 的结果依赖地址归属数据。
USER-AGENT 依赖能够获得相应请求信息，不适合当作所有加密流量都能使用的识别方式。FINAL 用于承接前面未命中的请求，应检查其策略是否符合预期。
官方手册 · 功能与设置
Shadowrocket
Shadowrocket
功能与常用设置
先确定流量处理方式，再调整服务器、规则与自动连接。每次只改一项，并用相同请求验证结果。
本页面向 iPhone 与 iPad，按“是什么、在哪个界面、怎么设、注意什么”说明常用功能。具体入口与可用选项以设备上实际显示为准；系统要求以 App Store 页面标注为准。
01 · 流量姿态
Global Routing：Config / Proxy / Direct
Global Routing 是连接后的流量处理入口。在 Home 中打开 Global Routing，可选择配置、代理或直连三种姿态，对应界面词为 Config、Proxy、Direct。它决定整体处理方式，不等于选择某一台服务器，也不等于开启连接。服务器已选中、连接开关已打开、流量按预期分流，是需要分别核对的三件事。
| 姿态 | 处理方式 | 何时使用 | 注意事项 |
|---|---|---|---|
| 配置 · Config | 按当前配置文件中的规则决定策略。 | 日常使用，需要按域名、地址等条件区分请求。 | 检查实际启用的配置、规则顺序与末尾 FINAL。 |
| 代理 · Proxy | 以代理姿态处理流量，仍需留意适用的系统与连接例外。 | 短时确认服务器是否可以承载目标请求。 | 检查选中的服务器；测试后恢复原姿态。 |
| 直连 · Direct | 以直接连接为主要处理方式。 | 核对当前网络能否直接访问，或需要暂时使用直连。 | 不能用该姿态下的访问结果证明代理服务器可用。 |
怎么选：先用 Config，排查时再做对照
已有可用配置时，通常从 Config 开始。若某个目标访问异常，可记录原设置，短时切到 Proxy 再试同一请求；只有 Config 异常时，优先检查规则、策略与 DNS。若 Proxy 下也异常，则继续核对服务器参数与网络。Direct 适合建立直连对照，但不同姿态的结果只能缩小排查范围，不能单独确定故障原因。
切换姿态后重新发起请求。已经建立的连接可能继续沿用原处理路径，因此只观察一个尚未刷新的页面，容易把旧连接结果误认为新设置的效果。
02 · 配置与策略
规则分流：条件匹配与策略结果
规则分流把“请求是什么”与“请求如何处理”分开。规则类型描述匹配条件，策略描述命中后的动作。在 Config 中查看、编辑并启用配置文件，再把 Home 的 Global Routing 设为 Config，规则才会按该姿态参与流量处理。只把文件导入列表而未启用，不代表它已经接管当前连接。
策略：决定处理方式
PROXY 表示使用代理策略，DIRECT 表示直接连接，REJECT 表示拒绝请求。配置也可能引用自定义策略名称，此时要继续检查该策略实际选择的服务器或下级策略，不能只看名称判断出口。
规则通常从上到下检查，先匹配的规则决定结果。更具体的规则应放在覆盖范围较大的规则之前；调整后检查有无较早出现的条件把请求提前接走。
[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN,blocked.example.net,REJECT
FINAL,PROXY示例域名仅用于说明语法，不是可用服务配置。第一条让 api.example.com 优先命中 DIRECT，第二条处理 example.com 的其余匹配请求。修改前先保留原配置；完整段落结构与规则说明见规则手册。
03 · 连接信息
订阅与服务器管理
服务器记录描述连接目的地与认证参数，订阅用于批量维护已有服务器信息，配置文件则主要负责全局参数与分流逻辑。这三类对象的作用不同：更新订阅不等于更新当前规则，切换配置也不一定改变 Home 中已选中的服务器。开始设置前，先确认手中的内容是单条服务器信息、订阅链接，还是配置文件地址。
在哪里设、怎么设
在 Home 的服务器列表与 Add Server 中管理连接信息；已有订阅按应用提供的订阅入口添加，需要配置文件时则进入 Config。手动添加时先选择正确的协议类型，再逐项核对服务器地址、端口、认证信息及相关传输参数。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等协议的字段不同，不能仅修改协议名称后复用全部参数。
保存后回到 Home，在 SERVER 列表选择准备使用的记录，确认选中状态。订阅更新后要复查默认服务器是否仍存在，名称相近的记录是否对应同一地址，以及所选策略是否仍引用有效对象。首次导入与批量更新后，都适合先执行 Connectivity Test，再进行实际访问验证。
需要注意的边界
本手册以用户已有自己的订阅或服务器信息为前提。客户端一次性买断 ≠ 线路套餐：购买 Shadowrocket 获得客户端使用权，连接所需的信息仍需自行准备。本站不提供、不销售、不推荐节点或订阅。订阅地址可能包含访问凭据，分享排查记录时应隐藏完整地址、认证字段与二维码。
Shadowrocket 是 Apple 平台的付费客户端，唯一获取入口为 App Store。购买、安装与正版核对步骤见App Store 说明；本页的服务器操作不涉及购买应用之外的服务交易。
04 · 自动连接
On Demand：按条件建立连接
On Demand 用于按条件触发或维持连接，适合需要减少手动打开连接开关的场景。它控制的是连接时机，而不是域名如何分流；流量最终使用 PROXY、DIRECT 还是 REJECT，仍取决于 Global Routing 与当前配置。不能把 On Demand 当作服务器故障时的自动修复开关。
入口与设置步骤
在 Settings 中查找 On Demand，先查看当前设备展示的网络条件与相关选项。确认手动连接和访问都正常后，再启用所需条件。若页面提供 Wi-Fi、蜂窝或特定网络条件，应按实际使用场景逐项配置，并记录修改前的状态。
设置后分别在目标网络下测试连接行为。切换网络时等待系统完成网络切换，再查看 Home 的连接状态；只看到状态栏标识，不能说明每个目标都已按预期访问。
重连与电池用量
启用后，手动断开可能又被条件触发而重新连接。若需要临时停止自动连接，先检查 On Demand，再操作 Home 的连接开关，避免反复开关却没有改变触发条件。
耗电还与请求频率、网络质量及重连次数有关。对比时使用相近的观察时长，并在系统电池用量中查看记录；不要仅凭开启 On Demand 就推断电量一定增加或减少。
05 · 使用观察
Data：流量统计与前后对照
Data 用于查看应用记录的流量活动。在底部导航进入 Data，先确认当前展示的统计范围、记录区间以及设备上可用的分类。上传与下载数值能够帮助判断是否发生数据交换，但不等于页面访问成功，也不能单独证明流量实际命中了某一条规则。
做一次可复查的测试时，先记录当前数值与连接姿态，关闭不相关的前台任务，再只发起一个明确请求，随后返回 Data 比较变化。后台同步、系统请求与其他应用活动仍可能产生流量，因此统计变化只作为辅助信息；要判断分流结果，应同时查看可用的连接记录与规则命中信息。
06 · 常用选项
Settings：DNS、测试、同步与诊断
Settings 汇集应用层面的常用选项，但并非所有连接参数都只在这里生效。部分参数来自 Config 中的配置文件，另一些跟随具体服务器记录。排查前应先确认当前启用的配置，再核对 Settings 中对应项目；名称相近的选项，也要结合其说明判断适用范围。
DNS：先确认解析链路
是什么与在哪里：DNS 把域名解析为地址，相关设置可在 Settings 的 DNS 项目及当前 Config 的全局参数中检查。解析结果会影响基于地址的匹配，也可能影响建立连接的目标。
怎么设：先保留已可用的设置，确认当前配置是否声明了 DNS 参数，再按实际网络条件调整解析方式。修改后用同一个域名重新测试，并留意已有缓存与连接是否影响观察。
注意什么：不要为排查一次性改动多个解析选项。域名解析成功不代表服务器认证成功；反过来，连接服务器正常也不能证明目标域名一定可解析。应把解析、建立连接与目标响应分开核对。
Test Method：理解测试在测什么
是什么与在哪里：Settings 中的 Test Method 决定相关连接测试采用的方式。它影响如何观察服务器可达性，不会直接修改分流规则，也不是通用的连接加速设置。
怎么设：依据界面列出的方式及其说明选择测试方法；若需要设置测试目标，使用自己能够确认响应行为的地址。修改后在 Home 运行 Connectivity Test，并用同一方法比较结果。
注意什么：测试失败可能来自测试目标、测试方式或网络限制，不能立即认定所有请求都会失败。测试成功也只证明该次测试链路可用，仍应访问真正需要的目标进行验证，不把不同方法的数值直接混为同一指标。
Today Widget：快捷操作与状态查看
是什么与在哪里：Today Widget 用于系统支持的快捷展示与操作，相关选项在 Settings 中查看，实际添加位置与呈现方式取决于设备系统。
怎么设：先在应用内完成有效配置与服务器选择，再按系统提供的方式添加可用组件。需要切换连接时，先确认显示的是预期对象，操作后回到 Home 核实连接状态。
注意什么：组件显示可能存在刷新间隔，不能替代完整的连接诊断。若当前系统未提供对应入口，以设备实际支持情况为准，不根据另一台设备的布局推断本机一定拥有相同操作。
iCloud：同步前先保留副本
是什么与在哪里：iCloud 相关功能用于应用支持范围内的数据同步或云端操作，在 Settings 中检查相关设置，并结合系统 iCloud 状态核对可用性。
怎么设：先确认设备使用预期的 iCloud 账户，检查系统允许应用使用 iCloud，再查看应用中具体同步项目。跨设备操作前保留当前可用配置，等待同步完成后核对文件内容与服务器记录。
注意什么：同步不等于历史备份，也不等于 App Store 的已购恢复。配置中可能包含敏感连接信息，应先了解同步范围；不要假设所有临时状态、统计记录与系统 VPN 配置都会随之完整迁移。
Diagnostics：收集可复查的故障信息
是什么与在哪里：Diagnostics 提供诊断相关入口，在 Settings 中查看可用项目。它适合在问题发生时收集线索，而不是在不了解作用时长期启用全部记录选项。
怎么设：记录问题发生的网络类型、Global Routing 姿态、当前配置与失败目标，再按界面说明运行所需诊断。每次只变更一个条件，保留前后结果，便于区分 DNS、服务器连接、规则或目标响应问题。
注意什么：诊断输出可能含域名、地址及请求信息，分享前应检查并隐藏认证参数与个人数据。完成排查后恢复临时开启的选项；遇到不明确的错误，再到FAQ按问题类型继续核对。
07 · 操作顺序
一次只改一项，保留验证依据
- 确认基础信息。在 Home 检查已选服务器；在 Config 确认启用的文件。服务器信息与配置都应来自用户已有的资料。
- 确认流量姿态。记录 Global Routing 当前是 Config、Proxy 还是 Direct，再决定本次需要验证的行为。
- 建立可用基线。手动连接并执行 Connectivity Test，随后访问实际目标。基础连接未正常前，暂不叠加自动连接条件。
- 调整单个变量。只修改一项规则、DNS 选项或服务器参数，重新发起同一请求，必要时结束旧连接后复查。
- 最后设置自动化。确认手动使用正常后，再调整 On Demand、Today Widget 与同步选项。记录异常时恢复原设置，避免连续改动掩盖原因。
本页用于理解功能边界；首次操作按教程逐步完成，配置段落与规则语法按规则手册核对。这样可以把“连接是否建立”“规则是否生效”和“目标是否可用”分别验证。