官方手册 / 功能介绍

Shadowrocket 功能与设置

先确定 Global Routing，再检查 Config 与服务器信息。分流、按需连接和诊断分别解决不同问题，应分开设置、逐项验证。

  • Global Routing
  • Config
  • On Demand
  • Data
  • Settings

适用于 iPhone 与 iPad 的操作理解；具体界面位置与可用选项以设备上实际显示为准。

01 / 路由入口

三种 Global Routing 姿态

Config、Proxy、Direct 决定连接使用哪一套路由逻辑，不等于三台不同的服务器。

是什么：Global Routing 是整体路由方式的入口。配置对应 Config，按当前配置中的规则决定请求去向；代理对应 Proxy，把适用流量交给所选代理服务器；直连对应 Direct，不通过所选代理服务器转发。讨论“规则是否生效”之前，先确认这里是否处于 Config。

在哪个界面、怎么设：在 Home 打开 Global Routing，选择需要的姿态，再返回确认当前显示。已有分流配置时先用 Config；需要单独验证所选服务器能否承担目标请求时，可以临时用 Proxy；需要对照当前网络直接访问的结果时，可以临时用 Direct。每次只改变这一项，保留其他条件，结果才有比较意义。

Global Routing 常用姿态对照
界面词 / 中文处理方式适用时机检查重点
Config / 配置按当前 Config 的规则与策略处理请求。日常按域名、IP 等条件分流。启用的配置、规则顺序与策略引用。
Proxy / 代理适用流量经所选代理服务器转发。临时验证服务器与目标访问路径。当前选择的服务器及其参数。
Direct / 直连不经所选代理服务器转发。核对本地网络的直接访问结果。当前网络、DNS 与目标服务状态。

注意什么：Proxy 不会修复填错的认证参数，Direct 也不是对所有网络问题的通用解决方法。切换姿态后，已有长连接可能继续沿用之前的路径，验证时应重新发起请求。若只是临时排查，完成后回到原先使用的 Config，避免把测试状态误当成日常分流状态。

02 / 匹配与处理

规则类型与策略

规则负责判断请求是否匹配，策略负责决定匹配之后如何处理。

是什么：规则分流把请求特征与条件逐项比较。DOMAIN 用于完整域名，DOMAIN-SUFFIX 用于域名及其子域名后缀，DOMAIN-KEYWORD 用于域名关键词；IP-CIDR、IP-CIDR6 分别表达 IPv4、IPv6 网段，GEOIP 按 IP 地理归属条件匹配。规则类型不是服务器协议，不需要把 VLESS 或 Trojan 这样的协议名填到规则类型的位置。

在哪个界面、怎么设：进入 Config，先确认启用的是哪份配置，再查看其中的规则内容。具体条件通常应放在宽泛条件之前，FINAL 用来处理此前没有命中的请求。常见处理策略包括 DIRECT、PROXY、REJECT，也可能引用配置中已有的策略组名称。引用策略组时，名称必须与配置中的定义一致。

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

这段片段仅说明语法：example.com 及其子域名指向 PROXY，指定的本地 IPv4 网段指向 DIRECT，其他未命中的请求由 FINAL,DIRECT 处理。它不是完整的通用配置，也不代表所有家庭或办公网络都应采用相同设置。编辑前保留原配置，并先明确最终兜底策略符合自己的需求。

注意什么：按顺序匹配时，放在前面的宽泛规则可能先接住请求，导致后面的精细规则无法命中。仅添加一行 DOMAIN-SUFFIX 并不足以证明分流已改变，还要核对 Global Routing 是否为 Config、配置是否已经应用，以及目标是否实际使用了另一个域名或 IPv6 地址。需要规则和设置的进一步说明时，可阅读设置详解。

03 / 连接资料

已有订阅与服务器管理

Subscribe 管理已有订阅的更新来源，Add Server 管理单条服务器信息，两者都不等于 Config 规则文件。

Subscribe：导入与更新

已有订阅包含可供客户端读取的服务器资料。通常在 Home 通过添加入口进入 Add Server，选择 Subscribe，并填写你已有的订阅地址；保存后返回列表检查是否读出了服务器。具体入口以当前界面为准。

更新订阅会重新读取来源内容。更新后要再次确认所选服务器是否仍然存在，以及配置里的策略组是否还能匹配预期条目。列表出现名称并不代表认证成功，也不代表每条服务器都可用。

Add Server：逐项填写

手动添加时，先选择与你已有服务器资料一致的协议，再填写 Address、Port 及该协议要求的认证、传输和 TLS 参数。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的参数结构不同，不能只换协议名称而沿用其他字段。

从 Scan QR Code 导入后同样要核对内容，尤其是地址、端口与安全相关选项。备注名称便于辨认，但不会替代真正的服务器地址或认证字段。保存后返回 Home，明确选择需要使用的条目。

怎么设：先完成一种导入方式，不要同时手动新建与反复订阅更新，以免产生难以辨认的重复条目。可用清楚的备注区分不同用途；删除条目前，确认它是否仍被当前配置引用。若订阅更新失败，先核对地址是否完整、当前网络是否能访问来源，以及来源是否返回了客户端能够读取的内容。

注意什么：订阅地址、二维码、认证信息都应视为敏感资料，截图求助时需要遮去这些内容。客户端一次性买断 ≠ 线路套餐；应用购买只取得客户端使用资格，服务器信息与订阅由用户自行准备。本站不提供、不销售、不推荐节点或订阅。首次导入的完整操作顺序见快速上手。

04 / 连接触发条件

On Demand 按需连接

它管理何时触发连接，不替代 Global Routing，也不负责判断某个域名应当直连还是代理。

是什么、在哪个界面：On Demand 根据设定的网络条件管理连接行为，可在 Settings 的相关入口查看。它与 Config 的分工不同：On Demand 决定连接触发条件，Config 决定连接运行后如何分流。理解这一区别，才能避免把“网络切换后连接又出现”误判成规则文件的问题。

怎么设：先在手动连接状态下确认服务器、DNS 与分流均可使用，再配置 On Demand 中实际提供的网络条件。按你使用的 Wi-Fi 与蜂窝数据场景分别检查；涉及网络名称时，以设备当前识别的名称为准。保存后不要只看设置页，应实际切换网络，再检查连接状态是否符合预期。

注意什么：启用后，系统可能在符合条件时再次触发连接。临时排查断开行为时，应一并检查 On Demand，而不是只在 Home 关闭连接。需要撤回修改时，先关闭相应按需条件，再重新观察。不要依赖这一功能补救失效的服务器资料；触发成功与连接可用是两个独立结果。

05 / 使用观察

Data 流量统计

先确定统计范围与时间，再用上传、下载读数辅助理解实际使用情况。

是什么、在哪个界面：Data 汇总客户端可观察到的流量信息。进入 Data 后，先查看当前统计对象与可用视图；若界面提供按服务器或按应用查看，前者适合观察服务器使用分布，后者适合理解应用产生的流量。上传与下载是数据量，不是网络时延，也不直接代表线路质量。

怎么用：记下测试前的统计范围和读数，仅发起一次明确的访问，再返回观察变化。判断某条规则时，应把 Data 与当前 Global Routing、实际选择的服务器及连接记录一起看。设备后台同步也可能产生流量，不能把测试期间所有增加的数据都归到刚刚打开的页面。

注意什么：页面一次访问通常涉及多个域名与连接，因此服务器读数增加只能作为线索，不能独立证明每个请求都命中了同一策略。不同视图、不同统计周期以及可能的重置操作，会让两次读数失去直接可比性。Data 也不等于服务方的计费记录；若要解释差异，应先对齐统计起点与范围。

06 / 常用设置

Settings 检查要点

以下按用途说明，不预设所有设备具有相同初始值。设置的实际取值以当前应用与配置为准。

DNS：域名解析

是什么、在哪里：DNS 把域名解析为连接所需的地址。检查时既要看 Settings 的 DNS 相关设置，也要看当前 Config 是否包含相应配置；仅查看其中一处，可能无法解释实际解析行为。

怎么设、注意什么：先确认问题是域名解析失败还是连接失败，再核对解析地址、请求路径与当前网络可达性。不要一次替换多个选项。使用 IP 条件的规则时，解析得到的地址还会影响匹配结果；改动后应重新发起访问，并同时验证本地网络资源是否仍可访问。

Test Method：测试方式

是什么、在哪里：Settings 中的 Test Method 决定连接测试采用的方式，Connectivity Test 的读数应结合这一设置理解。不同测试方式验证的层面不同，不能把一类测试结果直接当成另一类网络能力的结论。

怎么设、注意什么：先记录当前方式，再按实际提供的选项选择，并在相同网络、相同服务器下重测。需要测试目标的方式，还要检查目标本身是否可达。连接测试通过不等于所有网站可访问；测试失败也需要区分是测试目标、认证、传输还是当前网络造成。

Today Widget：快捷查看与操作

是什么、在哪里：Today Widget 用于系统小组件相关的快捷显示与操作，可先在 Settings 查看对应选项，再到系统的小组件管理界面检查是否已经添加。实际可用形式取决于设备系统与应用提供的组件。

怎么设、注意什么：先在 Home 完成正常连接与服务器选择，再配置组件内容。组件适合日常快速操作，不适合替代完整的故障检查；看到的状态可能存在刷新间隔。若显示与预期不符，应回到应用核对 Global Routing、当前服务器与系统连接状态。

iCloud：配置同步

是什么、在哪里：iCloud 相关选项用于应用所支持数据的跨设备同步，可在 Settings 中核对同步入口，同时检查系统中该应用的 iCloud 使用权限。同步范围以界面实际说明为准，不应假设所有本地状态都会随设备迁移。

怎么设、注意什么：先保留重要配置，再开启需要的同步项，并等待另一台设备完成读取。两台设备不要同时修改同一份配置，以便辨认最终保留的内容。应用已购资格、订阅来源更新与 iCloud 配置同步是不同机制；同步完成后，仍需检查服务器选择、配置应用状态与本机系统授权。

Diagnostics：诊断资料

是什么、在哪里：Diagnostics 是收集和查看诊断信息的入口，可在 Settings 的相关项中检查。它用于缩小问题范围，不会自动修正服务器参数，也不能保证某个连接一定成功。

怎么用、注意什么：先记录问题发生的网络、Global Routing 姿态和操作步骤，再复现一次，查看对应时间附近的信息。分享资料前检查其中是否含订阅地址、服务器地址或认证内容，并做必要遮盖。排查结束后恢复日常日志设置，避免长期保留不必要的详细记录。

07 / 操作顺序

从配置到访问的验证顺序

一次只改变一个条件，让每次观察都有明确的对应对象。

  1. 先确认连接资料。检查已有订阅是否完成读取，或手动服务器的 Address、Port、认证与传输参数是否与原资料一致。名称相同不代表参数相同。
  2. 再确认路由姿态。日常规则分流使用 Config，并核对当前应用的配置。临时改用 Proxy 或 Direct 时，记录测试目的，完成后恢复原设置。
  3. 重新发起请求。关闭旧页面或旧连接后重试，结合 Data 与诊断资料观察。不要仅依据连接开关已打开或单次测试读数下结论。
  4. 最后启用自动行为。手动连接稳定后再设置 On Demand、小组件与同步，并实际验证网络切换和另一台设备上的结果。