[Features]官方手册 · 功能介绍

功能与常用设置

先区分流量走向、服务器参数与系统触发条件,再调整 DNS 和诊断选项。各项设置分工不同,连接失败时应一次只改一个变量。

Global Routing 规则与服务器 Settings 与 Diagnostics

以下以 iPhone / iPad 的界面词组织说明;其他平台的入口布局可能不同,请以当前客户端实际显示为准。

[Routing]

Global Routing 三种模式

是什么:Global Routing 决定请求按配置规则处理,还是统一采用代理或直连路径。配置、代理、直连分别对应界面中的 Config、Proxy、Direct。它与服务器选择不是同一个设置:选好了服务器,并不代表每个请求都会经过该服务器。

在哪里、怎么设:在 Home 中打开 Global Routing,按本次使用目的选择模式。日常按规则使用时选择 Config,同时到 Config 页面确认已启用正确的配置文件。需要检查已有服务器是否可用时,可临时改为 Proxy;测试结束后恢复原先模式。

模式 主要行为 适用场景 检查重点
配置 Config 由当前配置中的规则决定策略。 需要按域名、IP 地址或地区条件分流。 核对活动配置、规则顺序和末尾策略。
代理 Proxy 受客户端接管的请求通常使用当前代理。 临时判断问题是否与分流规则有关。 核对所选服务器、协议参数与网络可达性。
直连 Direct 受客户端接管的请求通常使用直连路径。 对照检查本地网络本身的访问情况。 直连并不等同于关闭系统中的 VPN 连接。

注意什么:系统流量排除、局域网绕过和具体平台限制仍可能影响实际路径,不宜把 Proxy 理解成“设备上的每一个数据包都经过远端”。如果同一目标在 Proxy 下正常、在 Config 下异常,应优先检查规则命中,而不是立即重建服务器。

[Rule]

规则类型与处理策略

是什么:规则由匹配条件与处理策略组成。域名后缀、域名关键字、IP 网段和地区数据库各有用途;规则通常按配置中的先后顺序检查,先匹配的条目决定处理方式。PROXY、DIRECT、REJECT 是策略关键字,不是服务器协议。

在哪里、怎么设:进入 Config,先确认活动配置,再查看或编辑其中的 [Rule] 部分。把明确且范围小的例外放在宽泛规则之前,并核对配置末尾的 FINAL。下面仅展示规则语法;示例域名不代表实际服务,也不提供可连接的服务器。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY
关键字匹配对象使用时注意
DOMAIN指定的完整域名。不会自动包含其他子域名。
DOMAIN-SUFFIX指定域名及其子域名。适合按同一域名体系分流。
DOMAIN-KEYWORD域名中出现的关键字。范围较宽,可能命中名称相近的目标。
IP-CIDR / IP-CIDR6IPv4 / IPv6 网段。确认网段范围及请求的实际目标地址。
GEOIPIP 地址的地区归属。判断结果受数据库与目标地址影响。
FINAL未命中前序条目的请求。通常放在规则末尾,避免提前覆盖后续规则。

注意什么:DIRECT 表示直连,PROXY 使用相应代理策略,REJECT 拒绝匹配请求。规则不会补全服务器缺失的认证信息。新增规则后,应重新发起目标请求并查看记录;已有的长连接可能继续沿用此前的路径。完整设置含义可查阅设置参考。

[Server]

订阅与服务器管理

是什么:服务器条目保存地址、端口、协议和认证参数;订阅则通过用户已有的链接批量获取、更新这些条目。服务器订阅与规则配置不是同一种内容:更新服务器列表,不一定会改变 Config 中的分流规则。

在哪里、怎么设:在 Home 中通过 Add Server 添加已有服务器。收到订阅链接时,选择适用的 Subscribe 类型入口,粘贴服务商提供的完整地址;已有二维码时可使用 Scan QR Code。导入后先检查条目是否出现,再选中一个服务器运行 Connectivity Test,最后打开连接开关进行实际访问。

按协议核对字段

手动添加时,先选正确协议,再填写地址与端口。Shadowsocks 需要核对加密方式和密码;VMess、VLESS 要核对身份参数及传输设置;Trojan 要核对密码、TLS 与 SNI。HTTP、SOCKS5、WireGuard、Hysteria2 也应以现有服务器提供的完整参数为准,不要仅凭相似字段跨协议套用。

注意什么:订阅更新可能重建或删除远端已移除的条目,临时手工修改未必会保留。重要参数应另行妥善保存,分享问题记录时隐藏订阅地址、认证信息和二维码。测试显示可达不代表所有目标都能正常访问;还需要核对 TLS、DNS 与当前规则。首次导入可按快速上手逐步操作。

[On Demand]

按条件触发连接

是什么:On Demand 通过系统的按需机制,在符合所设条件时触发连接。它控制的是“何时建立连接”,而 Global Routing 与规则控制的是“连接后如何处理请求”,两者需要分别理解。

在哪里、怎么设:在 Settings 中找到 On Demand 相关选项,查看当前可用的网络条件与触发设置。先在手动连接正常的基础上启用,再按需要配置 Wi-Fi 或蜂窝网络条件。若设置涉及 Wi-Fi 名称,应核对实际名称,避免把访客网络或同名网络误当成预期环境。

注意什么:修改后分别测试进入网络、离开网络和断开后再次访问三种情况。若刚手动断开又自动连接,先检查是否仍满足 On Demand 条件,不要反复删除系统配置。按需连接不能修复错误的服务器参数,也不能保证网络切换期间的已有连接持续可用。临时排查时可关闭按需条件、改为手动连接,测试结束再恢复。

[Data]

流量统计与观察范围

是什么:Data 用于查看客户端记录的流量信息,帮助观察上传、下载及可用的分类统计。它描述客户端能够记录的流量,不是运营商账单,也不能直接当作订阅服务的剩余额度。

在哪里、怎么设:打开 Data,先确认统计范围、时间范围以及页面实际提供的分类,再观察一次可重复的访问过程。比较修改前后的行为时,应保持相同网络、相同目标和接近的使用条件。需要重新开始记录时,先确认界面上重置操作影响的范围,保存必要信息后再执行。

注意什么:后台任务、系统流量、连接复用以及统计起止时间都可能造成数字差异。出现下载计数增长,只说明观察范围内发生了数据传输,不能据此确认某个请求命中了预期规则。要判断具体流量路径,应结合请求记录、目标域名、所选模式和策略,而不是只看总量。

[Settings]

常用设置逐项说明

Settings 中的选项用于调整解析、测试、快捷入口与数据同步等行为。不同平台和客户端界面的分组可能不同;未确认用途前保留现有设置,不按其他设备的截图逐项照抄。下面不指定固定默认值,应以当前界面、活动配置和实际网络条件为准。

DNS:先确认解析由谁处理

用途与位置:DNS 把域名解析成 IP 地址,相关行为既可能受 Settings 的 DNS 选项影响,也可能由 Config 中的 [General] 条目控制。检查时要先打开活动配置,再对照客户端当前 DNS 设置,不能只查看其中一处。

设置与注意:先用当前解析方式建立可用基线;只有出现明确的解析失败、异常地址或特定网络兼容问题时,再按现有网络要求调整。配置中的 dns-server = system 表示使用系统 DNS。修改后重新发起测试请求,留意缓存和既有连接。DNS 正常不代表服务器认证正常,使用加密解析也不代表业务请求必然经过代理。

Test Method:明确测试测到了什么

用途与位置:在 Settings 中查看 Test Method,它影响可用性测试采用的方式。不同方式可能只检查网络层面的可达性,也可能进一步访问测试目标,结果不能脱离所选方法解释。

设置与注意:比较多个服务器时使用同一测试方法,并核对界面允许设置的测试目标。若一种测试失败而实际访问正常,应先排除测试目标不可达或不响应的问题。Connectivity Test 的结果只作辅助:测试通过后仍需验证实际业务请求,不能仅按一次测试值判断长期连接质量。

Today Widget:提供快捷查看入口

用途与位置:Today Widget 相关设置用于配置系统支持的快捷查看或操作入口。在 Settings 查看客户端提供的选项,再到系统允许添加组件的位置完成添加。具体可用形式由系统及当前客户端决定。

设置与注意:添加后先核对显示内容,再测试快捷操作是否与应用内状态一致。组件可能受系统刷新节奏影响,显示更新不一定即时。连接状态有疑问时返回 Home 核对,不要只依据组件上的旧状态重复切换。

iCloud:同步范围需要实际核对

用途与位置:在 Settings 查找 iCloud 同步相关选项,同时确认系统中的 iCloud 权限允许 Shadowrocket 使用。同步的用途是让受支持的数据在同一账号的设备间保持一致,不应把它理解为所有运行状态的完整复制。

设置与注意:迁移前先在原设备确认同步完成,并另存重要的配置文件。新设备使用相同 iCloud 账号后,逐项核对服务器、订阅和活动配置;系统连接权限仍需在本机确认。同步具有传播延迟,也可能传播删除操作,不应把同步当作独立的历史备份。涉及敏感配置时还应检查设备与账号访问权限。

[Diagnostics]

诊断与记录的使用方法

是什么:Diagnostics 和相关日志选项用于收集连接过程中的线索,帮助区分解析、服务器连接、认证及规则匹配问题。记录本身不会修复连接,也不适合在没有问题目标的情况下持续扩大收集范围。

在哪里、怎么设:在 Settings 查找 Diagnostics 或当前界面提供的日志入口。先记下网络类型、所选服务器与 Global Routing 模式,再启用所需记录,重新发起一次失败请求。观察目标地址是否正确、是否出现解析错误、连接失败或认证相关信息,并把问题对应到具体环节。

注意什么:一次只复现一个问题,避免大量后台请求淹没线索。分享记录前删除订阅链接、密码、身份参数、个人域名与不必要的访问记录;诊断结束后恢复适当的日志级别。若只在一个 Wi-Fi 下失败,应先用相同配置切换网络复测;若只在 Config 下失败,应先核对规则,而不是直接放宽 TLS 检查。

[Verify]

按依赖顺序核对设置

各功能存在依赖关系:有效的服务器参数是连接基础,正确的配置决定分流,DNS 决定域名解析结果,而 On Demand 只是触发连接。把这些层次混在一起修改,会让问题难以复现,也不利于恢复原有设置。

  1. 先核对输入。确认已有订阅可更新,或者手动服务器的协议、地址、端口和认证字段完整;不要用修改规则来弥补缺失参数。
  2. 再验证基础连接。选中一个服务器,在当前网络下运行测试并进行实际访问。必要时临时使用 Proxy 缩小排查范围,完成后恢复。
  3. 然后核对分流。切换到 Config,确认活动配置、规则顺序与 FINAL,用同一目标重新请求并检查命中结果。
  4. 最后增加自动化。手动连接稳定后再启用 On Demand、组件入口与同步;每添加一项都独立验证,保留回退依据。

如果仍然无法定位问题,可到常见问题按现象排查;需要了解具体设置之间的影响时,阅读Settings 设置参考。记录“在什么网络、哪个模式、哪个目标下失败”,通常比同时更改多组选项更有助于定位原因。