Shadowrocket
代理模式与常用设置

日常需要按规则分流时选 Config；临时核对代理路径时用 Proxy；需要检查直接连接表现时用 Direct。这三个选项并不负责添加服务器，也不负责更新订阅。在 Home 打开 Global Routing 后选择所需模式，再返回 Home 确认默认服务器与连接开关。切换后重新发起目标访问，避免把原有长连接的表现当作新模式的结果。

配置/代理/直连分别对应界面中的 Config / Proxy / Direct。这里的 Config 模式与底部 Config 页面有关，但不是同一个操作：前者选择流量处理方式，后者用于管理配置文件。仅仅导入一份配置文件，不代表已经选用该文件，也不代表 Global Routing 已切到 Config。

模式不是连接成功的保证

Proxy 仍然依赖有效的服务器信息和可达的网络；Config 仍然依赖正确的规则；Direct 也会受到当前网络与目标服务状态的影响。遇到问题时先记下原模式，再只改变一个变量。若 Proxy 可以访问而 Config 不行，应优先检查规则命中与 DNS，而不是立刻重新导入全部服务器。

完成对照后恢复符合日常目标的模式。不要长期依赖临时测试状态，否则 Data 中的流量分布、局域网访问和后续排查结论都可能与预期不符。

规则分流以 Config 页面中实际选用的配置为基础。在编辑前先保留可恢复的副本，检查配置的 [Rule] 段，再确认 Home 的 Global Routing 为 Config。通常应把范围明确的规则放在较前位置，让最终规则负责前面没有命中的请求。

DOMAIN 匹配完整域名，DOMAIN-SUFFIX 匹配指定域名后缀及其子域名，DOMAIN-KEYWORD 按域名中的关键词匹配。地址类规则包括 IP-CIDR 与 IP-CIDR6，分别用于相应地址段；GEOIP 依据地址归属数据匹配，其结果取决于数据库与解析到的地址，不能当作目标服务实际部署位置的绝对证明。

策略中的 PROXY 表示使用代理路径，DIRECT 表示直接连接，REJECT 表示拒绝请求。它们是规则的处理结果，不是协议名。若配置使用自定义策略组，规则末尾还可能指向组名，此时要继续核对组内选择，不能只看规则里有没有出现 PROXY。

[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
IP-CIDR,10.0.0.0/8,DIRECT
FINAL,PROXY

先缩小匹配范围，再调整最终策略

测试一条规则时，先明确目标是完整域名、子域名还是 IP 地址。关键词规则范围较宽，容易覆盖原本不打算处理的域名；地址规则则可能需要先完成 DNS 解析。不要同时添加多条相互覆盖的规则，否则即使访问恢复，也难以判断是哪条规则起了作用。

USER-AGENT 依赖能够取得相应请求信息的条件，不宜作为覆盖所有应用流量的通用依据。无法确认请求信息时，优先检查域名或地址层面的匹配。更多关键字解释可查阅概念速查，完整配置流程见完整手册。

在 Home 使用 Add Server 添加自己已有的服务器信息；若持有服务商提供的订阅链接，则按界面选择 Subscribe 并填写链接。导入前确认资料类型：单个服务器分享信息、订阅链接与完整配置文件不是同一类内容，不能因为都是一段文本就放进同一个字段。

手动填写时，先选与资料一致的协议，再逐项核对地址、端口、认证信息及传输相关字段。Shadowsocks、VMess、VLESS、Trojan、WireGuard、Hysteria2 以及 HTTP、SOCKS5 的参数并不完全相同，不应把一个协议的填写方式直接套到另一个协议。字段缺失时应向原资料提供方核实，而不是猜测。

导入、更新、选中是三件事

导入后先检查 Home 中是否出现预期条目，再点选要使用的默认服务器，核对选择标记。更新订阅只是重新获取服务器清单，不等于自动验证每个条目可用，也不等于更换了当前默认服务器。更新后应再次确认当前选中项，尤其是在条目名称或数量发生变化时。

更新失败时，先确认当前网络能否访问订阅地址、链接是否完整以及服务是否仍有效。订阅链接可能包含访问凭据，不要把完整链接放入公开截图、日志或留言。删除旧订阅前先确认哪些条目属于该订阅，避免失去仍在使用的配置依据。

服务器测试结果只反映对应测试方法与当时网络条件。数字较小不代表所有目标访问都更快，测试有响应也不代表认证、传输与目标服务的整条访问链路都正常。选定条目后，还需要实际连接并进行目标访问验证。

On Demand 用于按设定条件触发连接行为，不负责替用户选择一套正确的服务器参数或分流规则。在 Settings 找到 On Demand，先查看现有条件，再依据实际需要配置 Wi-Fi、蜂窝网络或域名相关条件；具体可选字段以当前应用内界面为准。

开始配置前，先用 Home 的连接开关完成一次手动验证：默认服务器有效，Global Routing 符合预期，目标访问能够完成。然后一次只增加一个条件。例如按 Wi-Fi 名称设置时，要核对网络名称的实际拼写；按域名条件设置时，要明确触发目标，不能把自动连接条件误当成 [Rule] 中的分流规则。

自动连接与流量分流分开检查

On Demand 关注何时建立或触发连接，Global Routing 与配置规则关注连接建立后如何处理流量。自动连接成功并不能证明某个域名最终走了 PROXY；同样，已有连接保持可用也不说明自动触发条件已经得到验证。

测试时实际切换到对应网络，观察连接状态，再发起与条件相关的访问。多条条件共存时，应核对列表顺序和各项动作，避免范围较宽的条件盖住更具体的条件。若出现关闭后又连接的现象，先暂停 On Demand 做对照，再检查系统 VPN 状态；不要反复修改服务器信息来处理自动触发问题。

设备休眠、网络切换与系统调度会影响观察到的连接行为。建议记录触发条件、网络类型和实际结果，逐项复现。按 Wi-Fi、蜂窝网络与域名配置的进一步说明见On Demand 按需连接设置。

Data 页面用于查看应用提供的流量统计及相关连接信息。排查前先观察页面当前显示的统计范围、分类和记录内容，再发起一次明确的目标访问，对照是否出现相应变化。不同统计项目的累计范围可能不同，应以界面标示为准，不要把一个累计数字直接解释为本次访问消耗。

需要比较 Config 与 Proxy 的表现时，先记录当前模式与统计读数，再完成同一项访问。如果记录中提供目标、策略或服务器信息，就把它们与预期规则对照。仅凭总流量增加不能确认某条规则已经命中，因为后台任务也可能同时产生请求。

统计用于定位，不用于推算套餐余额

客户端记录与服务商计费之间可能存在统计时段、协议开销和计费口径差异。Data 的数字不应直接当作订阅余额，也不能证明某个目标的全部流量都走了同一条路径。若要核对账户用量，应查看自己服务商提供的记录。

清理记录或重置统计前，先保留本次排查所需信息。分享记录时遮去服务器地址、账号和其他敏感字段；只提供复现时间、当前模式、所用协议与失败现象，通常更便于逐步缩小问题范围。

DNS：先确认实际生效的位置

DNS 决定域名如何解析为地址，也会影响部分地址类规则的判断。检查 Settings 中的 DNS 相关选项时，同时检查当前 Config 是否声明了 DNS 参数；不要只修改一个界面，就假定全部解析行为已经改变。使用系统解析的配置写法可以是 dns-server = system。

需要自定义解析时，按当前应用支持的格式填写，并确认解析服务在当前网络中可达。DNS over HTTPS 改变的是解析请求的传输方式，不会自行修复服务器认证错误。修改后重新建立连接并访问目标，分别观察解析是否成功、连接是否成功。具体取舍见DNS 设置说明。

Test Method：明确延迟测试测的是什么

在 Settings 的 Test Method 中查看当前测试方式，再回到 Home 对已有服务器执行测试。不同方法关注的连接阶段不同，因此测试读数只能在相同方法、相近时间和相同网络下作有限对照。更换 Test Method 后，不宜把新读数与此前另一种方法的结果直接排序比较。

如果测试有响应但网页无法访问，继续检查认证参数、目标规则、DNS 与实际请求结果；如果测试没有响应，也应区分测试目标受限与服务器完全不可用。最终判断以所需目标能否完成正常访问为准。

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

在 Settings 查看 Today Widget 相关选项，并按设备系统提供的方式配置对应组件入口。它用于便捷查看或操作应用提供的连接功能，具体可用内容以当前应用与系统界面为准。首次使用前，应先在 Home 完成服务器选择与连接授权。

通过组件操作后，返回应用确认连接开关与当前服务器。组件不是独立的连接配置，也不会替代 Global Routing 的选择。若设备没有显示预期入口，先核对系统组件列表与应用设置，不要据此判断订阅导入失败。

iCloud 同步：同步不等于验证或完整备份

在 Settings 检查 iCloud 同步相关开关，同时确认设备已登录自己的 Apple 账户并允许相应 iCloud 使用。同步范围以当前应用列出的项目为准，不应假设连接状态、诊断记录与所有本地数据都会一并转移。

在另一台设备打开应用后，逐项核对服务器、配置文件与当前选择，再进行连接测试。批量删除或修改配置前先保留副本，因为同步可能把更改带到其他设备。应用购买记录的恢复与配置数据同步是两件事，购买问题请查看已购恢复说明。

Diagnostics：围绕一次失败收集信息

在 Settings 找到 Diagnostics，按界面提供的诊断项目检查当前连接环境。开始前记录网络类型、Global Routing、所选服务器与失败目标；随后只复现一次明确的问题，再查看与该时段相关的诊断结果。不要把大量不相关的历史信息混在一次排查中。

诊断结果应与 Home 的 Connectivity Test、实际目标访问及 Data 中的记录交叉核对。日志里的单条失败不一定代表全部连接失败；同样，某项测试通过也不代表所有应用都能正常访问。导出或分享材料前先检查是否含订阅链接、认证字段或个人访问记录。

1. 保留当前状态。记录 Global Routing、选中的服务器、启用的配置与 On Demand 条件，修改配置前保留副本。
2. 先测手动连接。暂时排除自动触发条件的影响，在 Home 选中默认服务器，打开连接开关，并按系统提示完成 VPN 配置授权。
3. 再测实际访问。运行 Connectivity Test 后访问所需目标，区分测试失败、域名解析失败与目标服务自身无响应。
4. 对照模式与规则。必要时临时比较 Proxy 和 Config 的结果，检查规则顺序、最终策略与 DNS；一次只改一个设置。
5. 最后恢复自动条件。手动连接与分流确认正常后，再恢复 On Demand，并通过真实网络切换验证触发行为。

如果仍然无法定位问题，保留能够复现现象的最少步骤，按完整手册逐阶段核对。首次配置可从连接教程开始；购买、系统要求与兼容性请到App Store 正版核验页查看，其中系统要求与设备适用性均以 App Store 页面标注为准。