Shadowrocket 官方手册 · 功能

Shadowrocket
功能与常用设置

先确定连接采用哪种路由方式，再检查服务器、规则与系统设置。每次只调整一类参数，便于观察结果和恢复原状。

Global Routing · 路由方式 Config · 匹配规则 Settings · 连接行为

Home / Global Routing

Global Routing：配置、代理与直连

是什么：Global Routing 决定进入 Shadowrocket 的连接采用哪一种处理方式。Config 是配置模式，按当前配置中的规则选择策略；Proxy 是代理模式，主要用于将连接交给所选代理；Direct 是直连模式，不经代理服务器发出连接。模式、服务器和连接开关是不同层级：选中服务器不等于已经开启连接，开启连接也不等于所有请求都会采用代理。

在哪个界面：在 Home 中找到 Global Routing，进入后查看 Config、Proxy、Direct 的选中状态。先记下原来的模式和当前服务器，再做测试；不要一边切换服务器，一边更换配置，否则难以判断是哪一步产生了变化。

三种模式的用途与检查重点
界面选项 处理方式 何时使用 注意事项
Config · 配置 按当前启用配置的规则匹配策略。 日常需要区分代理、直连或拒绝的访问。 核对配置已启用，且规则引用的策略有效。
Proxy · 代理 主要通过当前选中的代理服务器处理连接。 临时检查服务器能否承载实际访问。 并非服务器可达就能保证所有目标都可访问。
Direct · 直连 连接直接发送，不经过代理服务器。 对照本地网络是否正常，缩小故障范围。 直连成功不能证明代理参数正确。

怎么设：日常分流通常选择 Config，并确认 Config 页面选中了预期配置。若部分访问异常，可以临时切到 Proxy，用同一个目标测试所选服务器；再切到 Direct，对照本地网络结果。完成比较后恢复日常模式。测试时应重新发起请求，已有连接可能继续沿用建立时的路径。

注意什么：不要把 Proxy 当作修正规则的长期替代办法。Proxy 正常而 Config 异常时，应检查匹配结果、策略名称和 DNS；两者都异常时，再检查服务器参数、网络环境及服务商提供的状态信息。

Config / Rule

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

是什么：一条规则同时描述“匹配什么”和“匹配后做什么”。DOMAIN 匹配指定域名，DOMAIN-SUFFIX 匹配域名后缀，DOMAIN-KEYWORD 匹配域名中的关键词；IP-CIDR 与 IP-CIDR6 按地址网段匹配，GEOIP 按 IP 地理数据库判断。USER-AGENT 依赖请求中可见的相关信息，不适合当作所有连接都能命中的通用条件。

在哪个界面：在 Config 中查看当前配置及其规则。需要确认的不只是文件里有没有某条规则，还包括该文件是否正被使用、Global Routing 是否处于 Config，以及目标请求是否提供了规则所需的信息。

DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

上面是语法示例，不是可直接替代现有配置的完整文件。PROXY、DIRECT、REJECT 分别用于代理、直连和拒绝；自定义策略名称则必须与配置中的定义一致。FINAL 负责未被前面条件处理的连接，不应被误当作域名规则。

怎么设：先备份当前配置，再在规则编辑入口添加明确的条件。规则通常按顺序匹配，将更具体的例外放在更宽泛的规则之前，并把最终处理规则放在末尾。保存后确认启用的是修改后的配置，用一个已知目标复测，再查看日志或连接记录中的实际策略。

注意什么：同一目标可能涉及多个域名和地址，只修改首页域名未必覆盖全部请求。地址类规则也可能受域名解析结果影响。不要仅凭页面是否打开就判断某条规则命中；应结合记录确认路径，并避免一次加入大量无法解释的规则。

Home / Subscribe / Add Server

订阅与服务器管理：参数和列表分开维护

是什么：Subscribe 用于导入和更新你已有的服务器列表，Add Server 用于手动填写单个服务器。订阅负责提供服务器条目，不等于 Config 中的完整路由策略；更新服务器列表，也不应被理解成自动更换了所有分流规则。

在哪个界面：在 Home 的添加入口选择相应类型；手动录入时使用 Add Server，订阅导入时选择 Subscribe。已有资料也可以通过 Scan QR Code 或剪贴板导入，是否能识别取决于内容格式与当前版本支持情况。

怎么设：订阅地址从你的服务商处获取，复制时保留完整内容，检查首尾空格、换行和参数是否缺失。手动添加时，先选择对应协议，再逐项核对地址、端口、认证及传输参数。Shadowsocks、VMess、VLESS、Trojan、WireGuard、Hysteria2 的字段不同，不要将某一种协议的填写方法直接套到另一种协议。

  1. 给每份订阅使用能辨认用途的名称，并保留其来源记录。
  2. 导入后检查分组与服务器条目，再选择一个条目做 Connectivity Test。
  3. 完成实际访问测试后，再整理排序或删除重复的手动条目。
  4. 订阅更新后复查所选服务器是否仍存在，配置引用的名称是否仍然有效。

注意什么：订阅更新可能覆盖订阅内的手动修改；需要长期保留的自定义条目应单独管理。订阅链接可能携带账户凭据，日志、截图或备份中出现完整地址时应谨慎处理。删除订阅前先确认备份能恢复，具体操作见订阅与服务器管理手册。

Settings / On Demand

On Demand：按条件触发连接

是什么：On Demand 用于根据系统支持的网络条件触发连接行为。它决定何时尝试建立连接，不负责替代 Global Routing 的流量选择，也不能修复失效的服务器。规则分流回答“请求走哪里”，On Demand 回答“何时启动连接”，两者应分开理解。

在哪个界面：在 Settings 中查找 On Demand 及其规则入口，具体可用条件以设备系统和当前界面为准。启用前先用手动方式验证订阅、服务器和配置，确保连接基础已经正常。

怎么设：先保留现有设置，再选择当前界面提供的网络条件，例如针对不同 Wi-Fi 环境或网络类型安排连接行为。一次只增加一项条件，分别测试进入该网络、离开该网络及切换移动网络时的表现。验证完成后再补充其他条件，而不是同时开启多条相互覆盖的规则。

注意什么：启用后手动关闭连接，下一次条件满足时仍可能再次触发。排查“关闭后又连接”时，应先检查 On Demand，再检查系统网络配置。测试过程还应考虑网络切换、休眠恢复和系统权限；不能根据一次切换结果就断言所有场景都已覆盖。

Data

Data：观察流量，不替代服务商账单

是什么：Data 用于查看客户端记录的流量情况，帮助判断连接后是否有数据传输，以及某次测试前后的用量变化。统计范围、重置方式与展示维度以页面实际说明为准，不能直接把某个计数视为设备全部网络活动的总量。

在哪个界面：打开 Data，先辨认当前展示的是哪一项统计、对应什么时间范围，再观察上传与下载数据。若界面提供重置操作，应在重置前记录需要保留的数值，避免之后失去对照依据。

怎么设：进行测试前记下当前数值，暂停不相关的后台传输，再访问一个已知目标，然后返回 Data 比较变化。若同时使用日志，应让测试时间段保持一致。这样可以区分“连接已建立但没有业务传输”和“有传输但目标返回异常”等不同情况。

注意什么：客户端统计与服务商计费口径可能不同，例如统计时间、协议开销和重置周期不一致。Data 中出现流量不代表所有请求都成功；数值较小也不代表连接失效。应将流量变化与实际访问结果、匹配策略和日志一起判断，不用它推算订阅剩余额度。

Settings

Settings：DNS、测试方式与同步

DNS：先区分解析和连接

是什么、在哪里：DNS 把域名解析为地址；相关选项可在 Settings 或当前 Config 的 DNS 设置中查看，实际生效关系需结合配置内容判断。服务器可连接但域名访问异常时，DNS 是检查方向之一，但并非所有访问失败都属于解析问题。

怎么设、注意什么：先记录当前设置，检查是否同时存在配置文件中的覆盖项，再按现有配置说明调整。一次更换一个解析选项，重新发起请求并观察日志中的解析与连接结果。不要同时改 DNS、Global Routing 和服务器；已经建立的连接或缓存结果可能影响测试，需要重新连接后再比较。

Test Method：明确测试测量的是什么

是什么、在哪里：Test Method 位于相关测试设置中，用于选择客户端进行连通性或延迟检查的方式。不同测试方法所验证的环节并不完全相同，因此结果必须与所选方法一起阅读，不能只比较显示的时间数值。

怎么设、注意什么：在 Settings 中查看 Test Method，保留测试方法、测试目标和网络环境一致，再对一组服务器执行 Connectivity Test。若测试有响应但实际访问失败，应继续核对协议、TLS、SNI 等适用参数；若某种方法全部失败，也应先确认测试目标本身可用，而不是立即删除所有服务器。

Today Widget：系统支持范围内的快捷入口

是什么、在哪里：Today Widget 是与系统小组件相关的入口，用于在支持的系统界面中查看状态或执行可用操作。先在 Settings 检查是否提供相关设置，再到系统的小组件管理界面确认可添加项目。

怎么设、注意什么：按系统提示添加后，返回客户端核对服务器与连接状态，再测试快捷操作。系统版本可能影响组件能否添加、显示内容和刷新时机。组件显示存在延迟时，以客户端及系统连接状态为准，不把小组件文字当作实时诊断结果。

iCloud：同步前先保留可恢复副本

是什么、在哪里：iCloud 相关设置用于支持范围内的数据同步。先在系统账户设置中确认 iCloud 可用，再查看 Shadowrocket 的同步选项及同步对象；不要假设所有本地数据、系统授权和即时连接状态都会同步到另一台设备。

怎么设、注意什么：启用前导出需要保留的配置，确认两台设备使用预期的 iCloud 账户，并等待同步完成。恢复后逐项核对 Subscribe、服务器选择、Config 和 Global Routing，再建立连接。同步不是独立备份，误删与错误修改也可能传播；电脑与其他系统之间的迁移应采用各平台实际支持的导入导出方式。

Settings / Diagnostics

Diagnostics：按层定位连接问题

是什么：Diagnostics 用于收集或查看诊断信息，配合 Connectivity Test、连接记录与日志定位问题。它的作用是提供证据，不是自动保证连接恢复；排查应从本地网络、服务器、解析、规则和目标服务逐层进行。

在哪个界面：在 Settings 中查找 Diagnostics，具体日志和工具入口以当前界面显示为准。先记录异常发生的网络、时间与现象，再启动所需记录。某些记录需要在问题复现前开启，事后打开未必能看到先前连接的完整过程。

  1. 确认本地网络：检查设备是否已接入可用网络，以及系统时间是否准确。
  2. 检查服务器：对当前服务器执行 Connectivity Test，核对地址、端口、认证信息和适用的 TLS 参数。
  3. 对照路由：使用同一目标分别比较 Config 与 Proxy，保留所选服务器不变。
  4. 复现并记录：重新打开目标，查看解析、命中策略与连接失败发生在哪个环节。
  5. 恢复设置：关闭临时诊断记录，恢复日常模式，只保留经过验证的修改。

注意什么：分享诊断材料前，检查订阅地址、服务器凭据、访问域名和个人网络信息，遮盖不需要公开的部分。遇到握手失败应检查对应协议参数和系统时间，遇到规则不符应检查匹配顺序；不要将所有错误都归为“服务器超时”。更多术语解释见术语表。

功能边界与获取说明

客户端设置与线路服务分开判断

Shadowrocket 提供服务器导入、代理连接、规则分流和诊断等客户端功能。已有服务器是否可用、订阅是否仍有效以及服务端允许哪些传输方式，需要对照你的服务商提供的信息检查。客户端一次性买断 ≠ 线路套餐；本站不提供、不销售、不推荐节点或订阅，也不通过调整设置替代用户已有的服务授权。

获取分为两档：iPhone / iPad 版在 App Store $2.99 一次性付费，Mac / Windows / 安卓 / Linux 版免费。Mac 提供 Apple 芯片与 Intel 两种版本。iPhone / iPad 的系统要求以 App Store 页面标注为准，核对开发者 Shadow Launch Technology Limited 与应用 ID 932747118；其他平台安装包经本站 /dl/shadowrocket/ 提供。

需要获取客户端或查看系统放行步骤时，前往全平台下载与安装说明。已经能够连接的设备，应先备份当前配置，再按本页对应章节调整功能；先验证一项，再继续下一项，避免同时更改多个设置后无法回溯原因。