官方手册 · 功能参考

Shadowrocket 功能与设置

先确认 Global Routing，再检查当前配置与服务器。按需连接、DNS 和测试方式各自解决不同问题，不宜同时修改后再判断效果。

  • iPhone / iPad 操作说明
  • 界面词保留英文
  • 规则与设置分开核对

以下以 iPhone 与 iPad 的操作逻辑说明。具体入口、可选项目及系统要求以 App Store 页面标注和当前应用界面为准；若某个设置未显示，不要凭名称相近就改动其他项目。

Global Routing：选择流量处理方式

日常按规则使用时选 Config；需要对照排查时再临时选择 Proxy 或 Direct。在 Home 中打开 Global Routing，确认当前选项。这里决定的是流量处理的总体方式，不负责导入服务器，也不能替代连接开关。更换选项后，还需要核对 Home 中选择的服务器以及连接状态。

界面选项 处理方式 适用情况 注意事项
Config（配置） 依据当前启用配置中的规则和策略处理流量。 需要按域名、IP 等条件区分处理方式的日常使用。 先确认 Config 中启用的是预期文件，再查看匹配结果。
Proxy（代理） 以代理方式处理客户端接管的流量。 对照检查规则是否造成某个目标访问异常。 服务器仍需可用；不能理解为所有系统流量都必然经过同一路径。
Direct（直连） 以直连方式处理客户端接管的流量。 与当前网络的直接访问情况进行对照。 Direct 不等于关闭连接，也不表示服务器连通性正常。

一次只改变一个选项

如果某个目标在 Config 下异常，可暂时切到 Proxy，用相同网络、相同服务器重新访问同一个目标。如果结果变化，再检查规则和策略；如果仍然异常，则继续检查服务器参数、DNS 与网络条件。完成对照后恢复原来的模式，避免把临时排查设置留作日常设置。

不要将 Proxy 的一次访问成功当作整个配置正确，也不要将 Direct 的访问失败当作应用故障。不同目标本就可能有不同的网络条件，判断时应固定目标、网络和测试时间范围。

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

规则回答“匹配什么”，策略回答“匹配后怎么处理”。在 Config 中查看当前配置文件，先确认它处于使用状态，再检查规则内容。Global Routing 选为 Config 时，规则通常按顺序匹配；较宽泛的条件放在前面，可能使后面的具体条件没有机会生效。

规则类型怎么选

DOMAIN 用于精确域名，DOMAIN-SUFFIX 用于指定域名及其子域名，DOMAIN-KEYWORD 用于域名关键字匹配。需要针对一个明确服务调整规则时，优先从可核对的域名着手，不要用过短的关键字覆盖大量不相关目标。

IP-CIDR 与 IP-CIDR6 分别表达 IPv4、IPv6 地址段；GEOIP 依据地址归属数据库参与匹配，结果受数据库和解析到的地址影响。USER-AGENT 依赖可识别的请求信息，不能把它当作所有加密流量都能使用的应用识别方式。

策略与最终回退

DIRECT 表示直连处理，PROXY 表示代理处理，REJECT 表示拒绝匹配流量。配置还可以引用已定义的策略组名称，引用时应逐字核对名称。FINAL 是未命中前面规则时的最终策略，应放在规则末尾，并明确未匹配流量应如何处理。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

这段示例仅说明规则语法：example.com 及其子域名使用 PROXY，其他未匹配流量使用 DIRECT。它不是完整配置，也没有定义服务器。编辑前先备份当前文件；若配置会从远程更新，应确认本地修改是否会在更新时被替换。

订阅与服务器管理：先导入，再核对参数

订阅是一组服务器信息的更新入口，单个服务器则是一份具体的连接参数。两者与 Config 中的分流规则不是同一件事。在 Home 管理服务器，使用添加入口进入 Add Server；已有二维码时可使用 Scan QR Code。订阅链接与服务器参数均从你的服务商处获取。

导入后检查什么

使用订阅时，在添加流程中选择 Subscribe，并按当前界面填写地址和备注。导入完成后，检查是否出现预期的服务器列表，再选中准备使用的项目。手动添加时，先选择正确的协议类型，再对照填写地址、端口、认证信息及传输参数；不要只凭服务器备注判断协议。

Shadowsocks、VMess、VLESS、Trojan、Hysteria2 等协议需要的字段并不相同。TLS、SNI、传输类型和路径等参数应与已有资料一致，不能为了通过一次测试随意关闭校验或替换认证信息。若服务商给出的字段与当前表单不对应，应先核对协议类型和参数说明。

更新与删除的边界

订阅更新会重新获取远端提供的服务器信息，列表名称、数量或参数可能随之变化。手动改过订阅内的项目时，先确认更新后的保留情况。删除旧项目之前，检查当前选中项以及策略组是否引用它；删除一台服务器并不等于删除订阅入口。

订阅地址可能携带访问凭据。不要将完整地址放进公开截图、聊天记录或故障描述。Connectivity Test 适合初步观察当前网络下的测试结果，但它并不验证所有网站、所有协议功能或完整传输速度。首次操作可参考使用教程。

On Demand：按网络条件触发连接

先确认手动连接稳定，再设置 On Demand。它用于按所配置的网络条件触发连接行为，并不是修复服务器参数的工具。在 Settings 中查找 On Demand 相关入口，逐项查看当前界面提供的条件与动作，不要把“启用”理解为适用于所有网络的固定方案。

设置前先写清预期：哪些 Wi-Fi 环境需要连接，切换到蜂窝网络后应怎样处理，哪些条件下希望保持断开。按界面支持的条件分别设置，再在实际网络之间切换验证。测试时关注系统连接状态和 Home 的状态，而不只是是否还能打开某个网页。

若手动断开后又重新连接，先检查 On Demand 是否仍在生效，再检查系统中的 VPN 设置。删除服务器通常不是处理自动重连的正确第一步。需要暂时停止自动连接时，应先停用对应条件，再断开当前连接，随后重新验证。

网络切换、系统调度与当前配置都会影响触发结果。避免同时设置多条含义重叠的条件；修改后记录预期与实际行为，才能判断是条件未命中，还是连接本身失败。

Data：查看客户端记录的流量

Data 用于观察客户端统计，不替代服务商的用量记录。从应用底部的 Data 进入统计页面，先确认当前展示的统计范围、时间区间及分类，再看数值。不同范围的累计值不能直接比较，连接时长也不等于有效传输时长。

需要判断一次操作是否产生流量时，可先记录当前统计，再只执行一次目标访问，返回 Data 查看变化。如果准备重置统计，应先保存需要保留的记录，并理解重置只影响相应的本地统计，不会重置服务商账户中的用量。

本地统计与服务商计量可能因统计边界、协议开销、时间区间或其他设备使用而不同。不要仅凭一个累计数值判断是否存在异常。排查时把同一时间范围内的连接状态、访问目标和统计变化放在一起看，必要时再用 Diagnostics 补充证据。

Settings：常用项分别解决什么问题

Settings 集中管理应用偏好与辅助工具，但部分网络行为也可能由 Config 中的内容决定。修改前先判断问题属于规则、服务器还是全局偏好；若当前配置文件已有相关设置，应先查明它与界面设置的作用范围，避免在两个地方反复覆盖。

DNS：检查名称解析

DNS 负责把域名解析为地址。出现“地址可访问、域名却失败”或不同网络下解析结果明显不一致时，可以检查 DNS。先查看当前 Config 是否包含 DNS 设置，再查看 Settings 中相关项目；保留原值，每次只调整一个因素，然后用相同域名重新测试。

更换 DNS 不会自动修正密码、端口或规则顺序。还应考虑解析请求本身的可达性、IPv4 与 IPv6 结果，以及规则对解析路径的影响。不要仅凭某个解析服务的名称推断它在当前网络一定有效。

Test Method：理解测试结果

Test Method 决定连通性测试采用的方式。在 Settings 中核对所选方法，以及界面提供的相关测试目标。不同方法检查的链路环节不同，同一个服务器出现不同结果并不必然矛盾。对照测试时应固定网络、目标与方法，避免把条件变化误认为服务器性能变化。

测试返回结果只能说明该次测试的情况。它不等于目标应用的实际体验，也不能单独作为完整带宽或长期稳定性的结论。若测试正常而访问失败，应继续检查目标域名的规则、DNS 和服务器传输参数。

Today Widget：辅助查看与操作

Today Widget 相关选项用于系统组件的显示或快捷操作。先在 Settings 中查看可用项，再按系统提供的组件添加方式启用；能否显示、可执行哪些动作，以当前系统和应用界面为准。组件是操作入口，不是另一套独立配置。

通过组件操作后，应返回 Home 核对连接状态和当前选中服务器。若组件显示与应用内不一致，先确认状态是否已刷新，不要立即删除配置或重复导入订阅。

iCloud：同步与备份分开理解

iCloud 相关设置用于在支持范围内同步应用数据。使用前检查设备上的 iCloud 状态、应用访问权限及 Shadowrocket 中的同步选项，再核对另一台设备实际出现了哪些内容。不要假定所有项目和系统授权都会一并迁移。

同步不等于独立备份：某一端的修改或删除也可能传播到其他设备。重要配置应另行保留可恢复副本。换机时先确认订阅、服务器和配置是否完整，再恢复自动连接；即使应用已恢复，系统仍可能要求重新确认 VPN 配置授权。

Diagnostics：围绕具体问题收集信息

Diagnostics 用于检查连接与网络问题。在 Settings 中打开相关入口后，选择与故障相符的工具，围绕一个域名、地址或连接现象测试。保留网络类型、Global Routing 选项、当前配置和复现步骤，比堆积大量互不相关的测试结果更有帮助。

日志与诊断结果可能包含访问目标、服务器地址或认证信息。分享之前先检查并遮去敏感内容；描述问题时只保留必要字段。某次诊断成功或失败，都应结合当时网络和配置判断，不能扩展为所有连接的结论。

设置检查顺序：从状态到具体目标

遇到连接异常时，先保留现场，再逐项核对。不要同时更新订阅、替换配置、修改 DNS 和调整 On Demand，否则即使恢复访问，也难以确定真正原因。

  1. 检查基础网络。确认设备当前网络可用，记录使用 Wi-Fi 还是蜂窝网络。
  2. 检查 Home。确认连接状态、当前选中服务器，以及系统是否已允许添加 VPN 配置。
  3. 检查 Global Routing。确认 Config、Proxy 或 Direct 是否符合本次测试目的。
  4. 检查 Config。确认启用文件、目标匹配规则、策略名称及 FINAL 回退。
  5. 检查服务器。逐项对照已有地址、端口、认证和传输参数，观察订阅更新是否改变了项目。
  6. 检查辅助设置。再核对 DNS、Test Method、On Demand，并用 Diagnostics 复测同一个目标。

恢复后，把临时排查改动逐项还原，保留确实需要的调整。对不熟悉的配置先备份、后编辑；对含凭据的数据先脱敏、后分享。需要按首次连接顺序操作时，阅读使用教程；需要按故障现象定位时，前往疑难解答。