官方手册 · 功能介绍

Shadowrocket 功能与常用设置

先确定 Global Routing,再检查规则与服务器。按功能所在界面、设置方法和影响范围,逐项建立可复查的配置。

  • Config / Proxy / Direct
  • Rule 与策略
  • Settings 检查清单
01 · Global Routing

配置、代理、直连三种姿态

Global Routing 决定处理连接的总体方式;选中服务器不等于所有连接都会经过该服务器。

在 Home 打开 Global Routing,可以选择 Config、Proxy 或 Direct。这里的“配置、代理、直连”是三种姿态的中文说明,对应界面词仍为 Config / Proxy / Direct。日常使用通常从 Config 开始,让当前配置中的规则决定每次连接采用的策略;只有在需要缩小排查范围时,才暂时切到另外两种姿态。

姿态与界面词处理方式适用情况需要注意
配置 · Config依据当前配置的规则与策略处理连接。需要区分不同域名、地址或网络用途的日常使用。先核对当前启用的 Config,以及规则引用的策略。
代理 · Proxy以代理路径处理流量,仍受系统与客户端处理范围限制。临时判断问题是否与规则分流有关。不是速度增强开关;服务器故障时切换此项不能修复服务器。
直连 · Direct以设备当前网络的直接连接路径处理流量。与原始网络作对照,检查问题是否涉及代理路径。不等于关闭客户端连接开关,也不保证清除其他设置的影响。

怎么设置与验证

先在 Home 记录当前 Global Routing 和所选服务器,再切换一个姿态,用同一网络访问同一目标。尽量重新建立连接,避免复用旧连接造成判断偏差。如果 Proxy 可用而 Config 不可用,重点检查匹配规则及策略引用;如果 Direct 也失败,应先核对本地网络、目标服务状态与系统时间。完成对照后恢复原先的姿态,不要长期保留临时排查设置。

02 · Rule / Config

规则负责匹配,策略负责处理

先看命中了哪条规则,再看该规则指向什么策略。

是什么、在哪个界面

规则分流根据域名、IP 地址等条件选择处理路径。在 Config 中选中正在使用的配置,再查看其中的 Rule 内容。规则一般按顺序匹配,较具体的条件应放在较宽泛的条件之前;末尾的 FINAL 为未被前面规则匹配的连接提供处理策略。

DOMAIN 用于完整域名,DOMAIN-SUFFIX 用于域名及其子域,DOMAIN-KEYWORD 按域名中的关键词匹配。IP-CIDR 与 IP-CIDR6 分别描述 IPv4、IPv6 地址范围;GEOIP 按地址归属数据匹配。USER-AGENT 依赖能够取得相应请求信息的场景,并不适合当作所有连接都可用的应用识别条件。

怎么设、注意什么

DIRECT 表示直接连接,REJECT 表示拒绝连接。PROXY 应按当前配置的实际定义解析为代理策略;自定义策略名称也必须在配置中有效存在。规则文字写对了,但策略引用失效,同样会导致连接无法按预期处理。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

以上是语法示例,不是可直接替代现有配置的完整文件。修改前保留副本,每次只改一组条件,随后用连接记录确认命中结果。REJECT 只能拒绝符合条件的连接;同一域名承载多种内容时,按域名拒绝也可能影响正常功能。

03 · Subscribe / Add Server

已有订阅与服务器管理

订阅是服务器资料的更新入口,配置文件是规则与设置的集合,两者用途不同。

Subscribe:集中更新已有服务器资料

在 Home 的添加入口中,按实际界面选择 Subscribe,填入用户已有的订阅 URL,并设置便于辨认的名称。保存后执行更新,再确认服务器列表是否出现预期条目。订阅更新用于同步该入口返回的资料,不代表一定会同时更改当前 Config 中的规则。

导入前核对 URL 是否完整,尤其注意复制时多出的空格、换行和遗漏的查询参数。订阅链接可能包含身份凭据,应像密码一样保管,不要粘贴到公开日志或截图中。更新失败时先看错误类型:地址无法访问、身份验证失败和返回格式不兼容,需要分别处理,不宜反复删除全部配置。

Add Server:逐项填写单个服务器

手动添加时,在 Add Server 中先选择正确的协议类型,再按照已有服务器资料填写地址、端口和认证参数。Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard 与 Hysteria2 的字段不能相互套用;同样名为“密码”或“密钥”的值,也不一定具有相同格式。

若使用 Scan QR Code,应确认二维码确实对应要导入的服务器资料,导入后仍需检查协议与字段。保存时采用能区分用途的备注,避免只凭列表顺序选择服务器。删除条目前先确认其来源:订阅生成的条目可能在下次更新后重新出现,手动创建的条目则应另行备份。

切换与测试的边界

选中服务器后,可以使用 Connectivity Test 检查当前条件下的连通性。测试结果反映特定方法、目标和时刻的情况,不等于所有网站都能正常访问,也不等于带宽测试。切换后若旧页面没有变化,应重新建立请求,并同时检查 Global Routing 是否仍按预期把目标交给所选策略。

04 · On Demand

按网络条件触发连接

On Demand 管理何时建立连接,不代替 Rule 判断单条连接的处理策略。

是什么、在哪个界面

On Demand 利用系统提供的按需连接机制,根据已配置的网络条件触发连接行为。在 Settings 中查找 On Demand 相关入口,具体条件与可选动作以当前客户端显示为准。首次设置前,应先确认手动开启连接已经可以正常使用,避免把服务器问题与自动触发问题混在一起。

例如,用户可以按实际可用选项,为特定 Wi-Fi 环境设置不同的连接行为。网络名称属于条件,连接是否建立属于结果;建立连接后,流量仍由 Global Routing 和当前配置决定走向。

怎么设、注意什么

先只增加一条容易验证的条件,保存后在对应网络与其他网络之间切换,观察连接是否按预期建立。若同时存在多条条件,检查它们的顺序与覆盖关系。测试时应区分手动关闭连接和按需规则重新触发连接,避免把自动重连误认为开关失效。

On Demand 不承诺应用在任何系统状态下持续运行,也不能保证网络切换期间所有既有连接都保持不中断。需要彻底停止按需触发时,应一并检查 On Demand 设置,而不是只反复操作 Home 的连接开关。

05 · Data

查看流量统计与连接线索

Data 用于查看客户端记录的流量信息。打开 Data 后,先辨认当前页面展示的是哪一段时间、哪一类统计,以及是否存在重置操作,再解读上传与下载数值。不同平台和界面提供的统计维度可能不同,只有在统计范围一致时,前后数据才有可比性。

排查某个操作是否产生流量时,可以先记下当前值,完成一次明确的访问,再返回观察变化。若需要清空统计,先保存用于比较的结果;重置会改变后续比较的基准。统计增加只说明客户端记录到了相应数据,不能单独证明页面完整加载、规则正确命中或远端应用处理成功。

Data 不是服务方的计费账单。客户端统计范围、协议封装、重传和远端计量方式可能不同,不应据此直接推算剩余用量。异常增长时,应结合系统后台活动与连接记录定位来源,不要只根据流量数值就改动 DNS、协议和规则等多组设置。

06 · Settings

DNS、测试方法与辅助入口

常用设置按用途分别调整;修改前记录原值,验证后再决定是否保留。

DNS:域名解析设置

DNS 把域名转换为连接所需的地址。在 Settings 的 DNS 相关入口,以及当前 Config 中,可能存在影响解析的选项;应先确认正在编辑哪一层设置,并核对实际生效关系。不要假设修改一个页面就覆盖了所有配置。

设置时使用自己明确了解且可访问的解析地址,注意地址格式与所选解析方式相符。若只有域名访问失败而已知地址可以连接,DNS 是排查方向之一;若服务器本身不可达,单纯更换 DNS 通常不能解决。IPv6、缓存与不同网络返回的地址差异,也应纳入对照。

Test Method:测试口径

在 Settings 中查看 Test Method,确认 Connectivity Test 所使用的方法;可选项以当前界面为准。不同方法检查的环节不同,不能把一种测试的数值直接当作另一种测试的结论。

比较服务器时,保持测试方法、目标与设备网络一致,再重复少量测试观察稳定性。一次测试成功并不证明认证、域名解析与实际应用请求都正常;测试失败也可能来自测试目标或方法限制。应继续用实际业务请求验证,而不是只按列表中的单次结果排序。

Today Widget:快捷查看与操作

Today Widget 是系统支持条件下的快捷入口,可用于查看状态或执行客户端提供的操作。在 Settings 查找相关选项,并在系统的小组件管理界面确认是否能够添加;入口是否显示、能执行哪些动作,取决于系统与客户端当前提供的支持。

设置后先从组件执行一次操作,再回到 Home 核对真实连接状态。组件刷新可能存在时间差,不能把暂时保留的文字或图标当作唯一判断依据。系统中找不到对应组件时,使用应用内入口即可,不必通过修改网络配置来寻找组件。

iCloud:同步与恢复

在支持 iCloud 的 Apple 设备上,先检查系统账户、iCloud 权限及 Settings 中的相关选项,再确认当前功能实际同步哪些资料。同步、导出和备份不是同一个概念,不应假定全部服务器凭据、规则与运行状态都会自动一致。

首次跨设备同步前,分别保留重要配置的可用副本;在其中一台设备做小范围变更,等待同步后检查另一台设备的结果。不要在两端同时批量编辑,以免难以判断覆盖顺序。共享设备还应注意账户访问权限,避免把含凭据的配置暴露给其他使用者。

07 · Diagnostics

按连接链路定位问题

先留下现象与上下文,再使用诊断结果缩小范围。

Diagnostics 用于获取排查线索,在 Settings 中查找对应入口,具体工具与记录内容以实际界面为准。开始前记录设备网络、Global Routing、当前 Config、所选服务器和目标地址,并说明故障发生在连接之前、域名解析阶段还是请求返回之后。相同现象可能来自不同环节,描述越具体,越容易选对下一步。

  1. 先确认基础网络。检查设备能否正常联网、系统时间是否正确,以及目标服务本身是否可用。只有某个目标失败时,不要立即重建全部服务器列表。
  2. 再确认服务器资料。核对协议类型、地址、端口、认证字段及相关传输参数。订阅刚更新后出现问题时,对照更新前后的条目变化,而不是随意改写协议参数。
  3. 随后检查匹配路径。通过可用的连接记录确认域名、匹配规则与最终策略。Config 和 Proxy 表现不一致时,优先查规则顺序、策略名称及 DNS 结果。
  4. 最后做单项对照。一次只更换网络、服务器、姿态或一项设置,重新建立请求后记录结果。这样才能判断变化来自哪一步,避免多个改动互相掩盖。

分享诊断记录前,应移除订阅 URL 中的凭据、密码、密钥与不必要的设备信息,同时保留错误类型和必要的时间上下文。不要公开整份含敏感字段的配置文件。诊断信息是判断依据,不是自动修复承诺;完成排查后应恢复临时姿态与测试设置,保留能够解释清楚的最终配置。