官方手册 / 功能介绍
Shadowrocket
功能与常用设置
先确定流量处理方式，再检查服务器、规则与连接条件。每次只调整一类设置，便于判断变化来自哪里。
本页以 iPhone 与 iPad 上的应用内入口为线索。具体选项以当前界面为准；系统要求以 App Store 页面标注为准。
01 / 流量处理方式
Global Routing：Config、Proxy、Direct
Global Routing 决定进入客户端处理范围的流量怎样选择路径。它与服务器是否可用、系统连接开关是否开启，是三个不同的问题。
是什么：Config 是配置模式，按当前启用的配置规则选择策略；Proxy 是代理模式，将客户端处理的流量交给代理策略；Direct 是直连模式，使用直连策略。这里的“全部”指进入客户端处理范围的流量，不宜理解为设备上的每一种系统通信都必然被接管。
在哪个界面：从 Home 找到 Global Routing，进入后选择对应模式。开始排查前先记录当前选项，并确认 Home 中选中的服务器。仅切换到 Proxy 不会补全服务器参数，也不会自动证明该服务器可连接。
| 界面选项 | 处理方式 | 何时使用 | 核对重点 |
|---|---|---|---|
| Config / 配置 | 按当前 Config 的规则及策略处理。 | 已有明确的分流需求，日常按规则使用。 | 当前配置、规则顺序、策略指向。 |
| Proxy / 代理 | 使用代理策略，不按日常规则逐项分流。 | 临时检查代理连接，缩小规则问题的范围。 | 所选服务器、认证字段、实际访问结果。 |
| Direct / 直连 | 使用直连策略。 | 临时检查当前网络的直连访问情况。 | 本地网络是否可用，以及测试完成后的模式恢复。 |
怎么设：已有可用配置时选择 Config，再打开一个符合预期规则的目标进行验证。若 Config 下失败，可临时选择 Proxy，以同一网络、同一服务器访问同一目标。Proxy 成功而 Config 失败时，再检查命中的规则；两者都失败时，优先检查服务器信息与网络条件，而不是继续增加规则。
注意什么：Direct 不等于关闭系统 VPN 连接，界面中的模式选择与连接开关应分别核对。排查结束后恢复原先的日常模式，避免忘记临时设置。需要逐步连接流程时，转到使用教程；本页主要说明各功能之间的关系。
02 / Config 与策略
规则分流：先匹配，再选择策略
规则回答“这次连接符合什么条件”，策略回答“符合条件后怎样处理”。只认识规则关键字，还不足以确定实际路径。
是什么：规则通常按顺序检查，命中后使用该规则指定的策略。常见策略包括 DIRECT、PROXY 与 REJECT，分别用于直连、代理和拒绝。配置还可以引用策略组，因此看到 PROXY 或组名后，应继续核对它最终指向的服务器。
在哪个界面：进入 Config，先确认当前启用的配置，再查看或编辑其中的规则。保存另一个文件，不代表已经切换到该文件；需要同时确认 Global Routing 为 Config，才能按预期验证配置中的分流逻辑。
怎么设：先备份当前配置，再添加范围明确的规则。把具体目标放在较宽泛的匹配条件之前，并检查末尾的 FINAL。测试时记录访问目标、命中规则和所用策略，避免仅凭页面是否打开来推断分流结果。
| 关键字 | 匹配依据 | 设置时的判断 |
|---|---|---|
| DOMAIN | 完整域名。 | 只指定一个域名时使用，不等同于包含其所有子域名。 |
| DOMAIN-SUFFIX | 域名后缀。 | 覆盖对应域名及其子域名，注意影响范围。 |
| DOMAIN-KEYWORD | 域名中的关键词。 | 匹配面较宽，避免短关键词导致意外命中。 |
| IP-CIDR / IP-CIDR6 | IPv4 / IPv6 地址段。 | 核对地址类型与前缀长度，域名请求还可能涉及解析。 |
| GEOIP | IP 地理归属数据。 | 判断依赖地址与数据库，不是按页面语言分流。 |
| FINAL | 前面规则未匹配时的兜底。 | 确认兜底策略，避免漏匹配的连接走向不符合预期。 |
注意什么：同一页面可能请求多个域名，主页面成功不代表附属资源都命中了相同策略。规则命中还受 DNS 结果、配置内容与连接复用等因素影响。不要把单条示例追加到任意位置后就认为设置完成；应检查前面的规则是否已经先行匹配。关键字解释可查阅术语手册。
03 / Home 与导入
订阅与服务器管理
以已有的订阅或服务器信息为前提。客户端一次性买断 ≠ 线路套餐；订阅链接从你的服务商处获取。
是什么：单个服务器保存连接所需的协议、地址、端口与认证参数；Subscribe 用于导入和更新一组服务器信息。Config 则负责规则与相关配置，两者用途不同。更新订阅通常是刷新该订阅对应的内容，不应当作修复所有配置问题的通用操作。
在哪个界面：在 Home 的添加入口进入 Add Server，选择相应类型。已有订阅链接时使用 Subscribe；已有单个服务器参数时选择对应协议并填写字段。二维码可通过 Scan QR Code 读取，剪贴板导入适用于当前客户端支持的分享内容。
怎么设：先核对导入材料属于订阅链接、单个服务器分享链接还是配置文件，再选择对应入口。手动填写时，Address、Port 和协议必须与服务商给出的信息一致；Password、UUID、TLS、SNI 等字段只按该协议实际要求填写，不能把不同协议的参数互换。导入完成后给服务器或订阅使用可辨认的备注，再选择服务器进行测试。
多订阅使用时，先按来源与用途整理备注，更新前确认操作的是哪一组。某个服务器失效不一定需要删除整组内容；先核对订阅更新结果和服务商侧的有效状态。删除前保存必要的信息，尤其是手动修改过、后续可能被更新覆盖的字段。
注意什么：订阅链接可能包含访问凭据，不要贴入公开日志、截图或反馈文本。二维码能够被读取只代表内容可识别，不代表服务器可连接。延迟测试也不等同于完整的网页访问验证。有关更新、排序、删除与备份的操作，参见订阅与服务器管理手册。
04 / 连接条件
On Demand：按条件发起连接
On Demand 管理何时建立连接，不替代 Global Routing，也不负责判断某个订阅是否有效。
是什么：On Demand 利用系统的按需连接机制，按设定的网络条件处理连接。它适合需要在特定网络环境下自动连接的场景；应用内显示的条件及其组合方式，应以当前界面为准。
在哪个界面：进入 Settings，找到 On Demand 相关选项，查看当前开关和已有条件。若此前已配置过按需连接，先记录这些条件，再判断是否需要增加或修改，避免重复条件互相干扰。
怎么设：先在手动连接状态下确认服务器与 Config 可用，再设置按需连接。每次只调整一个网络条件，保存后在相应网络环境中观察系统 VPN 状态，并实际访问一个已知目标。Wi-Fi 与蜂窝网络之间切换后，也应分别验证，不要只在同一网络中反复开关。
注意什么：配置了 On Demand 后，手动断开连接可能仍会在条件满足时触发重新连接。需要暂时停止自动连接时，应检查 On Demand 条件，而不只是重复点击 Home 开关。按需连接成功不代表分流正确；连接建立后，仍由 Global Routing 与当前配置决定流量路径。
05 / 使用记录
Data：查看流量，不代替账单
Data 用于观察客户端记录的流量变化。它适合排查“是否产生了传输”，不能单独证明速度、线路质量或计费结果。
是什么：Data 展示客户端可见范围内的流量统计。上传与下载代表不同方向的数据传输，具体统计维度及记录范围以页面实际展示为准。客户端统计与设备系统统计、服务商计量可能使用不同口径，因此数值不必完全一致。
在哪个界面：打开 Data，先看清统计对象与时间范围。若当前页面提供服务器或连接相关的分类，应确认正在查看的对象，再进行前后对照，不要把某个分类下的数值当成整个设备的总流量。
怎么设与查看：选择一个明确的测试过程，例如只访问一个目标，然后比较操作前后的流量变化。若界面提供重置入口，先保存需要的记录，再决定是否重置；重置客户端统计不会重置服务商侧的用量。长时间观察时，应尽量保持相同统计范围。
注意什么：出现少量流量不代表目标内容已成功加载，连接协商、重试和后台请求也可能产生传输。Data 不能直接推导剩余可用量，也不能替代服务商的账单。需要判断一次访问为何失败时，将 Data 与 Diagnostics 中的连接信息结合查看。
06 / 常用选项
Settings：DNS、测试、快捷入口与同步
先保留当前可用设置，再按具体问题修改。设置名称相同，并不意味着它能解决所有连接故障。
DNS：区分解析失败与连接失败
是什么、在哪里：DNS 负责将域名解析为地址。检查 Settings 的 DNS 相关项时，还应查看当前 Config 中是否包含 DNS 配置，避免只改了一个入口，却忽略正在使用的配置内容。
怎么设：先记录现有解析设置，再按明确需求调整，并使用同一个域名重新验证。若只有部分目标失败，先判断是解析没有返回结果，还是返回地址后连接失败。需要指定解析方式时，应核对地址格式、可达性与当前网络条件，不要仅因某个地址常见就直接替换。
注意什么：解析结果可能被缓存，修改后观察到的结果不一定立即改变。DNS 调整也不会修正错误的服务器密码、端口或 TLS 参数。涉及配置覆盖与优先级时，以当前配置和实际诊断结果为依据，不把更换 DNS 当成固定的第一步。
Test Method：固定测试口径
是什么、在哪里：Test Method 是 Settings 中与连接测试方式有关的选项。Home 中的 Connectivity Test 结果需要结合所选方法解释；不同方法可能测试不同阶段，因此结果不能直接混为一谈。
怎么设：选择当前界面支持、且适合本次排查目的的方法，再对同一组服务器进行测试。对比前后结果时保持网络、测试方法及测试目标一致。如果测试方式还包含目标地址或超时相关选项，也应一起记录。
注意什么：测试成功通常只说明该测试条件成立，不等于所有实际访问都成功；显示失败也可能与测试目标或超时条件有关。排序时不要只看一个延迟结果，最终仍需使用真实访问验证当前服务器。
Today Widget：快捷入口与系统可用性
是什么、在哪里：Today Widget 是与系统快捷访问有关的设置项。先在 Settings 查看当前提供的相关选项，再到系统相应的组件管理界面检查是否可以添加。可用入口和展示方式以当前系统与应用界面为准。
怎么设：按系统实际提供的方式添加后，核对显示的连接状态与目标操作。首次使用时回到 Home 检查一次，确认快捷操作影响的是预期连接，而不是仅凭组件上的文字判断已切换成功。
注意什么：组件提供便利入口，不改变服务器参数和规则内容。若入口未出现，先检查系统支持情况与组件设置，不要为了显示组件而同时修改 DNS、订阅和 Config。
iCloud：同步与独立备份分开处理
是什么、在哪里：iCloud 相关选项用于在系统账号与云服务可用的条件下同步应用支持的内容。在 Settings 查看相关开关，同时核对系统中的 iCloud 权限及可用空间。实际同步范围以应用内说明为准。
怎么设：换机前先在旧设备确认同步状态，并另行保存重要 Config 与已有订阅信息。新设备从 App Store 恢复应用后，再检查同步内容是否齐全，逐项验证服务器、配置与规则，而不是仅凭列表出现就删除旧设备数据。
注意什么：同步不是独立的历史快照，某端的修改或删除可能影响其他设备。购买记录、系统 VPN 配置授权与应用内配置也不是同一类数据；完成同步后，仍可能需要在新设备确认系统授权。
07 / 诊断与复测
Diagnostics：按证据缩小问题范围
先复现一次，再查看对应时间的记录。把连接、解析、规则与服务器参数分开核对，比同时改动多项更容易定位问题。
是什么、在哪里：Diagnostics 是用于检查连接状态与相关记录的诊断入口，可从 Settings 中查找。实际可用的日志与工具以当前界面为准。诊断记录是辅助信息，需要与发生问题时的网络、Global Routing 和当前配置一起解读。
怎么用：先记下失败目标、发生时间和错误提示，再重复一次最小操作。查看相应记录，判断问题发生在 DNS、连接建立、认证还是后续请求阶段。若只有 Config 模式失败，重点查看规则与策略；若同一服务器在 Proxy 下也失败，优先核对服务器字段和测试条件。
注意什么：日志中可能含有订阅地址、服务器地址、访问域名和认证相关信息。对外提供记录前，先移除访问凭据及个人信息，只保留定位所需的时间、错误类型与已核对事项。不要为了排查普通连接错误随意降低 TLS 验证要求。