域名类条件
DOMAIN 匹配完整域名；DOMAIN-SUFFIX 匹配指定域名及其子域名；DOMAIN-KEYWORD 检查域名是否包含指定字符串。后两种范围不同，不应只因名称相似就互换。
官方手册 · 功能与设置
Shadowrocket
功能与常用设置
从 Global Routing 确认流量处理方式，再检查规则、服务器与连接条件。本文以 iPhone、iPad 上用户已有的订阅或服务器信息为前提，按“用途、位置、设置、注意事项”说明操作。
- Config / Proxy / Direct
- 规则与策略
- On Demand
- DNS 与诊断
Shadowrocket 是 Apple 平台的付费商业应用，唯一获取入口为 App Store。系统要求以 App Store 页面标注为准。
流量处理入口
Global Routing：配置、代理与直连
是什么：Global Routing 决定客户端如何选择连接路径。配置、代理、直连分别对应界面中的 Config、Proxy、Direct。这三项是路由选择，不是三个服务器，也不代表服务器使用了哪一种协议。
在哪里：在 Home 打开 Global Routing 查看当前选项。这里的 Config 是路由模式；底部同名的 Config 页面用于管理配置文件。两者相关，但不是同一个入口。
| 界面选项 | 处理方式 | 适用操作 | 检查重点 |
|---|---|---|---|
| Config 配置 |
依据当前生效配置中的规则选择策略。 | 日常按域名、地址或地区条件分流。 | 确认选中的配置文件及规则顺序。 |
| Proxy 代理 |
将流量按代理模式交给所选代理处理。 | 临时对照规则分流与代理连接结果。 | 确认当前服务器可用，不据此推断每条规则是否正确。 |
| Direct 直连 |
按直连模式处理流量。 | 对照当前网络直接访问的结果。 | 直连结果不代表代理服务器的连接状态。 |
怎么设：已有完整分流配置时，先在 Config 页面确认使用的文件，再将 Global Routing 设为 Config。需要定位问题时，可以临时切换 Proxy 或 Direct，用同一个目标做对照，测试结束后恢复原设置。
注意什么：切换模式只改变路由处理方式，不会补齐服务器地址、认证信息或 DNS 参数。若某个网站在 Proxy 下可访问、在 Config 下失败，应继续查看规则命中与策略去向，而不是立即重新导入全部服务器。直连模式也不等于关闭系统中的 VPN 配置；需要断开连接时，应检查 Home 的连接开关。
配置文件与匹配逻辑
规则分流：匹配条件与处理策略
是什么：规则由匹配类型、匹配内容和策略组成。匹配条件回答“这条请求属于哪一类”，策略回答“命中后怎样处理”。PROXY 表示交给代理处理，DIRECT 表示直连，REJECT 表示拒绝。若配置引用了自定义策略名称，还需要确认对应策略的定义。
在哪里：进入 Config 页面检查当前配置文件，在规则编辑入口或文件的 [Rule] 段查看规则。需要让这些规则参与路由时，Global Routing 应使用 Config。
地址类条件
IP-CIDR 与 IP-CIDR6 分别描述 IPv4、IPv6 地址段；GEOIP 依据地址归属数据匹配。域名请求能否进入地址类匹配，还与解析结果及配置选项有关。
怎么设：先备份当前文件，再为目标增加范围明确的规则。把具体条件放在较宽条件之前，最后使用 FINAL 指定未被前面规则处理的请求去向。下面的 example.com 仅用于展示语法，不代表连接服务。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY注意什么：规则自上而下检查，命中后通常不再继续匹配后续规则。若将覆盖范围很大的条件提前，后面的具体规则可能不会生效。FINAL 是兜底规则，不是“再次尝试所有路径”。修改后应同时确认文件已保存、配置已选中，并用实际请求检查结果。更完整的匹配范围说明见规则关键字与匹配顺序。
连接参数管理
订阅与服务器：导入、更新和选择
是什么：单个服务器记录保存地址、端口、协议和认证等连接参数；订阅则用于读取并更新一组服务器记录。订阅管理与规则配置是两件事，导入服务器不等于已经设置好分流规则。
在哪里：Home 的 SERVER 区域用于查看与选择已有服务器。手动填写时使用 Add Server；导入已有订阅时，在添加入口选择 Subscribe。已有二维码可使用 Scan QR Code 读取，导入前仍应确认内容来自你已有的配置来源。
怎么设：手动添加时，先选择与服务器端一致的协议，再逐项填写地址、端口和认证字段。涉及 TLS、传输方式或其他附加参数时，应按已有服务器信息填写，不通过反复猜测参数来测试。订阅导入后，先检查是否出现预期分组，再选择一个服务器进行测试，最后才开启连接。
更新订阅前，区分哪些记录由订阅维护，哪些是手动添加。由订阅生成的记录可能随更新被替换或移除，直接修改这些记录前应保留必要信息。订阅名称相同，也不代表其中所有服务器拥有相同协议或相同参数。
注意什么：订阅地址可能包含访问凭据，不应粘贴到公开截图、公开文章或诊断留言中。导入失败时，先核对链接是否完整、是否含多余空格，再检查当前网络是否能够读取内容。导入成功仅说明客户端读到了记录，不等于每台服务器都能连接。
客户端一次性买断 ≠ 线路套餐。购买 Shadowrocket 获得的是客户端使用权，不包含连接服务。本站不提供、不销售、不推荐节点或订阅，操作说明以用户已有自己的订阅或服务器信息为前提。
连接触发条件
On Demand：按条件触发连接
是什么：On Demand 用于根据预设条件管理 VPN 连接触发。它处理“何时连接”的问题，Global Routing 与配置规则处理“连接后怎样路由”的问题。开启前者不会自动修正后者。
在哪里：在 Settings 中进入 On Demand，查看当前可设置的条件。具体可用条件与显示位置以应用内页面为准；设置过程中也可能需要检查系统中的 VPN 配置状态。
怎么设：先关闭自动触发影响，手动完成一次连接与访问验证，确认服务器和配置均可用。随后再设置所需的网络条件，每次只调整一项。切换到目标网络后，分别观察系统 VPN 状态、Home 连接状态和实际访问结果，确认触发行为符合预期。
注意什么：按需连接不是服务器故障修复功能，也不保证网络切换时所有已有会话连续保持。若手动断开后又出现连接，先检查 On Demand 条件及系统 VPN 设置，不要仅靠反复切换开关判断异常。诊断连接问题时，应先记录原条件，暂时排除自动触发因素，完成手动测试后再恢复。
使用记录与统计范围
Data：查看流量，不替代服务端记录
是什么：Data 展示客户端记录的流量使用情况，可用于观察某段使用过程中的上传、下载变化。它是排查线索，不是带宽测试，也不是服务端计费凭证。
在哪里：进入底部的 Data 页面，先确认当前显示的统计项目与时间范围，再读取数值。不要将不同统计口径、不同时间段或不同设备的结果直接相加比较。
怎么设：需要观察某项操作时，先记录当前统计与时间，再进行一段可重复的访问，随后回到 Data 对照变化。如果页面提供清除统计的操作，执行前先保存需要的记录；不要把清除统计误当作刷新服务器状态。
注意什么：后台应用、系统请求与连接重试也可能产生流量。客户端与服务端的统计范围、起止时间及协议开销计算可能不同，因此数字不一致不能直接说明其中一方出错。若要判断某条规则是否命中，应结合连接记录与目标请求，不应只根据流量增加推断路由策略。
Settings 常用项
DNS、测试方式、快捷入口与同步
Settings 集中放置应用设置及相关工具入口。部分行为也可能由当前配置文件控制，调整前应先区分应用设置与文件参数。下列项目以应用内实际可见选项为准，不要求一次性全部启用。
DNS：域名解析与路由配合
是什么、在哪里：DNS 将域名解析为地址，相关选项可在 Settings 的 DNS 入口检查；当前配置文件的 [General] 段也可能包含 DNS 参数。进入设置前，先记录正在使用的配置文件，避免忽略文件对解析行为的影响。
怎么设、注意什么：按照已有网络与配置要求填写解析参数，一次只改一项，再用相同域名复测。服务器测试有结果，但网页无法打开，仍可能是解析失败、解析结果不合适或后续连接失败。不要仅凭一次测试数值就更换所有 DNS 设置；先确认失败发生在解析阶段还是连接阶段，详见DNS 解析失败排查。
Test Method：明确测试测量什么
是什么、在哪里：Test Method 用于选择连通性测试所使用的方式，在 Settings 中检查。Home 的 Connectivity Test 用于触发测试。测试方式不同，覆盖的连接环节也可能不同。
怎么设、注意什么：比较服务器前，固定测试方式、测试目标和当前网络，再重复观察结果。不要将不同方式得到的数值混排为同一结论。测试成功不代表所有网站均可访问，测试时间也不等同于实际下载速度。若仅有测试失败而实际访问正常，应先检查测试目标和测试方式。
Today Widget：快捷操作入口
是什么、在哪里：Today Widget 用于查看或配置相关快捷展示与操作，在 Settings 中检查对应选项。是否能够添加到系统的相应位置，应以设备当前系统提供的组件入口为准。
怎么设、注意什么：先在应用内完成服务器选择与连接验证，再按系统提供的组件编辑方式添加入口。使用快捷操作后，回到 Home 核对实际状态。组件展示可能存在刷新间隔，不应把某一刻的文字直接当作完整连接诊断；组件也不会替你补齐尚未导入的服务器信息。
iCloud：确认同步对象与覆盖方向
是什么、在哪里：iCloud 相关功能用于在应用支持的范围内保存或同步数据，在 Settings 检查相关入口，同时确认系统允许 Shadowrocket 使用 iCloud。同步功能与 App Store 的已购恢复是不同机制。
怎么设、注意什么：先保留当前设备的重要配置，再阅读应用内对同步对象、上传或恢复操作的说明。另一台设备读取数据前，应核对当前内容与修改时间，避免把较早的数据覆盖到正在使用的配置上。应用购买记录不会自动补齐服务器认证信息；同步后仍需分别检查选中的服务器、配置文件和路由模式。
Diagnostics：围绕一次失败收集线索
是什么、在哪里：Diagnostics 是诊断相关工具入口，可在 Settings 中查找。它用于获取排查线索，不能仅凭一条结果判断所有连接环节均正常。
怎么设、注意什么：先记录失败目标、当前网络、路由模式和复现步骤，再运行相关诊断。保存与这次失败对应的结果，避免混入多次修改后的无关信息。分享记录前应检查并遮盖订阅地址中的访问凭据、密码、认证字段以及其他个人信息。诊断结果应与 DNS、服务器连接和规则命中分别对照，不能代替这些检查。
调整前后的核对清单
一次只改变一个变量
排查时先建立可重复的基准。记录当前使用的网络、所选服务器、配置文件与 Global Routing，再选择一个明确的目标进行访问。这样才能判断某次修改是否改变了结果，而不是把网络波动误认为设置生效。
- 检查参数完整性。确认服务器地址、端口、协议与认证信息来自你已有的配置，先排除漏填和复制错误。
- 检查连接与测试。手动连接后执行
Connectivity Test，同时记录Test Method，不要只保留一个孤立数值。 - 检查路由模式。使用
Config时核对当前文件与规则。临时使用其他模式作对照后，恢复原有设置。 - 检查解析环节。如果连接已建立但域名访问失败，分别核对 DNS 结果与后续连接，不把所有失败都归为服务器问题。
- 恢复自动功能。手动操作稳定后，再恢复
On Demand与快捷入口，观察网络切换后的状态。
涉及配置文件编辑时，先保留可恢复的副本。订阅更新、配置修改、DNS 调整和网络切换尽量分开进行。若一次同时改变多项设置，即使恢复访问，也很难确定真正起作用的是哪一项。
首次配置请按使用说明逐步完成；协议字段与选型见协议参考；购买、恢复与商店字段核对见App Store 正版核验说明。开发者为 Shadow Launch Technology Limited，应用 ID 为 932747118。