官方手册 · 功能介绍
Shadowrocket 功能与常用设置
先区分流量如何处理，再设置连接何时建立。本页按界面入口说明各项功能，并给出调整顺序和检查方法。
- Global Routing
- 规则与策略
- On Demand
- Data 与 Diagnostics
操作以 iPhone、iPad 上的 Shadowrocket 为主，并以用户已有自己的订阅或服务器信息为前提。系统要求以 App Store 页面标注为准。尚未完成首次连接时，先阅读教程，再按本页逐项调整。
流量处理入口
Global Routing：Config、Proxy、Direct
Global Routing 决定由 Shadowrocket 接管的连接采用什么处理方式。它与连接开关不是同一个设置：开关用于建立或结束连接，Global Routing 用于选择处理姿态。先在 Home 找到 Global Routing，再根据目标选择 Config、Proxy 或 Direct。
配置姿态 Config 依据当前配置文件中的规则分配策略，适合日常按域名或地址分流。代理姿态 Proxy 适合临时检查所选服务器的访问能力。直连姿态 Direct 适合检查不经代理服务器的访问表现。后两者用于对照时，应保持目标网站与测试网络一致。
| 界面词与姿态 | 处理依据 | 适用场景 | 检查重点 |
|---|---|---|---|
| Config · 配置 | 按当前配置的规则选择策略。 | 需要同时使用 DIRECT、PROXY 等策略的日常连接。 | 确认启用的配置文件、规则顺序和最终策略。 |
| Proxy · 代理 | 由代理姿态处理接管的连接。 | 临时验证所选服务器是否能够访问目标。 | 确认默认服务器、服务器参数和测试目标。 |
| Direct · 直连 | 由直连姿态处理接管的连接。 | 检查本地网络或对照代理路径。 | 仍需检查解析环境；它不等同于关闭连接开关。 |
设置与恢复
打开 Global Routing 后选择目标姿态，返回 Home 核对当前值，再进行一次相同目标的访问测试。若 Proxy 可用而 Config 不符合预期，优先检查规则和策略绑定，不要立即重新导入全部服务器。临时测试结束后恢复原姿态，避免把诊断状态留作日常设置。
切换姿态时，已经建立的连接可能继续使用原来的路径。重新发起目标请求后再判断结果。需要重新连接时，应先保存正在进行的工作，避免中断传输。
匹配条件与执行结果
规则分流：规则类型与策略
规则描述哪些连接符合条件，策略决定命中后如何处理。进入 Config，确认当前使用的配置文件，再查看或编辑其中的规则。只有弄清当前配置，才能解释为什么一条访问被分配到 DIRECT、PROXY 或 REJECT。
常见规则按配置中的先后顺序匹配。更具体的条件通常放在更宽泛的条件前面，FINAL 放在末尾作为最终处理。修改前保留原配置，每次只改一组相关规则，再观察目标请求的匹配结果。
| 规则类型 | 匹配内容 | 使用注意 |
|---|---|---|
DOMAIN | 指定的完整域名。 | 适合范围明确的单个域名。 |
DOMAIN-SUFFIX | 域名本身及其子域名。 | 覆盖范围比单个 DOMAIN 更广。 |
DOMAIN-KEYWORD | 域名中包含的关键词。 | 容易扩大匹配范围，修改后检查误匹配。 |
GEOIP | 目标 IP 的地理归属分类。 | 结果与解析出的地址及使用的数据有关。 |
IP-CIDR / IP-CIDR6 | IPv4 / IPv6 地址段。 | 核对地址族与前缀长度。 |
FINAL | 前面规则均未命中的连接。 | 需要明确指定最终策略。 |
策略与规则片段
DIRECT 表示直连处理，PROXY 表示代理处理，REJECT 表示拒绝连接。若配置使用命名策略组，还要检查组内当前选项。规则指向了 PROXY，并不能单独证明默认服务器已经选对。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY这段文本仅解释规则结构：example.com 及其子域名先匹配第一条，随后检查 GEOIP，剩余连接交给 FINAL。它不是适合所有网络的完整配置。域名访问可能同时请求多个资源，排查时应查看实际请求域名，而不是仅依据浏览器地址栏判断。
已有信息的导入与整理
订阅与服务器管理
服务器条目保存连接到远端所需的参数，Subscribe 用于通过已有订阅链接维护一组条目。常用入口位于 Home 的添加流程。手动填写时进入 Add Server，先选择正确的 Type，再依据自己的服务器资料填写地址、端口和认证信息。
导入后先核对，再连接
已有订阅可通过 Subscribe 导入；已有二维码可使用 Scan QR Code。剪贴板导入前，应确认复制的是完整信息，而不是说明文字或被截断的地址。导入成功只表示客户端能够读取内容，不代表服务器当前可连接，也不代表其中每条记录都适合当前网络。
返回 Home 后检查条目名称和协议类型，选中计划使用的服务器，再运行 Connectivity Test。手动条目应逐项核对端口、认证字段以及资料中要求的 TLS 或传输参数。不要把不同协议的字段凭名称相似而互相套用。
更新、整理与备份
订阅更新用于重新获取远端提供的内容。更新可能增加、移除或重写条目，因此不宜把重要的手动修改只保存在订阅生成的记录里。管理多个订阅时使用能够辨认用途的名称，并在清理前确认默认服务器是否属于即将移除的分组。
延迟测试适合做当前环境下的初步筛选，不是速度或稳定性的永久排名。删除条目或配置前，先按应用提供的导出、备份能力保留必要信息。备份可能包含认证资料，应限制访问范围。完整操作见服务器管理手册。
连接触发条件
On Demand 按需连接
On Demand 根据条件决定何时触发连接。它解决的是连接时机问题，不代替 Global Routing，也不代替 Config 中的分流规则。先确认手动连接与目标访问正常，再进入 Settings 中的 On Demand 相关入口设置条件。
从单一场景开始设置
先记录希望在哪一种网络环境下连接，再依据界面提供的 Wi-Fi、蜂窝网络或域名条件建立规则。需要按 Wi-Fi 名称区分时，应核对网络名称的完整写法。只创建一条能够明确验证的条件，保存后切换到对应网络，观察系统连接状态和实际访问结果。
若准备添加第二条条件，先检查它与已有条件是否重叠。网络切换、设备休眠后恢复，以及应用重新发起请求，都可能让观察结果与单次手动操作不同。不要只看一次状态变化就判断条件有效。
注意持续触发与停止方式
启用 On Demand 后，手动结束连接可能在条件再次满足时重新触发。需要暂停自动连接时，应先检查 On Demand 状态，而不是反复切换 Home 开关。排查失败时，先暂时停用按需条件，恢复手动连接作为对照，再逐项恢复条件。
按需连接会影响后台网络行为。测试期间保留原条件记录，确认预期与实际一致后再长期使用。场景说明见On Demand 设置说明。
观察流量变化
Data 流量统计
Data 用于查看应用记录的流量信息。进入 Data 后，先确认当前展示的统计范围与时间口径，再比较上传、下载及相关分类。它适合回答“测试期间是否产生了流量”，不适合单独回答“目标访问是否成功”。
固定条件再比较
开始测试前记录当前统计值，暂时减少其他应用的后台活动，然后只执行一个明确操作，例如重新载入目标页面。完成后返回 Data 查看变化。若界面提供重置操作，执行前确认是否需要保留旧记录，因为清除统计不会同时修复连接问题。
后台同步、图片加载和失败重试都可能产生流量。数字增加不等于全部内容加载完成，数字很小也不等于规则没有生效。应将统计变化与访问结果、连接记录和测试时间一起判断。
与计费口径分开理解
Data 的记录范围可能与系统或你的服务商不同。协议开销、统计周期与连接覆盖范围都会影响对照结果。它是客户端观察工具，不应直接当作账单依据。需要检查异常消耗时，先限定时间段，再识别具体活动，避免根据累计总量推断单次连接的表现。
常用项逐项说明
Settings：解析、测试与辅助工具
Settings 集中提供连接相关选项与辅助功能。部分网络行为还受当前 Config 影响。更改前先确认设置来自全局选项还是配置文件，并记录原值。界面可用项以设备上实际显示为准。
DNS：域名解析
DNS 将域名解析为连接所需的地址。在 Settings 检查 DNS 相关选项，同时核对当前配置的 DNS 段，避免只改一处便认为所有请求都使用了新值。选择系统解析、自定义解析或 DNS over HTTPS 时，应依据当前网络需求，而不是把某一种方式当作必然更快的选项。
设置时一次只调整一个解析来源或相关选项，保存后重新发起同一域名的访问。若服务器测试通过但域名访问异常，优先核对解析结果、解析路径与域名规则。详细选择方法见Shadowrocket DNS 设置说明。
Test Method：测试方式
Test Method 决定相关连通性或延迟测试采用的方式。在 Settings 查看当前值，再执行 Home 中对应的测试。选择方法时，应考虑自己的服务器和当前网络是否支持该测试所依赖的连接方式。
比较多个条目时保持 Test Method 与网络环境一致。某种测试失败，可能是测试目标或测试方式受限，不应直接等同于所有实际访问均不可用。测试显示的耗时也不等于文件下载速度，应继续验证实际目标。
Today Widget：快捷入口
Today Widget 用于在系统提供的小组件入口中查看信息或执行快捷操作。先在 Settings 检查 Today Widget 相关选项，再按设备系统提供的方式添加可用组件。实际展示内容和可执行操作取决于设备上的支持情况。
设置完成后，回到 Home 核对默认服务器与当前状态，再尝试快捷操作。快捷入口减少操作步骤，但不能代替首次配置，也不能证明当前规则已经命中。若组件信息未及时变化，应打开应用确认实际状态。
iCloud 同步：跨设备保留设置
iCloud 同步用于在支持的范围内同步应用数据。先确认设备已登录自己的 iCloud 账户，并允许 Shadowrocket 使用相关能力，再检查 Settings 中的同步选项。应以界面说明确认同步内容，不要假设所有条目、统计与凭据都会完整迁移。
首次启用前分别保留两台设备的重要配置。同步后检查配置名称、默认服务器和连接结果，不要立即删除原设备的数据。同步不是独立备份；需要恢复误修改时，应有事先保存的配置副本。
Diagnostics：诊断信息
Diagnostics 用于检查网络相关状态并收集排查线索。在 Settings 的相关入口打开诊断工具，先明确要验证的是解析、服务器连接还是规则结果，再运行界面提供的对应检查。诊断前记下网络类型、当前姿态和所选服务器，便于重现同一条件。
诊断结论需要与实际请求交叉核对。分享记录前检查是否包含订阅地址、认证信息、设备信息或访问域名，只保留必要片段。不要为排查问题而直接公开整份配置或完整订阅内容。
从已知状态定位变化
功能设置的检查顺序
多个选项同时改变后，失败原因很难定位。先建立能够重复的基准，再逐项加入规则、解析和按需条件。每一步记录改动内容与测试结果，通常比反复清空配置更有效。
- 确认服务器信息。在 Home 核对已选条目，检查已有资料是否完整，运行 Connectivity Test，并验证一次实际访问。
- 确认 Global Routing。记录当前姿态。需要对照时临时切换 Proxy 或 Direct，使用相同目标重新发起请求。
- 确认 Config。检查启用的文件、规则顺序、策略指向与 FINAL，避免编辑了未启用的副本。
- 确认 DNS。核对解析相关选项与配置内容。只修改一个变量，观察目标域名的新请求。
- 最后恢复 On Demand。手动连接稳定后再启用自动条件，并测试网络切换。结合 Data 与 Diagnostics 判断结果。