官方手册 · 功能与设置

Shadowrocket 设置详解

先在 Home 确认 Global Routing,再按需要调整规则、更新已有订阅或启用 On Demand。本文的界面路径以 iPhone / iPad 为例;桌面和安卓端的入口位置以应用内显示为准。

01 / Global Routing

配置、代理、直连怎么选

在 Home 打开 Global Routing,按当前任务选择 Config、Proxy 或 Direct。这个选项决定连接开启后怎样处理请求,不负责建立连接,也不会改写配置文件。

Global Routing 三种模式的行为、用途与检查项
模式 如何处理请求 何时使用 切换前后检查什么
Config(配置) 按当前配置的规则与策略分流。 日常使用,需要不同请求走不同策略时。 确认生效的是哪份配置,并检查具体规则和 FINAL。
Proxy(代理) 将客户端接管的请求交给选定的代理服务器,不按 Config 的规则逐条选路。 临时验证当前服务器能否处理目标请求。 核对 Home 中选中的服务器;测完切回日常使用的模式。
Direct(直连) 不经代理服务器转发客户端接管的请求。 排查代理路径与当前网络直连是否表现不同。 Direct 不是关闭 Home 中的连接开关;如需比较客户端未接管时的表现,应关闭连接再测。

对照测试时,固定同一个网络、同一个目标地址和同一台服务器,每次切换模式后重新发起请求。若 Proxy 能访问而 Config 不能,优先检查规则命中与策略指向;若 Direct 也失败,再关闭连接重试,区分当前网络问题和客户端设置问题。已有连接可能继续沿用旧路径,不能仅凭已打开的页面判断切换结果。

02 / Rule

规则类型、匹配顺序与策略

规则由匹配条件和命中后的策略组成。打开 Config,确认正在使用的配置文件,再检查其中的 [Rule] 段。规则按顺序匹配,先命中的条目决定该请求的策略。Home 中的 Global Routing 处于 Config 时,才用这份规则表决定分流。调整前保留原配置,便于比对和恢复。

  • DOMAIN 精确匹配一个主机名;DOMAIN-SUFFIX 可覆盖指定域名及其子域名;DOMAIN-KEYWORD 按域名中的关键词匹配,关键词越短越容易误中。域名规则里只写域名,不写协议头、路径或查询参数。
  • IP-CIDR 和 IP-CIDR6 分别匹配 IPv4 和 IPv6 地址段,GEOIP 按 IP 的地区数据匹配。它们判断的是 IP,不是域名后缀;目标地址变化或使用不同地址族时,命中结果也可能变化。
  • USER-AGENT 依赖请求中可识别的 User-Agent,不适合拿来匹配所有应用流量。FINAL 接收前面都未命中的请求,应放在规则列表末尾。
[Rule]
DOMAIN,status.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

示例先让 status.example.com 走 DIRECT,再把同一域名下其余匹配请求交给 PROXY。前两行互换后,范围更大的后缀规则会先命中,第一项例外就不起作用。PROXY 使用代理路径,DIRECT 不经代理服务器,REJECT 则阻止匹配的请求。用 REJECT 时先限定目标范围,避免将依赖同一域名的登录或资源请求一起阻断。

保存后先测要单独处理的地址,再测同域下不应受到影响的地址,最后测应落到 FINAL 的目标。字段格式和其他示例见配置字段。

03 / Server

已有订阅导入与服务器管理

订阅用于按来源更新一组服务器条目;只有一台服务器的连接参数时,可单独添加。两种方式都以已有自己的订阅或服务器信息为前提。订阅地址可能包含访问凭据,应像密码一样保管,不要放进公开截图、日志或共享文档。

  1. 在 Home 打开 Add Server。已有订阅地址时选择 Subscribe,填入服务商给出的完整地址并保存。需要刷新时,在 Home 找到对应订阅的更新入口,再确认条目是否加载;不要把订阅地址填进单台服务器的地址栏。
  2. 已有单台服务器参数时,在 Add Server 选择资料所列的协议,如 Shadowsocks、VMess 或 Trojan,按对应字段填写主机、端口和认证信息。若资料以二维码提供,可使用 Scan QR Code 导入,保存前仍须核对协议和目标地址。
  3. 回到 Home,在 SERVER 列表中选定要用的条目,再运行 Connectivity Test。订阅刷新后重新核对当前选中的条目;同名条目可能换了地址或参数,名称相同不能证明仍是原来的服务器。

应把“能刷新订阅”和“能连接服务器”当作两项检查。刷新成功只表示客户端取到了列表;若条目仍不能连接,核对协议、地址、端口和服务商给出的认证参数。若刷新本身失败,则从订阅地址是否完整、当前网络能否访问该地址查起。导入完成后的首次连接操作见快速上手。

04 / On Demand

按需连接与网络切换

On Demand 让系统在符合设定条件时发起连接,适合需要在网络切换后自动建立连接的场景。它处理的是“何时连接”,不决定“请求走哪条路线”;后者仍由 Global Routing 与当前配置决定。

从 Settings 查找 On Demand。先在 Home 手动验证当前服务器和分流模式,再开启 On Demand,按界面提供的 Wi-Fi、蜂窝网络等条件缩小启用范围。保存后分别在预期触发和不触发的网络上发起请求,并回到 Home 查看连接状态。切换网络时留出系统重新建立连接的时间,不要把刚切换时的一次失败当作规则不生效。

如果手动断开后又自动连接,先检查触发条件是否仍满足。临时做断开对照测试时,可先关闭 On Demand,测完再恢复。排查耗电时也不要只看开关状态:应对照系统电池记录,观察同类网络和相近使用时段下是否频繁重连。

05 / Data

流量统计范围与读数

Data 用于查看 Shadowrocket 记录的流量,不等同于运营商账单或服务商的计量结果。在 Data 中先确认界面显示的统计范围和单位,再看发送量与接收量。做单次测试时,不必清空已有记录:记下起始读数,完成一次操作后用结束读数减去起始读数。

若读数比预期增长快,先在同一个网络下重复观察,把视频、云同步、大文件下载等后台活动与当前测试分开。若读数没有变化,先确认连接已建立,再检查请求是否经过客户端;页面命中本地缓存,也可能没有产生新的网络传输。Data 能回答“记录了多少”,不能单凭流量增量判定某个域名命中了哪条规则,也不能用来推算线路剩余额度。

06 / Settings

DNS、测试、组件、同步与诊断

先记录原设置,只修改与当前问题相关的一项。每次修改后用同一个目标复测;同时改 DNS、服务器和测试方式,会让结果无法归因。

DNS:区分解析结果和分流结果

DNS 负责把域名解析为地址。排查时先从 Home 确认 Global Routing,再到 Config 查看当前配置的 [General],包括相关的 dns-server 设置。有需要时按当前网络的要求调整,保存并重新连接,再用一个能正常解析的对照域名和原故障域名分别测试。公司或家庭网络的内部域名可能依赖该网络的解析器;换用公共解析器后,外部域名正常并不代表内部域名也正常。更多字段见General 配置说明。

Test Method:固定条件再比较

在 Settings 查看 Test Method,按界面提供的选项确定测试方法,再回 Home 运行 Connectivity Test。只检查连接建立与验证完整请求不是同一件事;即使测试成功,也不能据此断定某个业务域名可用。比较不同服务器时,尽量固定网络、方法以及界面允许设置的测试目标。遇到一次超时先原样复测,再决定是否换服务器或检查参数。

Today Widget:从系统组件查看状态

Today Widget 是系统组件入口,不是独立的连接配置。若 Settings 中显示 Today Widget,先核对可用选项,再按系统当前支持的方式添加 Shadowrocket 组件。若设备的组件列表中找不到相应入口,或组件所示状态没有及时刷新,应回 Home 确认连接与选中的服务器。分流模式、订阅和配置文件仍在应用内管理。

iCloud:同步前确认资料范围

需要在自己的 iPhone 与 iPad 之间同步资料时,先确认两台设备登录同一个 Apple 账户,并在系统设置中允许 Shadowrocket 使用 iCloud;再到应用的 Settings 检查 iCloud 相关开关。启用前保留重要配置,先只在一台设备修改一项,再到另一台检查对应内容是否更新。不要把同步当作独立备份,也不要把看到同步条目当作连接已经建立:系统权限与连接状态仍需在每台设备上单独确认。

Diagnostics:记录可复测的故障

Diagnostics 用于收集当前连接的排查线索。在 Settings 打开 Diagnostics 前,记下出错时间、当前网络、Global Routing 模式和故障是否只影响某个目标。按原操作复现一次,将诊断结果与 DNS、服务器测试或规则检查的结果对照。提交说明前删去订阅完整地址、密码和认证信息;只保留复现所必需的环境与现象。无法判断下一步时,查看连接故障问答。