官方手册 · 功能与设置

Shadowrocket
代理模式与常用设置

先确认 Global Routing，再检查服务器与配置。连接开关、路由模式和规则策略分别控制不同环节，不能互相替代。

  • Home
  • Config
  • Data
  • Settings
确认模式检查规则验证连接

Global Routing 三种模式

配置 / 代理 / 直连，对应界面中的 Config / Proxy / Direct。

Global Routing 决定受客户端处理的连接按什么方式选择出口。在 Home 打开 Global Routing，按当前目的选择 Config、Proxy 或 Direct，再返回 Home 检查连接状态。它不是连接开关，也不是服务器列表：选中 Proxy 不代表隧道已经启用，切换服务器也不代表模式已经随之改变。

日常需要区分不同目标时通常选择 Config；想暂时排除规则策略的影响时可用 Proxy 做对照；需要观察直接连接表现时可用 Direct。这里的对照是故障定位手段，不是对某种模式作质量排序。测试结束后，应恢复原先计划使用的模式，避免临时设置被长期保留。

界面选项处理方式适用情形核对重点
Config依照当前启用配置中的规则选择策略。需要按域名、IP 或地区等条件分流。确认启用的配置和规则顺序。
Proxy以代理路径处理受客户端接管的连接。临时验证所选服务器，缩小规则排查范围。确认服务器可用及参数完整。
Direct使用直接连接路径。观察不经过代理服务器时的连接情况。不等同于关闭系统中的 VPN 连接。

Config 模式先确认启用对象

Config 既是配置管理页的界面词，也是 Global Routing 中的一个选项，两处承担不同职责。在 Config 页保存了文件，不等于该文件已经成为当前配置；需要核对当前启用状态。规则中的 PROXY 指向代理策略，DIRECT 表示直接连接，REJECT 表示拒绝连接。若配置还定义了策略组，应进一步检查该组当前选择的目标。

切换模式后重新建立测试连接

既有连接可能继续沿用原来的处理状态，不能仅凭同一个页面未发生变化就认定切换失败。记录原模式，切换后重新发起一次请求，再查看连接记录与规则命中情况。若同时修改服务器、DNS 和模式，结果将难以解释；每次只改变一个条件更便于核对。

规则类型与策略

规则回答“匹配什么”，策略回答“如何处理”。

规则分流用于把不同目标交给不同连接路径。入口是 Config 页的当前配置；编辑规则后保存，并确认使用 Global Routing 的 Config 模式。规则一般从上到下匹配，首条命中后采用对应策略，因此精确条件通常放在较宽条件之前，FINAL 放在末尾作为兜底。不能仅靠把规则写进文件，就假定它一定有机会被执行。

DOMAIN 匹配完整域名，DOMAIN-SUFFIX 匹配域名及其子域名范围，DOMAIN-KEYWORD 按域名中的关键词匹配。IP-CIDR 与 IP-CIDR6 分别描述 IPv4、IPv6 地址段，GEOIP 按 IP 地理归属数据匹配。USER-AGENT 依赖请求中可识别的 User-Agent 信息，并非每种连接都具有这一条件。选择类型时应根据实际能观察到的信息，而不是根据应用名称猜测。

[Rule] · 语法示例
[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY

以上域名仅用于说明语法，不是建议直接启用的完整配置。第一条只处理 example.com，第二条覆盖 example.org 及其子域名，IP-CIDR 示例覆盖相应私有地址范围，FINAL 则接住前面没有命中的连接。把 FINAL 提到前面，会使后续规则失去匹配机会。

PROXY / DIRECT
分别使用代理策略与直接连接。PROXY 的最终出口还需结合当前服务器或策略组选择核对。
REJECT
拒绝命中的连接。范围过宽会影响正常请求，应先确认目标，不应承诺它能处理所有页面内容。

规则未按预期生效时，先看当前模式，再看启用的配置，最后检查更靠前的规则是否已命中。域名规则与 IP 规则使用的匹配信息不同，DNS 解析结果也可能影响后者。需要查看各类型的边界、配置段结构及更多写法时，继续阅读规则手册，不要用重复追加同类规则代替定位。

订阅与服务器管理

先区分服务器信息与配置文件，再选择导入入口。

服务器条目保存连接所需的地址、端口、协议与认证信息；订阅用于集中导入或更新这类条目；配置文件则保存规则及其他连接设置。三者有关联，但不是同一个对象。已有订阅时使用应用中的 Subscribe 入口；只有单台服务器参数时，可从 Home 的 Add Server 手动建立条目。导入后必须回到列表核对内容，不能以“出现了名称”作为成功连接的依据。

Add Server：按现有参数填写

打开 Add Server 后，先选择与服务器一致的协议，再填写地址、端口和认证字段。Shadowsocks、VMess、VLESS、Trojan、WireGuard、Hysteria2 等协议的字段并不相同，不能把一组参数直接套到另一种协议。若原信息包含 TLS、服务器名称或传输方式，也应逐项核对；显示名称只是便于辨认的标签，不能代替实际连接地址。

通过 Scan QR Code 或剪贴板导入现有分享信息后，也应打开条目查看关键字段。扫码只是录入方式，不会验证远端是否在线。二维码图片、分享链接以及包含认证信息的页面均应妥善保管，排查问题时只提供必要的字段名称与现象，不公开完整内容。

Subscribe：导入后保留更新关系

使用自己已有的订阅地址时，核对地址完整性、访问权限和返回内容是否为应用支持的格式。订阅更新通常重新读取远端列表，因此不宜把长期需要保留的本地修改完全寄托在订阅生成的条目上。更新前记录当前选择，更新后核对条目是否变化，再确认所选服务器仍存在。

若更新后列表为空，先检查订阅是否仍有效、当时的网络能否读取地址，以及是否误把普通网页地址当成订阅。不要反复删除全部配置来尝试恢复。Config 页管理的规则文件也应另行检查其启用状态；订阅更新成功并不表示规则配置已经切换。完整导入步骤可查看上手教程。

On Demand 按需连接

自动触发连接，不负责替代路由规则。

On Demand 根据配置的条件请求系统建立 VPN 连接，适合需要减少手动操作的使用方式。它解决的是“何时连接”，Global Routing 解决的是“连接后怎样选路”。在 Settings 中检查 On Demand 相关设置，先阅读当前条件，再启用需要的行为；网络条件或 Wi-Fi 相关规则的具体可选项，以当前应用显示为准。

初次设置时，先让手动连接正常工作，再启用 On Demand。测试可分为两个阶段：在预期触发的网络环境下观察是否连接，再切换到不应触发的环境核对表现。这样能区分触发条件错误与服务器本身不可用，避免把两类问题混在一起。

需要暂停连接时，应同时检查 On Demand 是否仍会触发重连。只关闭 Home 的开关后又看到连接恢复，不一定是开关失效，可能是系统再次满足了按需条件。若同一设备保留了多份 VPN 配置，也要核对系统当前使用的配置，避免把其他配置的状态当作 Shadowrocket 的结果。

Data 流量统计

用于观察客户端记录的流量，不替代账单。

Data 用于查看客户端记录的流量情况。进入 Data 后，先确认页面展示的统计范围、时间口径与单位，再解读上传、下载等数值。这里的上传与下载是流量方向，不是服务器质量评分；某段时间数据很少，可能只是没有发起新请求，不能直接判定连接异常。

如需比较一次操作产生的变化，可先记录当前数值，执行一项明确操作，再返回 Data 观察增量。若页面提供重置操作，应先确认会清除哪些记录，必要时自行保存需要的统计结果。不要在排查中一边频繁重置，一边又试图回看同一时间段的变化。

客户端统计、系统蜂窝网络用量和用户现有服务的计量口径可能不同，涉及的连接范围、协议开销及统计周期也不一定相同。因此 Data 更适合辅助观察使用趋势；涉及蜂窝数据结算或远端用量时，应分别查看对应来源。单凭流量增加，也不能证明某条规则已按预期命中，仍需结合连接记录检查出口。

Settings 常用项

按具体目的调整，保留每次修改的原因与原值。

DNS：检查解析路径

DNS 把域名转换为连接所需的地址。相关行为需要结合 Settings 中的 DNS 设置与当前配置文件核对，而不是只看单个输入框。修改前记录当前解析设置，确认是否由正在使用的配置指定，再按已有网络环境调整。能够连接某个 IP 地址，但域名访问失败时，DNS 是需要检查的一环；这仍不足以证明全部故障都来自 DNS。

不要随意叠加多个来源不明的解析地址。修改后重新建立测试连接，并使用同一目标核对结果；同时检查 IPv4、IPv6 相关行为是否符合预期。DNS 调整可能影响域名解析结果与后续 IP 规则匹配，因此排查规则时应记录解析设置，避免测试条件不断变化。

Test Method：统一测试口径

Test Method 决定连接测试采用的方法。在 Settings 中查看该项后，再从 Home 执行 Connectivity Test。比较多个服务器时应保持方法一致，否则两次结果反映的可能不是同一类过程。测试耗时只能说明当时、该方法下的响应表现，不能直接等同于网页打开速度或持续传输能力。

某条目测试失败时，先确认测试方法涉及的目标在当前环境中可访问，再检查服务器地址、端口和认证信息。若只有特定应用访问异常，应对照实际目标的连接记录，不应仅凭列表中的一个测试结果反复更换配置。

Today Widget：核对快捷操作对象

Today Widget 用于系统提供的快捷展示与操作入口。可在 Settings 查看相关设置，并在系统允许的组件入口中添加或检查显示。具体呈现方式取决于系统与应用当前提供的能力，不应假定不同设备上的位置完全一致。

使用快捷操作后，回到 Home 核对实际连接状态、所选服务器及 Global Routing。组件是操作入口，不是另一份独立配置；若状态显示尚未刷新，应以应用内状态与系统 VPN 状态综合判断，不要连续快速切换造成误判。

iCloud 同步：先确认范围再同步

iCloud 相关选项用于在应用支持的范围内同步内容。先检查设备已登录自己的 Apple 账户、系统已允许相应 iCloud 使用，再查看 Settings 中实际提供的同步范围。不要默认所有连接记录、统计数据或敏感字段都会同步，也不要把应用购买记录与配置同步当成同一件事。

在另一台设备修改前，先核对两端内容与同步状态，必要时保留可恢复的配置副本。发生内容不一致时，优先确认网络、账户及同步权限，再判断哪份内容需要保留。恢复 App Store 已购应用，并不等于配置文件与服务器信息必然已经恢复。

Diagnostics 与连接排查

从现象定位环节，再选择需要的诊断信息。

Diagnostics 用于辅助检查连接问题。在 Settings 查找 Diagnostics 相关入口，按当前页面提供的工具执行检查。诊断结果需要与发生时间、网络环境、Global Routing 模式和具体目标一起理解；单独一条报错通常无法说明全部原因，也不能作为任意修改高级设置的依据。

  1. 记录现象。区分无法建立连接、连接后所有目标失败、只有个别域名失败，以及订阅更新失败。这几类问题处于不同环节。
  2. 核对基础信息。检查当前服务器、认证参数、启用配置与路由模式，确认设备网络本身正常，再执行 Connectivity Test。
  3. 缩小变量。保持服务器不变，对照 Config 与 Proxy 的表现；若差异明显，再检查规则、策略组和 DNS，测试后恢复原模式。
  4. 复测并记录。只修改一个设置，重新发起连接，记录变化。没有改善时恢复原值，避免把多个临时改动叠在一起。

诊断内容可能包含访问域名、服务器地址或认证相关信息。保存或分享前应先检查并遮去敏感部分，只保留有助于说明问题的错误类型、时间和操作步骤。完整订阅地址不适合作为公开排查材料；需要描述格式时，用 example.com 等示例域名替代实际地址。

设置核对与常见疑问

离开设置页前，确认当前状态与预期一致。

一次完整核对应覆盖四件事：Home 的连接状态、Global Routing 的当前选项、实际选中的服务器，以及 Config 中启用的配置。使用 On Demand 时再补查触发条件。把这些信息记录下来，后续遇到异常才有稳定的对照，不必每次从头修改全部选项。

已经选择 Config，为什么仍然走了代理？

Config 表示按规则处理，不表示所有连接直接访问。检查命中的规则是否使用 PROXY，或是否最终进入 FINAL,PROXY；同时确认启用的是预期配置，而不是只有文件保存在列表中。

切换为 Direct 后，需要关闭连接开关吗？

Direct 与关闭连接不是同一个操作。前者改变处理路径，后者停止当前连接。若目的是完全暂停客户端连接，还要检查 On Demand 是否会再次触发，并核对系统实际的 VPN 状态。

Connectivity Test 正常，是否表示所有应用都能正常访问？

不能据此推断。测试只覆盖所选 Test Method 对应的过程，实际访问还涉及目标站点、DNS、规则和远端响应。应重新发起具体请求，并检查该连接的处理路径。

服务器订阅更新后，规则也会跟着变化吗？

应按导入内容分别核对。服务器列表与规则配置承担不同职责，更新服务器订阅不等于已经更新或启用规则文件。先看更新后的列表，再到 Config 确认当前文件与规则。

首次使用应该先调整哪些设置？

先完成已有服务器或订阅的导入，核对连接参数，再确认 Global Routing 并手动连接。基础连接验证完成后，再设置规则与 On Demand。具体操作顺序见上手教程，高级规则语法见规则手册。