代理模式与常用设置

Global Routing：配置、代理、直连

是什么：Global Routing 决定已进入 Shadowrocket 处理范围的请求采用哪一种路由方式。配置对应 Config，代理对应 Proxy，直连对应 Direct。它与 Home 的连接开关不是同一个概念：选定模式不会自动证明连接已建立，也不会替代服务器参数检查。模式名称描述的是流量处理方法，不是网络质量等级。

在哪里：在 Home 打开 Global Routing 查看当前选择。日常需要按目标区分处理方式时使用 Config；想临时排除规则影响、检查所选服务器是否可用时，可以使用 Proxy；需要观察不经代理服务器的访问表现时，可以使用 Direct。切换前记录原来的选项，测试结束后恢复。

怎么设：首次使用先在 Home 选中服务器，再进入 Global Routing 选择所需模式，返回 Home 开启连接，并按系统提示允许添加 VPN 配置。随后用同一个目标进行访问验证。若从 Proxy 改为 Config 后才出现异常，应先检查配置，而不是立即重填所有服务器参数。

注意什么：Proxy 不代表设备上一切通信都一定进入代理，系统服务、局域网、排除路由和应用行为都可能影响实际路径。判断某条请求的处理结果，应查看连接记录与命中规则。Direct 也不是“断开”按钮；需要停止客户端处理连接时，应操作 Home 的连接开关。

Rule：匹配条件与处理策略

是什么：一条规则通常由类型、匹配内容与策略组成。DOMAIN 用于完整域名，DOMAIN-SUFFIX 用于域名及其子域，DOMAIN-KEYWORD 按域名中的关键词匹配。GEOIP 使用地址归属数据，IP-CIDR 与 IP-CIDR6 分别描述 IPv4、IPv6 网段。USER-AGENT 依赖能够取得相应请求信息的场景，不能当作所有应用都适用的识别方式。

在哪里：在 Config 中确认正在使用的配置，再查看其中的 Rule。PROXY 表示交给代理策略，DIRECT 表示直接连接，REJECT 表示拒绝请求。Global Routing 的 Proxy、Direct 是全局模式名称；规则中的 PROXY、DIRECT、REJECT 则是匹配之后的处理策略，大小写与上下文要分清。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,ads,REJECT
GEOIP,CN,DIRECT
FINAL,PROXY

怎么设：先备份当前配置，在 Rule 中把范围较小、意图明确的规则放在前面，范围较大的规则放在后面，最后用 FINAL 处理此前未匹配的请求。上面的示例中，example.com 及其子域先匹配 PROXY；未命中的请求才继续向下判断。示例域名用于说明语法，不代表可用代理服务器。

注意什么：规则通常自上而下判断，先匹配到的规则会影响最终结果。过宽的 DOMAIN-KEYWORD 可能误伤正常域名，过早出现的网段规则也可能盖住后面的特例。测试时保持 Global Routing 为 Config，并核对命中规则；只看页面能否打开，不能证明它走了预期策略。完整字段与顺序示例见规则与配置参考。

Subscribe 与服务器管理

是什么：服务器条目保存一次连接所需的地址、端口、协议和认证参数；Subscribe 保存用户已有订阅的获取位置，用于更新一组服务器信息。订阅与 Config 不是同一种数据：订阅更新解决服务器列表的维护，配置文件决定 DNS、规则与其他处理行为，导入其中一种并不表示另一种也已完成。

在哪里：在 Home 查看服务器及订阅分组。手动录入通常从 Add Server 开始；导入已有订阅时选择 Subscribe，并填写服务商提供的完整链接。Scan QR Code 适用于已有二维码，Import from Cloud JSON 用于相应格式的数据，使用前先核对导入内容的类型，避免把普通网页地址当成订阅。

1. 确认已有信息对应 Shadowsocks、VMess、VLESS、Trojan 或其他实际协议，不要根据名称猜测类型。
2. 订阅方式保留完整链接，包括必要查询参数；手动方式逐项填写地址、端口、认证信息及 TLS 等参数。
3. 保存并执行更新，确认 Home 出现预期条目，再选择服务器进行 Connectivity Test。
4. 给来源分组使用可辨认的备注，更新前后核对数量变化与失效条目，避免重复导入同一来源。

注意什么：订阅更新可能覆盖由该订阅管理的条目，手动修改的服务器应单独记录。删除订阅前先辨认所属分组，不要一次清空全部列表。订阅链接常含个人访问凭据，不应直接粘贴到公开求助截图。节点为空时，先核对链接有效性、原有服务状态和返回格式，再决定是否重新导入；完整操作见快速上手。

On Demand：按需连接

是什么：On Demand 用于按网络条件触发或维持客户端连接。它回答的是“何时连接”，而 Rule 回答的是“连接之后如何处理请求”，两者不能互相替代。启用 On Demand 不会自动修正服务器参数，也不会把所有流量改为 PROXY；实际分流仍由 Global Routing 与当前配置决定。

在哪里：在 Settings 中查看 On Demand 相关入口。可用条件和系统行为以当前设备实际选项为准，某些版本可能允许区分网络类型或指定网络。先读清每个条件的含义，再决定是否保存，不要把未出现的选项视为必填项。

怎么设：先手动连接并确认访问正常，再启用 On Demand，逐项设置需要自动连接的条件。保存后，从 Wi-Fi 切换到蜂窝网络，再切回原网络，观察 Home 的连接状态与实际请求。需要临时停止自动重连时，应先关闭相应 On Demand 条件，再关闭连接，避免开关刚关掉又被系统条件重新触发。

注意什么：公共网络可能需要先完成认证页面登录；如果自动连接妨碍认证，可暂时停用 On Demand，完成登录后再恢复。网络切换后的短暂等待不一定是规则故障，应先看客户端是否已重新建立连接。长期使用前，建议测试锁屏、唤醒和网络切换三个场景，而不是仅在当前 Wi-Fi 下检查一次。

Data：读取流量统计

是什么：Data 展示客户端能够记录的流量与连接活动，适合观察某段时间是否持续传输、上传与下载是否异常，以及某项操作有没有产生请求。它是客户端侧的观察结果，不是服务商的结算账单，也不应直接用来推断订阅剩余额度。

在哪里：打开 Data，先查看统计范围、起算条件与当前可用的分类。若界面提供按服务器或时间查看的选项，应保持对照条件一致。例如更换服务器前后比较数据时，需要同时记录所选条目与操作时间，否则累计值容易被误认为单次访问消耗。

怎么用：排查时先记下当前数值，停止不相关的后台下载，再执行一次明确操作，例如打开一个页面或下载自己的测试文件。返回 Data 观察变化，并结合连接记录查看目标地址与处理策略。若需要重置统计，先保存仍需参考的信息，再使用界面提供的重置操作。

注意什么：系统后台活动、重试和连接开销可能影响统计；DIRECT 请求是否计入某个分类，应看具体统计口径。流量增长只说明发生了传输，不能单独证明目标已完整返回。遇到“有流量但页面打不开”，继续检查 DNS、TLS、服务器可用性及命中策略，而不是仅凭累计数据判断服务正常。

Settings：DNS 与 Test Method

DNS：先检查当前配置，再修改解析

是什么、在哪里：DNS 把域名解析为地址。相关选项可在 Settings 与当前 Config 的 DNS 字段中查看；同名设置的实际作用还取决于配置内容，不要只改 Settings 却忽略正在启用的配置。域名规则是否命中、地址规则使用什么结果，也可能与解析过程有关。

怎么设：修改前保存原值，先确认故障是所有域名都失败，还是只有少数目标异常。仅调整一个解析相关选项，再用相同目标重试并查看解析结果。若使用带加密传输的解析方式，应确认当前网络和所选路由能到达该解析服务。需要固定域名映射时，应理解 Host 的用途，不要用临时地址长期替代正常解析。

注意什么：更换 DNS 不会解决密码错误、端口错误或订阅失效。缓存也可能让修改看起来没有立即生效；重试前关闭并重新建立相关连接，必要时使用界面提供的缓存处理功能。涉及具体配置字段与示例时，以配置字段中的说明逐项核对，不要同时替换整份配置与解析设置。

Test Method：区分测试成功与业务可用

是什么、在哪里：Settings 中的 Test Method 决定 Connectivity Test 使用的检测方式。不同方式所检查的层次不同：端口能够建立连接，不代表认证、TLS 与目标网站访问全部正常；请求型测试还会受到测试目标自身状态的影响。

怎么设、注意什么：按当前版本提供的测试方式选择，保持测试目标和网络环境一致，再比较同组服务器。某一条测试失败时，核对节点参数和测试目标，不要单凭一次结果删除条目；测试成功后仍应开启连接进行实际访问。显示的耗时只适合在相同测试条件下参考，不等于下载速度，也不代表全部网站的响应表现。

Today Widget 与 iCloud 同步

Today Widget：快捷操作仍需核对状态

是什么、在哪里：Today Widget 是系统允许时提供的快捷查看或操作入口。先在 Settings 查找相关选项，再按设备当前系统提供的组件管理方式添加。系统版本不同，组件形态、添加位置与可操作内容可能变化；该功能不能视为所有平台都具有的统一入口。

怎么设、注意什么：先在 Home 完成服务器选择与首次连接，再添加组件并测试其实际动作。组件可能显示尚未刷新的状态，点击后应回到 Home 确认当前服务器、Global Routing 和连接结果。若组件没有出现，先核对系统支持与应用设置，不必为了一个快捷入口删除已有配置。

iCloud：同步范围与恢复顺序

是什么、在哪里：iCloud 相关选项用于当前版本支持的数据同步或云端导入。它依赖设备上的 iCloud 状态与相应权限。应用购买记录、客户端数据、订阅服务是不同事项；登录同一 iCloud 不表示已经拥有全部订阅，也不表示任何平台都会自动出现相同服务器列表。

怎么设：在 Settings 中检查同步入口，确认当前设备允许 Shadowrocket 使用 iCloud，并阅读界面说明的同步范围。首次启用前先保留本地配置；在另一台设备上导入或同步后，核对配置名称、服务器分组与启用状态，再开启连接。遇到同名内容时，先比较实际字段，避免用空白数据覆盖已有内容。

注意什么：同步不等于独立备份，删除或修改也可能传播到其他设备。含订阅地址或认证信息的数据应按敏感内容保管，导出文件不要放进公开目录。跨设备排查时先检查账号、权限和网络，再检查应用内容；不要通过反复删除全部数据来强行触发同步。

Diagnostics：按层定位问题

是什么、在哪里：Diagnostics 是收集诊断线索的入口，在 Settings 中查找当前版本提供的工具。它与 Home 中的 Connectivity Test、连接记录可以互相补充：前者帮助观察网络与客户端状态，后两者分别检查服务器测试结果及具体请求。诊断信息用于缩小问题范围，不应把单条报错直接等同于配置全部损坏。

1. 确认基础网络。检查当前网络是否已完成认证，普通直连访问是否正常；网络本身不可用时，先恢复网络。
2. 确认服务器信息。核对地址、端口、认证字段与已有服务状态，使用 Connectivity Test 获取同一条件下的结果。
3. 确认路由模式。记录 Config 下的失败目标，短暂切到 Proxy 对照；若表现不同，再查 Rule 与所选策略。
4. 确认解析与握手。分别查看 DNS 结果、TLS 相关参数及连接错误，不把解析失败与认证失败混为一谈。
5. 复现后再记录。清楚记下操作顺序、所用网络、目标域名、当前模式和可见错误，测试结束恢复原设置。

注意什么：一次只改一类设置。若同时换服务器、换 DNS、替换 Config，即使恢复正常也难以判断原因。分享日志或截图前，遮盖订阅链接、密码、认证字段、个人地址与其他敏感信息；保留错误类型及必要上下文即可。某个目标访问失败时，先限定到该目标，不要直接重置整套环境。