Shadowrocket 代理模式
Global Routing 与常用设置

Global Routing：配置、代理、直连

是什么：Global Routing 决定进入 Shadowrocket 处理范围的连接如何选择出口。配置模式 Config 根据当前配置中的规则分流；代理模式 Proxy 用于让相关连接采用代理路径；直连模式 Direct 用于采用当前网络直接访问。三种模式是路由决策，不是三种连接协议，也不表示服务器本身是否正常。

在哪里：进入 Home，找到 Global Routing。选择前先确认当前使用的服务器，以及 Config 中启用的是哪份配置；只导入配置但没有选中，不等于它已经参与处理。

怎么设：日常已有可用分流配置时，先选 Config。某个目标访问失败时，保持同一网络、同一服务器和同一目标，临时切换到 Proxy 对照；需要确认本地网络能否直接访问时，再测试 Direct。每次切换后重新发起连接，必要时重新打开连接开关，避免旧会话影响判断。

注意什么：Proxy 不代表能接管设备上的所有通信，系统服务、局域网排除项与平台机制仍可能影响路径。若 Proxy 可用而 Config 不可用，优先看规则和策略引用；若两者都失败，先检查服务器与网络。对照完成后恢复日常模式，不要将测试状态遗留为长期设置。

规则分流：匹配条件与执行策略

是什么：规则由匹配条件与策略构成。DOMAIN 匹配指定域名，DOMAIN-SUFFIX 匹配域名后缀，DOMAIN-KEYWORD 按域名中的关键字匹配；IP-CIDR 和 IP-CIDR6 分别描述 IPv4、IPv6 网段，GEOIP 用于按 IP 地理归属匹配。USER-AGENT 的实际匹配还依赖是否能取得相应请求信息，不应视为通用的应用识别方式。

在哪里：进入 Config，查看当前选中的配置及其规则内容。Home 中的 Global Routing 需要选择 Config，才能按这份配置进行分流。服务器列表和规则列表解决的是不同问题：前者保存连接参数，后者决定哪些连接采用哪项策略。

怎么设：先备份现有配置，再把范围较小的例外规则放在较宽泛规则之前。下面仅演示语法，example.com 和 example.org 是文档示例域名，不是服务器信息；使用前应根据实际需求替换并验证。

[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
DOMAIN,ads.example.com,REJECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

PROXY 表示采用代理策略，DIRECT 表示直接连接，REJECT 表示拒绝连接。FINAL 是前面条件未命中时的最终处理项，应放在规则末尾。配置若使用自定义策略名称，还要核对名称是否存在、引用是否一致，不能把不存在的名称当成可用出口。

注意什么：规则通常按顺序寻找匹配项，前面的宽泛条件可能遮住后面的精确条件。域名规则与 IP 规则看到的信息不同，访问结果也会受 DNS 与缓存影响。修改后先用一个明确目标验证命中情况；若误用 REJECT，可能阻断页面所需的资源。不要为解决单个目标问题而一次替换整份配置。

Subscribe 与 Add Server：订阅及服务器管理

是什么：服务器条目保存单个连接的地址、端口、协议与认证参数；订阅用于从用户已有的地址读取一组服务器信息，并在后续更新。导入成功只说明内容已被读取，不代表条目仍然有效，也不代表每个服务器都能在当前网络连接。

在哪里：在 Home 管理服务器，通过 Add Server 添加条目。已有订阅时，在添加入口选择 Subscribe；已有二维码时，可使用 Scan QR Code。界面中的入口位置可能随平台布局不同而变化，应按相同英文名称查找。

怎么设：先确认自己已有订阅或服务器信息。订阅地址按原样完整粘贴，不额外加入空格或换行；手动添加则逐项核对协议、地址、端口和认证字段。Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2 的字段要求不同，应以所选协议的表单和已有参数为依据，不要只改协议名称而沿用其他协议的参数。

导入后给条目设置便于辨认的名称，使用 Connectivity Test 检查，再在 Home 选择需要使用的服务器。更新订阅后重新确认当前选择是否仍存在；如果需要保留本地修改，应先备份，避免远程更新覆盖订阅管理的内容。订阅与完整 Config 也不应混为一谈：能更新服务器列表，不等于同步取得所有分流规则。

注意什么：订阅地址可能包含访问凭据，不要放进公开截图、日志或聊天记录。更新失败时先看地址是否完整、当前网络能否读取、凭据是否有效，再重试；已有条目仍在时，不必先删除全部数据。本站不提供、不销售、不推荐节点或订阅，只说明如何使用用户已有的信息。

On Demand：按条件建立连接

是什么：On Demand 用于在符合条件时由系统尝试建立连接。它解决“什么时候连接”的问题，Global Routing 解决“连接后如何分流”的问题。启用按需连接不会自动修复服务器参数，也不能保证网络切换期间每一条已有会话都保持连续。

在哪里：进入 Settings，查找 On Demand，并查看当前平台提供的条件和例外项。若当前客户端未显示同名项目，应以该平台的设置界面为准，不要用其他平台的系统设置代替客户端选项。

怎么设：先手动完成一次连接，确认服务器、DNS 和规则均可用，再启用 On Demand。如果界面提供网络条件，先只配置一种明确场景，例如在指定网络条件下连接；保存后切换网络，检查系统连接状态，并实际访问目标验证。每增加一项例外，都应重复测试进入条件和离开条件。

注意什么：手动关闭后又出现连接，可能是按需条件重新触发，不一定是开关失效。需要彻底停止测试时，先关闭 On Demand，再关闭主连接。遇到需要网页登录确认的公共网络，先完成网络登录，再检查连接；不要在网络尚未可用时反复修改协议参数。

Data：查看流量，不用统计代替连通测试

是什么：Data 提供客户端处理流量的统计信息，用于观察上传、下载和使用变化。它反映的是当前客户端可见范围内的数据，不等同于运营商账单，也不等同于服务端的计费记录。统计周期、重置行为和显示维度以当前界面说明为准。

在哪里：打开 Data，先确认正在查看的统计范围，再比较数值。若当前平台提供按连接或时间查看的入口，应选择与本次测试对应的范围；不要将不同时间段的累计值直接相减后认定为单次访问消耗。

怎么设：通常先观察即可，不需要为了开始使用而调整统计。需要做对照时，记录测试前的时间与读数，关闭其他持续下载任务，再进行一次固定操作，随后查看变化。若选择重置统计，先保存需要保留的记录，并确认重置影响的范围。

注意什么：后台同步、图片加载和连接重试都可能产生流量。数值增长不能单独证明页面已成功加载，数值不增长也不能直接断定节点失效，还应检查路由模式、连接状态与实际请求。流量统计适合发现变化，连接成败仍需结合测试和日志判断。

Settings：DNS、测试方式与日常入口

DNS：域名解析与路由应一起检查

是什么、在哪里：DNS 将域名解析为 IP 地址。在 Settings 中查看 DNS 相关设置，同时检查当前 Config 是否也定义了解析项；配置级设置可能影响实际行为，不能只看设置页中的一个值。

怎么设：修改前记录原值，先确认问题是否只发生在域名访问。如果网络正常但特定域名失败，核对 DNS 地址的格式、当前网络的可达性，以及配置是否另有指定。使用已确认适合当前环境的解析方式，每次只改一项，重新连接并发起新请求后对照结果。

注意什么：解析成功不代表目标连接一定成功；目标能用 IP 访问，也不代表可以把所有域名请求都替换为 IP，因为证书和服务选择可能依赖域名。不要把 DNS 当作所有连接故障的统一修复项，尤其不要同时改 DNS、服务器和路由模式后再判断原因。

Test Method：统一 Connectivity Test 的比较条件

是什么、在哪里：Test Method 用于选择连通性测试的方式，可在 Settings 查找，再回到 Home 执行 Connectivity Test。可选方式以当前客户端列出的项目为准。

怎么设：对照多个已有服务器时，保持测试方式、网络和测试目标一致；如果可设置测试目标，先确认该目标本身能正常响应。一次结果异常时，间隔片刻再测，结合实际访问判断，而不是只按某一次显示的数值作选择。

注意什么：不同测试方式测量的阶段不同，结果不宜直接横向比较。测试显示的耗时不等同于下载速度，也不能覆盖所有应用的使用情况。更改测试方式只影响测试依据，不会替你修改服务器的协议或认证参数。

Today Widget：快捷操作后仍需确认状态

是什么、在哪里：Today Widget 是系统支持时的快捷入口，可在 Settings 中查找相关设置，再按系统提供的方式添加到相应区域。是否提供该入口以及可执行哪些操作，取决于当前平台与系统。

怎么设：先在主应用中选好服务器、配置和模式，完成一次正常连接，再添加快捷入口。首次通过快捷入口切换后，回到 Home 核对选中项与实际连接状态，确认操作确实符合预期。

注意什么：快捷入口不是独立的一份配置。若显示未及时刷新，先打开主应用确认，不要连续点击造成多次切换。自动连接条件仍可能在手动操作后触发，应与 On Demand 一并理解。

iCloud：同步前先明确数据范围

是什么、在哪里：在支持的 Apple 设备上，iCloud 相关选项用于在同一账户环境中保存或同步客户端支持的数据。进入 Settings 查找 iCloud 项目，同时检查系统是否允许 Shadowrocket 使用 iCloud。

怎么设：先在来源设备保存本地备份，再启用同步，等待完成后到另一台设备核对配置名称、规则和服务器条目。按界面提供的项目确认同步范围；设备上的连接权限、当前网络和实际连接结果仍要分别验证。

注意什么：不要把 iCloud 当成即时、全量且永不冲突的备份。两台设备同时修改同一内容前，应先确认同步状态。iCloud 也不是所有平台之间通用的配置迁移途径，跨平台迁移应核对目标客户端支持的导入格式，并妥善保护其中的凭据。

Diagnostics：用日志定位失败阶段

是什么：Diagnostics 用于检查和收集连接相关信息，帮助区分配置读取、域名解析、服务器连接与目标响应等阶段的问题。日志是排查依据，不是自动修复按钮；某条错误信息也需要结合发生时间和触发操作理解。

在哪里：进入 Settings，查找 Diagnostics 及当前客户端提供的日志入口。记录开始前，先确认当前服务器、Global Routing 和配置名称，避免日志与描述来自不同测试状态。

怎么设：先缩小到一个可以重复出现的故障，例如某个域名无法打开。记录测试时间，启用所需诊断项目，然后只复现一次问题。查看同一时间附近的解析结果、连接错误与命中策略；如果只有 Config 模式失败，再重点核对规则，而不是立即更换全部服务器。

注意什么：日志可能含目标域名、IP 地址、订阅凭据或服务器信息。导出前先检查内容，对外说明问题时只保留必要片段并移除敏感字段。完成排查后关闭临时启用的详细记录；长期持续记录可能增加存储与处理负担。完整症状流程见排查手册。

设置完成后的检查顺序

功能之间有依赖关系：先有可用网络和完整服务器参数，再有模式与规则，最后才是自动连接和快捷入口。按下列顺序验证，可以保留清晰的因果关系，也方便在改动失败时恢复。

1. 检查基础网络。确认设备已经完成网络登录，当前网络能正常使用；如果基础网络不可用，先停止修改客户端设置。
2. 检查服务器。核对已有信息，执行 Connectivity Test，选中条目后进行实际访问，区分测试结果与真实请求结果。
3. 检查 Global Routing。用固定目标对照 Config、Proxy 和 Direct，记录哪一种状态失败，再恢复日常模式。
4. 检查规则与 DNS。确认当前配置、规则顺序和最终策略，每次只改一项，重新建立请求后再判断。
5. 检查自动化功能。手动连接稳定后启用 On Demand，再验证 Today Widget 等快捷入口；同步后逐台检查设备状态。
6. 保留恢复路径。保存可用配置与修改记录。异常时先恢复上一项改动，再进入 Diagnostics 收集对应时段的信息。

需要从头建立连接时，阅读使用教程；需要解释协议或规则关键字时，查看术语表。本页用于功能与设置查阅，获取应用及各平台要求统一见下载页。