OFFICIAL MANUAL / SETTINGS
先确定流量应如何处理，再调整自动连接与辅助工具。本篇以 iPhone 与 iPad 上的 Shadowrocket 为对象，按“是什么、在哪里、怎么设、注意什么”说明常用功能。
开始前请准备用户已有的订阅或服务器信息。界面项目的位置与可用选项可能随应用更新而变化，请以设备中实际显示的英文名称为准；系统要求以 App Store 页面标注为准。
ROUTING / HOME
Global Routing 决定当前流量的总体处理方式。它与具体服务器的选择是两件事：选好了服务器，不代表所有请求都会经过该服务器。
在 Home 找到 Global Routing，打开后选择 Config、Proxy 或 Direct。中文说明中的“配置、代理、直连”分别对应这三个界面词。日常需要按域名或地址区分处理时，通常使用 Config；临时判断问题是否来自规则时，可切换 Proxy 或 Direct 做对照，然后恢复原来的模式。
切换前记下当前模式、所选服务器与启用的配置文件。Proxy 仍以服务器参数及网络可用为前提，Direct 则不等于一定能访问所有目标。三种模式描述的是路由意图，不能当作连接成功的保证。
| 模式 | 主要作用 | 适用情况 | 需要注意 |
|---|---|---|---|
| Config · 配置 | 按当前启用配置中的规则与策略处理请求。 | 日常规则分流，区分需要代理、直连或拒绝的请求。 | 编辑文件之后还要确认该文件已启用，并核对规则顺序。 |
| Proxy · 代理 | 以代理方式处理流量，仍需考虑系统及配置中的绕过行为。 | 临时确认服务器是否可用，帮助区分规则问题与连接问题。 | 不要据此断言设备上的每一个请求都经过代理；测试后恢复日常模式。 |
| Direct · 直连 | 以直接连接方式处理流量。 | 核对本地网络、目标服务与代理路径之间的差异。 | 不能代替断开 VPN；需要完全停止客户端连接时，应关闭连接开关。 |
CONFIG / RULE
规则用来回答“这个请求应该怎样处理”。在 Config 中打开当前配置，核对规则内容与排列顺序；使用规则分流前，先把 Global Routing 设为 Config。规则通常按从上到下的顺序匹配，命中后采用对应策略，因此更具体的条件应放在更宽泛的条件之前，FINAL 放在列表末尾处理未命中的请求。
DOMAIN 匹配指定域名；DOMAIN-SUFFIX 匹配域名后缀及其子域名；DOMAIN-KEYWORD 按域名中的关键字匹配。IP-CIDR 与 IP-CIDR6 分别描述 IPv4 和 IPv6 地址范围，GEOIP 基于地址归属数据匹配。USER-AGENT 依赖能够获取的请求信息，并不适合所有流量，不能把它当作通用的应用识别方法。
策略与规则类型需要分开理解：PROXY 表示走代理策略，DIRECT 表示直接连接，REJECT 表示拒绝请求。拒绝规则可能影响页面资源、登录或通知；新增规则后应验证相关功能，而不是只确认首页能否打开。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT以上为语法示例，不是完整配置文件。第一条会先匹配 example.com 及其子域名，因此这些请求不会继续交给后面的 DOMAIN-KEYWORD 规则判断。FINAL,DIRECT 只表示其余请求直连，并不是所有使用场景都应采用的默认答案。修改前保留原文件，每次只改一个条件，再结合连接记录确认实际命中情况。
HOME / SUBSCRIBE / ADD SERVER
订阅是批量维护服务器信息的来源，单个服务器条目则保存具体连接参数。导入成功只说明信息被客户端接收，不等于服务器已经可用。
在 Home 通过添加入口选择 Subscribe，填入用户已有的订阅地址，并设置便于辨认的名称。保存与更新后，回到 Home 检查是否出现预期的服务器分组和条目，再选择其中一个进行连接。若订阅无法解析，先核对链接是否完整、是否过期，以及返回内容是否为可识别的订阅数据。
订阅地址可能带有身份凭据，不应发到公开页面或完整写入求助截图。更新订阅可能覆盖来源管理的条目，需长期保留的个人修改应先单独备份，并与订阅来源区分。删除订阅分组前，确认其中是否包含仍要使用的信息。
在 Home 打开 Add Server，按照用户已有的服务器信息选择协议并填写地址、端口、认证与传输参数。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等协议使用的字段不同，不能只替换地址而沿用另一种协议的全部参数。
使用 Scan QR Code 导入时，也应检查识别后的协议与服务器地址。TLS、SNI、传输路径等字段以已有服务器资料为准，不要通过任意关闭验证来掩盖配置问题。保存之后选中该条目，先验证手动连接，再考虑规则分流或 On Demand。
AUTOMATION / ON DEMAND
On Demand 用于根据匹配条件让系统按需建立或处理 VPN 连接，不是另一套服务器配置。它控制何时触发连接，Global Routing 与 Config 则决定连接后的流量如何处理。先在手动模式确认服务器、DNS 与目标访问均正常，再到 Settings 查找 On Demand 相关入口。
根据界面提供的条件设置 Wi-Fi、蜂窝网络或域名相关规则。需要按 Wi-Fi 名称区分时，应准确核对 SSID；名称相似但不完全相同的网络不能视为同一条件。域名触发依赖系统的解析与按需机制，并不等同于某个页面一打开就必定重新连接，也不是对任意应用行为的监视。
保存后，在对应网络环境中测试触发、断开与再次触发。存在多条规则时，逐条检查条件、动作和显示顺序，避免宽泛条件先匹配，使后面的细分条件失去作用。若连接开关关闭后又自动恢复，先检查 On Demand，而不是反复删除服务器条目。
测试时先确认系统是否建立连接，再确认 Global Routing 的当前模式，最后看请求是否命中预期规则。切换 Wi-Fi 与蜂窝网络后，已有连接可能重建；某次切换中的短暂失败，不足以证明服务器参数错误。需要恢复纯手动排查时，先暂停 On Demand，再进行同一目标的重复测试。
OBSERVATION / DATA
Data 提供客户端可观察到的流量统计，用于了解连接期间的数据活动。在 Data 查看界面实际提供的汇总或明细，先确认统计对象、时间范围以及是否存在重置操作，再比较两次操作前后的变化。不要把某个统计值直接当作服务商的账单或剩余用量。
需要确认某个操作是否产生流量时，可先记录当前显示，再执行一次明确的操作，然后返回 Data 查看变化。后台同步、通知和其他应用也可能产生请求，所以“数值增加”不能单独证明某个域名走了 PROXY；路由判断仍要结合当前模式、规则和可用的连接记录。
如需清除统计，先保存仍要对照的信息，并确认清除的是统计数据而不是配置文件。客户端统计、系统流量统计与服务商侧计量可能因统计范围、连接封装、重传和重置时间不同而产生差异。订阅信息中展示的用量若由来源返回，也不应与 Data 的本地观察混为一谈。
PREFERENCES / SETTINGS
辅助设置不应同时大幅修改。先记录当前值，确认设置属于应用级偏好还是当前 Config，再按一次一项的方式验证。
DNS 负责把域名解析为地址，它与服务器连接是不同环节。DNS 相关行为可能同时涉及 Settings 中的选项和当前 Config 的配置内容；修改之前先确认真正生效的来源。在配置文件中，dns-server = system 表示使用系统 DNS，适合用来理解配置字段，并非所有环境的统一推荐值。
若域名访问失败，先区分解析失败、连接失败和目标服务响应异常。不要一次改动解析器、路由模式与服务器，否则难以确定原因。填写自定义解析服务时核对地址与传输格式，并检查它在当前网络下是否可达；解析结果正常也不代表后续连接必定正常。
在 Settings 找到 Test Method，核对所选测试方法与相关目标，然后再运行 Connectivity Test。不同测试方法观察的是不同环节；测试目标、网络环境、服务器负载以及 DNS 都可能影响结果。比较多个服务器时，应保持方法和目标一致，避免把不同条件下的结果直接排序。
测试通过只能说明该次测试所覆盖的链路得到响应，不代表所有网站、协议和应用都能正常使用。测试失败也可能源于测试目标自身不可达。最终应使用实际需要的目标验证，并结合错误信息判断，不以单次测试结果替代完整排查。
Today Widget 是系统组件相关的辅助入口，可用方式取决于设备系统与应用当前提供的支持。在 Settings 查看 Today Widget 对应选项，再到系统提供的组件添加界面确认是否可用。组件中展示的内容与操作能力应以设备实际界面为准，不应假定与主应用完全一致。
组件显示没有及时变化时，先打开 Shadowrocket 核对真实连接状态，再检查系统刷新与组件设置。组件不能代替首次 VPN 配置授权，也不能作为判断流量策略的唯一依据。更改服务器或配置之后，仍应回到 Home 与 Config 确认最终选择。
在 Settings 检查 iCloud 相关同步选项，同时确认系统已登录自己的 Apple 账户，并允许应用使用相关 iCloud 功能。开启前先阅读界面说明，确认同步对象与执行方式；不要假定应用内全部数据、系统授权和每项偏好都会以同一种方式同步。
首次在另一台设备使用时，先保留本地现有配置，再检查云端内容，避免在未确认内容的情况下执行覆盖操作。同步完成后逐项核对服务器、Config 与连接状态。App Store 已购应用的重新下载、iCloud 数据同步与 VPN 配置授权是不同流程，不能互相替代。
TROUBLESHOOTING / DIAGNOSTICS
Diagnostics 用于收集或查看排查所需的信息。在 Settings 找到 Diagnostics 相关入口，按界面提供的检查项目观察结果。它帮助缩小问题范围，不会替用户补齐服务器参数，也不能把来源失效的订阅自动恢复为有效内容。
诊断记录、配置和截图可能包含访问域名、服务器地址、订阅凭据或其他个人信息。分享前应移除认证内容与不相关记录，只保留复现问题必需的部分。不要公开完整订阅地址，也不要为了展示一个错误而提交整份个人配置。
完成排查后，恢复日常使用的 Global Routing、Config 与 On Demand 设置，并再次验证常用目标。需要逐步完成首次导入与连接，可继续阅读使用教程；需要核对正版购买、商店地区与已购恢复，可阅读正版指南。Shadowrocket 的唯一获取入口是 App Store，应用兼容性与系统要求以 App Store 页面标注为准。