官方手册 · 功能与常用设置

Shadowrocket 功能与设置

先确定 Global Routing，再检查服务器、规则与 DNS。连接开关、路由模式和按需连接各有职责，应分开核对。

Shadowrocket 是 Apple 平台上的闭源商业应用，以 iPhone 与 iPad 为主要使用设备，唯一获取入口为 App Store。系统要求及设备兼容性以 App Store 页面标注为准。需要核对应用或购买信息时，先阅读App Store 正版获取说明；首次操作可先看使用教程。

路由入口

Global Routing：配置、代理与直连

Global Routing 决定请求采用哪种整体路由方式。在 Home 中打开 Global Routing，可按需要选择 Config、Proxy 或 Direct。中文说明中的“配置、代理、直连”分别对应这三个界面词。日常需要按域名或地址分流时使用 Config；短时验证已选服务器是否可用时，可以切换到 Proxy；希望使用直接连接路径作对照时，可以选择 Direct。

界面选项 主要行为 适用情况 需要核对
Config（配置） 按当前配置文件的规则决定请求策略。 让不同目标分别使用 PROXY、DIRECT 或 REJECT。 当前选中的配置文件、规则顺序及最终命中策略。
Proxy（代理） 以代理方式处理流量，仍需注意应用与系统的相关例外。 临时排查服务器连接，减少规则差异对结果的影响。 已选服务器、认证字段及其实际连接能力。
Direct（直连） 采用直接连接方式，不以所选代理服务器转发普通请求。 对照本地网络能否直接访问同一目标。 本地网络、目标服务与域名解析是否正常。

设置时先记下原来的选项，再只修改 Global Routing，随后用相同目标重复访问。若 Proxy 可以访问而 Config 失败，优先检查规则与当前配置；若两者均失败，再检查服务器参数、DNS 和本地网络。这是缩小范围的方法，不是仅凭一次结果就确定原因。

Global Routing 不是连接开关。选中 Proxy 不代表隧道已经建立，选中 Direct 也不等于断开系统中的 VPN 连接。还应查看 Home 的连接状态。排查结束后恢复原本需要的模式，避免把临时设置当成长期配置。

规则与策略

Rule：按条件决定连接路径

规则负责匹配请求，策略负责处理请求。先在 Config 中确认当前启用的配置文件，再查看或编辑其 [Rule] 段。Global Routing 使用 Config 时，规则按从上到下的顺序判断，命中后采用该条规则的策略。把范围明确的条件放在前面，把兜底的 FINAL 放在最后，通常更容易阅读和排查。

DOMAIN 匹配指定域名；DOMAIN-SUFFIX 匹配域名及其子域名；DOMAIN-KEYWORD 按域名中的关键字匹配。IP-CIDR 与 IP-CIDR6 分别用于地址网段，GEOIP 根据目标 IP 的归属信息判断。USER-AGENT 则依赖可用的请求头信息，不能把它当成任何连接都能识别应用身份的通用条件。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,ads,REJECT
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY

上面的片段只演示语法与顺序，不是一份适用于所有网络的完整配置。PROXY 表示采用代理策略，具体出口取决于当前选择与配置定义；DIRECT 表示直接连接目标；REJECT 表示拒绝请求。关键字 ads 也只是示例，它按字符串匹配，并不能准确代表某一类内容。

编辑前保留原配置，保存后确认选中的仍是修改后的文件。验证时发起新的请求，并在可用的连接记录中核对目标与命中规则；已有连接可能沿用原来的处理结果。需要理解各段结构、策略和优先级时，继续阅读规则与配置字段参考，不要一次加入大量无法解释的规则。

连接资料

Subscribe 与 Add Server：管理已有信息

服务器记录保存连接参数，订阅用于批量获取和更新这些记录。在 Home 使用 Add Server 添加用户已有的服务器信息，或在 Type 中选择 Subscribe 后填入已有订阅地址。应用提供 Scan QR Code 等入口时，也可用于读取用户自己的连接资料。保存前核对所选类型，订阅地址与单个服务器的分享内容不是同一种数据。

手动填写时，协议类型必须与服务器端一致。Shadowsocks、VMess、VLESS、Trojan、WireGuard、Hysteria2 以及 HTTP、SOCKS5 的字段要求并不相同。地址、端口、认证信息和传输设置应逐项依据用户已有资料填写；涉及 TLS 时，还要核对证书验证与相关域名设置。不能因为名称相近就互换字段，也不应为了让连接通过而随意关闭验证。

订阅更新会重新获取远端内容，因此本地记录的名称、数量或参数可能随之变化。需要保留手动编辑的条目时，先确认它是否属于订阅管理范围，并保留必要备份。给不同用途的记录使用可辨认的名称，有助于在 Home 中确认当前选中项，但名称本身不会改变路由策略。

导入完成后，先选择一条服务器，再执行 Connectivity Test，并通过实际请求验证。测试有结果只能说明对应测试方式得到了响应，不能直接证明认证、域名解析和目标访问均正常。订阅地址可能包含访问凭据，不应放进公开截图、诊断附件或共享配置。分享排查信息前，应遮去地址中的敏感部分及服务器认证字段。

连接触发

On Demand：按网络条件建立连接

On Demand 用于让系统依据设定条件触发连接，而不是决定每条请求走哪条线路。在 Settings 中查看 On Demand 相关选项，结合当前应用内提供的 Wi-Fi、蜂窝网络或指定网络条件进行设置。具体入口与可选项以设备上实际显示为准；首次启用前，先确认手动连接已经能够正常使用。

建议先设置一个清晰的条件，例如仅对某一类网络启用，再通过切换网络检查实际行为。测试时留意 Home 与系统 VPN 状态：条件满足时是否连接、离开该网络后是否符合预期。若使用指定 Wi-Fi 条件，应核对网络名称，避免把名称相近的网络误当成同一个条件。

On Demand 和 Global Routing 可以同时生效：前者决定何时触发连接，后者决定连接建立后怎样处理请求。手动断开后，如果触发条件仍然满足，系统可能再次建立连接；需要暂停时，应同时检查 On Demand，而不是反复操作连接开关。

按需连接的耗电表现取决于网络切换频率、实际流量和重连情况，不能仅凭开关状态判断。应在系统电池设置中结合观察时间和使用场景查看占比。遇到频繁重连，先检查网络条件和服务器稳定性，再调整触发规则，避免同时改变多个变量。

用量观察

Data：读取流量统计

Data 用于查看应用记录的流量信息，适合观察使用趋势和排查异常增长。打开 Data 后，先确认当前视图的统计范围、时间范围及上传和下载的区分，再读取数值。不同视图可能对应不同的连接或汇总范围，应以页面实际标注为准，不能把一个局部统计直接当成整台设备的总流量。

想判断一次操作产生多少流量，可以先记下已有数值，暂停其他明显的网络活动，再进行一次固定操作并比较变化。应用后台同步、媒体预加载和系统网络活动可能同时发生，因此短时间差值也不一定完全来自刚刚打开的页面。更改统计范围或清除记录前，先保存需要保留的观察结果。

Data 记录、系统蜂窝网络统计和用户已有服务的用量记录，可能采用不同的起止时间与计量方式。传输开销、统计范围和刷新时机都会造成差异。Data 适合本地观察，不应代替服务侧的额度记录，也不能单凭流量增长就判定具体规则已命中；规则判断还要结合连接详情和实际策略。

常用设置

Settings：解析、测试、组件与诊断

Settings 中的选项服务于不同层面：DNS 影响域名解析，Test Method 决定测试方法，Today Widget 提供组件入口，iCloud 用于同步相关数据，Diagnostics 用于收集排查线索。先明确需要解决哪一层的问题，再打开对应项；具体名称、位置与可用范围以应用实际界面为准。

DNS：先确认配置来源

DNS 将域名转换为目标地址。检查 Settings 中与 DNS 有关的选项时，也应查看当前 Config 的 [General] 段，确认是否存在 dns-server 等设置。界面选项与配置文件共同参与实际行为时，不能只看到一个输入框有值就认为所有请求都采用同一种解析路径。

调整前记录原值，每次只修改一处，再用相同域名验证。服务器延迟正常但网页打不开时，应把解析失败列入排查范围；同时也要核对路由命中和目标状态。不要把多个来源不明的解析地址连续叠加，也不要把解析服务的地理位置直接等同于请求最终出口。

Test Method：先看测量对象

Test Method 决定 Connectivity Test 使用的测试方式。在 Settings 中选择应用当前提供的方法后，再回到 Home 对选中服务器执行测试。比较多个结果时，应保持测试方法、网络环境和测试目标一致，否则数值之间缺少可比性。

不同方法可能只覆盖连接建立或某个测试请求的部分过程，测试数值不等于网页完整加载时间。若测试有响应但业务请求失败，应继续检查协议认证、TLS、DNS 和规则；若测试失败但实际请求正常，也应先检查测试目标和方法，而不是立即删除服务器记录。

Today Widget：确认组件可用范围

Today Widget 用于配置系统组件中可显示或操作的相关内容。在 Settings 查看应用提供的组件设置，再到系统对应的组件区域添加或调整。组件位置、展示形式与可用操作受系统支持情况影响，应以当前设备实际显示为准。

设置后先回到 Home 核对连接状态，再检查组件显示是否一致。组件适合快速查看或执行其支持的操作，详细的服务器选择、配置编辑与规则排查仍应回到应用完成。设备处于锁定状态时，还应考虑系统允许展示哪些信息。

iCloud：同步前核对两端状态

iCloud 相关设置用于在支持的范围内同步应用数据。使用前检查系统是否启用了 iCloud、是否允许 Shadowrocket 使用相关服务，并在应用中确认当前可同步的数据类型。同步范围以界面说明为准，不应假定服务器记录、配置与统计数据都会以相同方式处理。

首次在另一台设备启用前，先备份两端需要保留的内容，辨认本地与云端数据，避免在不了解合并或覆盖行为时连续操作。同步结果也不代表当前已选服务器、Global Routing 与连接开关都已符合预期；换设备后仍需逐项核对并重新验证。

Diagnostics：围绕一次失败收集线索

Diagnostics 用于检查连接问题和查看应用提供的诊断信息。在 Settings 找到相关入口后，先记下发生问题的网络、Global Routing 选项和当前配置，再复现一次失败。诊断内容应与这次操作对应，长期积累的大量记录往往更难定位原因。

阅读时先区分域名解析、服务器连接、认证和规则处理等阶段，再检查哪个阶段首先出现异常。准备转交诊断资料前，审阅其中可能包含的访问域名、服务器地址、订阅信息和认证字段，只保留排查所需内容。诊断记录是线索，不是单条报错即可确定原因的结论。

实际操作

按固定顺序检查设置

先建立能够复现的最小场景，再逐项恢复常用设置。一次同时更换服务器、配置文件、DNS 和测试方法，即使结果变化，也难以判断是哪一项起作用。每次修改后记录现象，保留可恢复的原值。

  1. 核对资料。在 Home 确认当前服务器来自用户自己的有效信息，检查协议、地址、端口和认证字段是否完整。
  2. 核对连接。确认系统 VPN 配置授权已完成，查看实际连接状态；连接开关打开与目标访问成功是两件事。
  3. 核对路由。在 Global Routing 中确认 Config、Proxy 或 Direct，使用 Config 时进一步确认正在使用哪份配置。
  4. 核对请求。用同一目标发起新请求，结合规则命中、DNS 与 Diagnostics 判断失败发生在哪个阶段。
  5. 恢复自动化。基础连接确认正常后再启用 On Demand、组件与同步，最后检查 Data 中的统计范围。

需要逐步完成第一次连接时，阅读Shadowrocket 使用教程；需要查某个关键字的写法时，阅读配置字段参考；对购买、导入或连接现象仍有疑问时，转到疑难解答。各页面按操作层次分工，不必为了一个设置重新修改整份配置。