DNS：先区分解析与连接
是什么、在哪里：DNS 把域名解析为地址。检查时既要看 Settings 中与 DNS 有关的选项，也要查看当前 Config 是否包含 DNS 设置；不能只看一处就推断最终行为。
怎么设、注意什么：先记录现有值，再核对解析方式及所填服务器是否能从当前网络访问。出现“测试有响应、网页打不开”时，分别检查域名是否能解析、解析地址是否合理、解析请求本身采用什么路径。不要同时更换解析方式、规则和服务器；先恢复已知可用的设置，逐项比较。更多步骤见DNS 解析失败排查。
官方手册 · 功能与设置
Shadowrocket 功能介绍
与常用设置
先确定流量按什么方式处理，再检查规则、服务器与连接条件。设置是否合适，应以实际请求的匹配结果为依据，而不是只看连接开关。
- 路由选择 Global Routing
- 请求记录 Data
- 连接条件 On Demand
本篇以 iPhone / iPad 上的操作为主。界面入口和可选项以设备上显示的英文名称为准；系统要求以 App Store 页面标注为准。
流量处理入口
Global Routing 三种姿态
Config、Proxy、Direct 决定当前采用哪一种总体处理方式。配置文件里有规则，并不意味着当前流量一定按规则走。
是什么：Global Routing 是路由方式选择入口。Config 使用当前启用的配置规则；Proxy 将需要由客户端处理的流量交给所选代理策略；Direct 采用直连方式。这里的 Proxy、Direct 是界面选项，规则行中的 PROXY、DIRECT 则是策略关键字，两者的作用层级不同。
在哪里、怎么设：在 Home 找到 Global Routing，进入后选择一种姿态，再返回确认当前服务器及连接状态。初次使用时，先确认已有服务器能连接；准备日常分流时，再切到 Config 并核对 Config 页面当前启用的文件。不要仅导入一个文件就假定它已经生效。
| 界面选项 | 处理依据 | 适用情形 | 检查重点 |
|---|---|---|---|
| Config（配置） | 当前配置中的规则及对应策略 | 需要按域名、地址等条件分流的日常使用 | 文件是否启用、规则顺序与最终命中策略 |
| Proxy（代理） | 当前选择的代理服务器或策略 | 临时排查代理路径，减少分流规则的干扰 | 服务器参数、认证信息与目标请求的连通性 |
| Direct（直连） | 当前网络的直接连接路径 | 比较原始网络表现，检查本地网络是否可用 | 本地网络与 DNS，不能用来验证代理可用性 |
注意什么：切换姿态后，已建立的长连接可能仍保留原先的连接状态。验证时应重新发起请求，必要时关闭并重新打开测试应用。Proxy 适合做对照测试，但不能据此认定 Config 中每一条规则都正确；Direct 下访问正常，也只能说明当前直连路径在该次测试中可用。
条件与策略分开理解
规则分流与匹配顺序
规则先描述“匹配什么”，再指定“怎样处理”。使用 Config 时，顺序与策略名称都需要检查。
是什么：规则分流根据请求的域名、目标地址等信息选择处理策略。DOMAIN 匹配指定域名，DOMAIN-SUFFIX 匹配域名后缀，DOMAIN-KEYWORD 检查域名中的关键词；IP-CIDR 与 IP-CIDR6 用于地址网段，GEOIP 根据地址归属数据判断。不同规则依赖的信息不同，域名解析结果也可能影响地址类规则的匹配。
在哪里、怎么设：在 Config 进入当前配置的编辑入口，检查 [Rule] 段。通常把更具体的条件放在前面，把默认处理规则放在后面。DIRECT 表示直连，PROXY 表示交给代理策略，REJECT 表示拒绝；若使用自定义策略名称，还要确认该名称在当前配置中有效。
规则语法示例 · 不是完整配置文件
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY示例先匹配指定域名后缀，再处理一个局域网地址段；前序规则都未命中时，由 FINAL 决定后续处理。
注意什么：规则按顺序检查，前面的宽泛条件可能遮住后面的具体条件。FINAL 用于前序规则未命中的情况，不宜放在还需要继续匹配的规则之前。USER-AGENT 等条件也取决于客户端能够取得的请求信息，不能假定它适用于所有流量。调整后到 Data 查看实际命中结果，比只阅读规则文本更容易发现顺序问题。
配置包含 DNS、Host 或其他段落时，应一起理解它们对请求的影响。不要为解决单个网页问题一次替换整套配置；先备份当前文件，只修改相关规则，再发起同一个目标请求进行对照。
连接资料与配置文件
订阅与服务器管理
服务器记录负责连接参数，配置文件负责规则等行为。订阅更新与配置切换是两件不同的操作。
是什么：服务器记录保存地址、端口、协议、认证及相关连接参数；Subscribe 用于管理用户已有的订阅。Shadowrocket 支持多种协议，例如 Shadowsocks、VMess、VLESS、Trojan、WireGuard、Hysteria2，以及 HTTP、SOCKS5。协议名称只是字段的一部分，同一协议下的传输、TLS 和认证设置也必须与已有服务器信息一致。
在哪里、怎么设：从 Home 的添加入口进入 Add Server。已有订阅时选择 Subscribe，填写自己的订阅地址及便于辨认的备注；只有单个服务器资料时，选择对应协议并逐项录入。已有二维码可使用 Scan QR Code；从剪贴板导入前，应确认其中的内容确实是准备添加的连接资料。
导入后先看列表里是否出现预期条目，再检查协议、地址、端口和必要的安全设置。随后选择一个条目进行 Connectivity Test，并发起实际请求。测试有响应只说明相应测试条件下有结果，不等于认证、DNS、规则和目标服务全部正常。
注意什么：订阅更新可能调整服务器名称、数量或参数，手动改过的订阅条目也可能被后续内容覆盖。建议把手动记录与订阅分开命名，更新前保留必要备份，更新后重新检查当前选择。不要把失败的订阅地址、二维码或完整连接链接公开到截图和讨论中，其中可能含有访问凭据。
订阅与规则配置应分别核对：服务器列表更新，并不必然改变 Config 中的规则；切换 Config，也不等于已经刷新服务器资料。多订阅整理、分享、备份及删除步骤见订阅与服务器管理手册。
按网络条件管理连接
On Demand 按需连接
On Demand 控制何时尝试建立连接，Global Routing 控制连接后如何处理流量。两者不能互相替代。
是什么：On Demand 根据设置的网络条件配合系统触发连接，可用于减少在不同网络间切换时的手动操作。它不是服务器可用性的保证，也不是一套分流规则；连接被触发以后，请求仍按当前 Global Routing 和配置处理。
在哪里、怎么设：进入 Settings 中的 On Demand，先阅读设备当前提供的条件选项。初次设置宜只启用一个容易验证的场景，例如针对当前 Wi-Fi 环境配置连接行为。保存后离开设置页，实际切换一次网络，再检查系统连接状态与 Shadowrocket 的当前状态，确认行为符合预期后再增加条件。
注意什么：启用 On Demand 后，系统可能在条件满足时重新触发连接，因此手动断开后再次出现连接状态，不一定是开关失效。排查这类现象时先检查 On Demand 条件。需要临时停用自动连接时，应调整按需条件，并在切换 Wi-Fi 或蜂窝网络后复核；不要只观察一次手动关闭的结果。
测试环境中如果存在其他网络配置，先记录当前状态，再逐项排除干扰。每次只改变一个条件，保留可回退的设置，才能判断变化来自 On Demand、本地网络还是服务器连接。
从结果回看设置
Data 流量统计与请求记录
Data 用于观察客户端处理的连接与流量。判断故障时，目标请求的详情通常比累计数字更有用。
是什么：Data 提供流量及连接记录等观察入口，可用于核对请求目标、处理策略和相关连接信息。它反映的是客户端可记录到的数据，不能直接当作服务商账单，也不能仅凭一个汇总数字判断某个应用的全部网络活动。
在哪里、怎么设：打开 Data，先查看当前可用的统计范围与记录入口。需要验证规则时，先记下测试时间，再只打开一个目标页面；返回 Data 找到对应请求，查看目标域名或地址及显示的策略信息。若要比较两种 Global Routing 姿态，分别重新发起请求，并保留各自结果，避免把旧记录当成新测试。
注意什么：一个页面可能同时访问多个域名，同一应用也可能保留后台连接。只看到主域名使用 PROXY，不能据此认定页面中的所有资源都走同一条路径。统计周期、记录保留范围和缓存也会影响观察结果，清理前先确认是否还需要这些排查信息。
需要分享记录时，只保留与问题相关的条目，并遮盖订阅地址、认证字段及其他个人信息。排查描述应包含使用的姿态、网络类型、测试目标与发生步骤，而不是直接公开完整配置。
常用项逐项检查
Settings 与诊断工具
以下功能按用途分别设置。若某个入口在当前设备上未显示，应以设备上的实际界面为准，不套用其他环境的开关状态。
Test Method：统一测试口径
是什么、在哪里：Test Method 决定相关连通性测试采用的方法，在 Settings 中检查当前选择。不同方法触及的网络环节不同，显示的结果也不能直接混为一谈。
怎么设、注意什么：比较服务器前先使用同一种 Test Method，并保持相同本地网络。若所选方式需要测试目标，再核对目标设置。某种方法失败可能与目标或协议响应有关，不必立即删除服务器；某次测试较快也不等于大文件传输更快。最终仍需通过真实请求确认用途是否满足。
Today Widget：检查状态再操作
是什么、在哪里：Today Widget 提供系统小组件相关的快捷操作或状态展示设置，可从 Settings 中对应入口检查。系统允许的展示位置与交互方式，以当前设备实际可添加的组件为准。
怎么设、注意什么：先在应用内完成服务器选择和首次连接确认，再到系统的小组件管理入口添加可用组件。操作后返回 Home 核对实际连接状态。若显示未及时刷新，不要仅凭组件外观判断已经断开或连接成功，也不必反复切换造成测试状态混乱。
iCloud：同步前先保留副本
是什么、在哪里：iCloud 相关选项用于设备间的数据保存或同步。进入 Settings 中对应入口，阅读当前版本显示的对象与操作说明，区分同步、导入和恢复各自处理的内容。
怎么设、注意什么：先确认设备的 iCloud 状态，再备份当前需要保留的配置和记录，最后启用或执行相应操作。在另一台设备上检查结果时，逐项确认 Config 与服务器资料，不假定所有内容都已完整同步。同步也不等于购买记录恢复，应用获取仍通过 App Store；覆盖或删除前应确认操作影响范围。
Diagnostics：按层定位故障
是什么、在哪里：Diagnostics 是诊断相关入口，在 Settings 中查看设备当前提供的工具及输出。诊断用于收集线索，不会代替对服务器参数与配置文件的核对。
怎么设、注意什么：先用最少步骤复现问题，再运行与故障相关的检查，按本地网络、DNS、服务器连接、规则匹配和目标响应依次判断。记录失败发生在哪一层，不要只保留最后一句错误提示。导出前检查内容是否含有凭据或个人信息，并保留修改前后的结果用于对照。
设置完成后的验证
一次只改变一个条件
把“是否连接”“是否解析”“是否命中规则”“目标是否响应”分开检查，避免用一次测试结果替代整条路径的判断。
- 确认资料。在 Home 核对已选服务器，确认地址、端口、协议及认证字段与自己的资料一致；使用订阅时，先检查最近一次更新是否取得了预期条目。
- 确认姿态。检查 Global Routing 当前是 Config、Proxy 还是 Direct。需要验证分流时使用 Config，并在 Config 中确认启用的文件及规则顺序。
- 重建测试请求。使用一个明确的目标重新访问，避免沿用旧连接。记录当前本地网络与测试时间，不同时切换服务器、DNS 和规则。
- 查看结果。在 Data 核对请求目标与处理策略。若连接行为反复变化，再检查 On Demand；若域名解析异常，再沿 DNS 路径排查。
- 保留可回退状态。有效的修改应记录用途；未改善问题的修改应及时恢复。需要继续定位时，整理最小复现步骤及已遮盖敏感信息的诊断结果。
首次导入到连接验证的完整操作见入门指南；批量整理已有订阅、更新与备份见服务器管理。应用仅在 Apple 平台发行，唯一获取入口为 App Store；购买、兼容性和系统要求以 App Store 页面标注为准。