OFFICIAL MANUAL · 功能参考

Shadowrocket 功能与设置
路由、连接与诊断

先决定流量按什么方式处理，再核对服务器与配置，最后调整自动连接、DNS 和测试项。一次只改一项，并用相同目标复测，便于判断设置是否生效。

01 · GLOBAL ROUTING

三种模式，先选处理范围

Global Routing 的模式选择与服务器选择是两件事。选中服务器，不等于所有请求都会经过该服务器。

是什么、在哪里：Global Routing 是 Home 中的全局路由入口，提供 Config、Proxy、Direct 三种模式。中文可分别理解为配置、代理、直连，但操作时应认准英文界面词。Config 读取当前配置中的规则；Proxy 将受客户端接管的请求交给代理策略处理；Direct 将受接管的请求直接连接目标。三者决定的是处理方式，不是服务器的可用状态。

界面模式处理方式何时使用优先核对
Config · 配置按当前配置的规则与策略分流。需要部分目标代理、部分目标直连时。启用的配置、规则顺序、策略引用。
Proxy · 代理把受接管的请求交给代理处理。临时验证代理连接，或需要统一代理处理时。所选服务器、协议参数、目标是否可达。
Direct · 直连把受接管的请求直接连接目标。需要直连，或对照检查代理路径时。当前网络自身是否能够访问目标。

怎么设：在 Home 打开 Global Routing，按需求选择模式，再返回核对当前服务器。日常已有明确分流规则时使用 Config；排查某个目标时，可以在记录原模式后临时切换 Proxy 或 Direct，用同一目标比较结果。测试结束恢复原来的选择，避免把临时排查状态当成长期设置。

注意什么：Direct 不等于关闭客户端连接，Proxy 也不保证目标一定可达。即使服务器已选中，请求仍可能因规则走 DIRECT 或被 REJECT。若切换模式后表现不同，先检查规则与 DNS，不要立即把问题归因于协议。首次连接步骤见Global Routing 教程。

02 · RULES & POLICIES

规则分流，匹配对象与执行策略

规则回答“匹配哪条请求”，策略回答“命中后怎么处理”。两者需要一起核对。

匹配类型：从域名到 IP

DOMAIN 匹配完整域名，DOMAIN-SUFFIX 匹配域名本身及其子域名，DOMAIN-KEYWORD 匹配域名中的关键词。IP-CIDR 与 IP-CIDR6 用于地址网段，GEOIP 按 IP 地理数据库结果匹配。USER-AGENT 依赖请求中可取得的对应信息，不能当作通用的应用识别规则。

DOMAIN,www.example.com,PROXY
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

基础策略：明确请求去向

PROXY 使用代理处理，DIRECT 直接连接，REJECT 拒绝请求。FINAL 是前面规则均未命中时的兜底规则，不是第四种策略。配置也可能引用命名策略组，届时要继续检查组内选择，而不能只看到规则命中就认为连接路径已经确定。

在哪里、怎么设：在 Config 中确认当前启用的配置，再进入相应配置的编辑入口查看 Rule 部分。先保存可恢复的副本，再添加范围明确的规则；把需要优先匹配的具体规则放在宽泛规则之前，把 FINAL 放在最后。保存后使用 Config 模式测试，并在可用的连接记录中核对命中规则和最终策略。

注意什么：规则通常按顺序匹配，前面已经命中时，后面更具体的规则未必有机会执行。示例中的 example.com 只用于解释语法，不是连接服务。IP 类规则还可能涉及域名解析过程；当域名规则与 IP 规则表现不一致时，应同时检查解析结果。完整配置结构见配置文件参考。

03 · SERVER MANAGEMENT

订阅与服务器，分开管理来源和参数

订阅用于维护一组服务器信息；配置文件用于维护规则及其他设置。导入一种，不代表另一种也已完成。

从已有信息建立连接条目

是什么、在哪里：Home 展示可选择的服务器与订阅分组。Add Server 用于添加连接信息，Subscribe 用于订阅类型，Scan QR Code 可读取已有信息对应的二维码。不同导入方式只是录入路径不同，最终仍需得到完整且与服务器端一致的连接参数。

怎么设：已有订阅时，在 Add Server 中选择相应类型并填写自己的订阅地址，核对后保存和更新；已有单个服务器信息时，按协议填写地址、端口和认证参数。返回 Home 后展开对应分组，选择要使用的条目。先进行 Connectivity Test，再尝试访问实际目标，避免仅凭名称判断连接是否正常。

更新时怎么处理：订阅更新是重新取得该来源的服务器列表，不会修复服务端本身的故障。更新前先确认订阅地址仍有效；更新后重新核对当前选择，因为条目名称、参数或列表范围可能改变。由订阅管理的条目可能在下次更新时被覆盖，长期修改前应先弄清其来源。

注意什么：订阅地址可能包含访问凭据，截图、同步或提交诊断材料前应去除完整链接及敏感参数。不要把不同协议的字段混填，也不要把服务器地址当成订阅地址。订阅导入的连续操作见订阅教程；已有配置的启用方法见配置文件章节。

04 · PROTOCOL PARAMETERS

协议支持，以参数一致为前提

协议名相同只是起点。认证、传输与 TLS 相关参数也必须与自己的服务器信息对应。

协议 · Add Server

WireGuard

是什么、在哪里：WireGuard 是一种基于密钥的隧道协议，可在对应的服务器类型中配置。它的密钥、地址和对端信息具有各自用途，不能用其他协议的账号密码替代。

怎么设：根据已有的 WireGuard 配置核对本端 Private Key、地址、对端 Public Key 和 Endpoint 等信息；如原配置还包含其他参数，也应逐项对应。导入后核对地址与路由相关字段，不能只确认 Endpoint 已填写。

注意什么：Private Key 属于敏感信息。若握手或访问失败，先检查密钥配对、Endpoint、网络对 UDP 的可达性及地址设置；不要通过公开完整配置来排查。Global Routing 与应用规则仍需单独确认。

协议 · Add Server

VMess

是什么、在哪里：VMess 是服务器类型之一。连接信息除了地址和端口，还包括 UUID 及对应的传输设置；实际需要哪些字段，取决于自己的服务器配置。

怎么设：在 Add Server 选择 VMess，按已有信息填写并核对 UUID。如果使用 WebSocket 或 TLS，再逐项核对相应的 Host、Path 和 Server Name 等字段。它们可能不是同一个值，应按服务端配置原样填写。

注意什么：系统时间异常可能影响认证；参数不一致也可能表现为连接超时。遇到错误先核对原始信息与设备时间，不要为了消除报错随意关闭证书验证。导入成功只代表信息已被读取，不代表连接已经验证。

Shadowsocks、VLESS、Trojan、HTTP、SOCKS5 与 Hysteria2 等类型也应采用相同的核对顺序：先确认协议，再确认地址与端口，最后检查认证、传输及 TLS 相关字段。并非每种协议都使用同样的参数，也并非每个入口都适用于所有类型。编辑时以当前应用内的字段和自己的服务器说明为准，不通过猜测补齐缺失信息。

05 · ON DEMAND

On Demand，按条件触发连接

先验证手动连接，再启用自动连接条件。自动化不能代替服务器与规则的正确配置。

先检查条件，再判断连接行为

是什么、在哪里：On Demand 用于依据设定条件触发系统的 VPN 连接行为。通过 Settings 中的 On Demand 入口核对可用选项；网络类型、SSID 等条件是否出现以及如何组织，以当前应用内展示为准。它与 Global Routing 的职责不同：前者关心何时连接，后者关心连接后如何处理请求。

怎么设：先关闭自动触发，手动连接并确认自己的服务器与 Config 可用。随后进入 On Demand，从一个范围清楚的条件开始设置。保存后切换到符合条件的网络，观察系统连接状态，再检查目标访问与策略是否符合预期。需要增加其他条件时，逐条添加并分别测试。

注意什么：多个条件可能重叠，排列或动作设置也可能影响结果。如果手动断开后又出现连接，应先检查 On Demand 是否仍在触发，不要反复添加系统配置。排查时记录当前网络、条件与预期动作；暂时停用 On Demand 后复测，可帮助区分自动连接行为与普通连接故障。

06 · DATA

Data，观察流量而非推断计费

流量统计帮助理解连接活动，但不能替代服务商或系统的计量口径。

是什么、在哪里：Data 提供客户端记录的流量信息。进入 Data 后，先阅读当前视图的统计范围与单位，区分上传、下载以及页面中实际提供的时间或连接维度。统计值反映客户端所记录的活动，不应直接解释为某个订阅剩余可用量。

怎么用：需要验证某次操作时，先记下测试前的数值，再访问一个明确的目标，随后返回观察变化。如果当前界面提供重置功能，应在理解其影响后再使用，并自行记录重置时间。对照连接记录和 Global Routing 一起看，才能判断这次活动是否符合预期。

注意什么：后台同步、网页资源和系统请求都可能产生流量变化。数值增加不能单独证明目标连接经过了预期策略，也不能证明请求内容已正确返回。统计范围、连接开销与其他计量工具可能不同；排查连接问题时，应优先核对具体请求及其匹配结果，而不是只比较总流量。

07 · SETTINGS

常用设置，每次只调整一项

以下按功能名定位。部分设置也可能由当前 Config 控制，修改前先确认生效来源。

DNS：先确认解析路径

是什么、在哪里：DNS 把域名转换成连接所需的地址。先查看 Settings 的 DNS 相关入口，同时检查当前 Config 的 General 与 Host 等相关设置，避免只改一处却忽略配置中的定义。

怎么设：先记录原值，确认所选解析服务在当前网络可达，再修改相应设置。使用同一域名复测，结合解析结果、规则命中与目标连接一起判断。若当前配置已指定 DNS，应先厘清其作用范围。

注意什么：直接访问 IP 成功而域名访问失败，可能与解析有关，但仍需检查 TLS 等因素。不要用频繁更换 DNS 掩盖规则错误；Host 中已有的映射也可能影响最终结果。

Test Method：统一测试口径

是什么、在哪里：Settings 中的 Test Method 用于选择连接测试方式。它影响 Connectivity Test 如何检查服务器，不会替你修改协议参数或 Global Routing。

怎么设：按当前界面提供的选项选择方法；如果该方法提供测试目标等附加项，核对目标本身是否可达。比较多个条目前保持相同方法与网络，必要时重复测试，减少偶然波动的影响。

注意什么：测试成功不等于每个网站都能访问，测试失败也应结合方法判断。握手可达性、网页响应和实际传输速度不是同一个指标。继续排查可阅读连接问题说明。

Today Widget：便捷查看与操作

是什么、在哪里：Today Widget 是与系统组件相关的入口，可从 Settings 核对其提供的内容与选项。系统是否提供对应的添加方式，以设备当前的组件界面为准。

怎么设：先在应用内完成服务器选择和手动连接测试，再按系统组件编辑流程添加可用组件，核对显示内容。通过组件执行操作后，必要时回到 Home 确认实际连接状态。

注意什么：组件显示可能存在刷新间隔，不能把一次显示变化当作实时诊断结果。若组件操作后的状态与预期不同，先回到应用检查授权、服务器选择和 On Demand 条件。

iCloud：核对同步范围

是什么、在哪里：Settings 中的 iCloud 相关功能用于在应用提供的范围内同步或备份数据。同步不等于所有系统授权也会复制，具体包含哪些内容，应阅读该入口的提示。

怎么设：确认设备已登录自己的 iCloud 账号，并在系统设置中允许相应访问。首次启用前保留现有配置副本，在另一设备检查同步结果后，再决定是否替换已有内容。

注意什么：App Store 已购恢复与 iCloud 数据同步是两件事。重新下载应用后仍要核对服务器、配置和连接授权。同步内容可能含订阅地址或认证信息，应保护账号与设备访问权限。

完成设置后，回到 Home 核对服务器与 Global Routing，再验证实际目标。需要从导入开始连续操作，请阅读完整使用教程；需要修改规则语法，请进入规则手册。

Shadowrocket 正版下载