官方手册 · 功能与设置

Shadowrocket 功能与设置

在 Global Routing 选择流量怎么走,在 On Demand 设置何时连接。本页按 iPhone / iPad 界面说明,其他平台请以各自客户端显示的选项为准。

  • Config配置 · 按规则选择策略
  • Proxy代理 · 使用所选服务器
  • Direct直连 · 不经代理服务器

01 路由模式

Global Routing:配置、代理与直连

在 Home 打开 Global Routing,选择 Config、Proxy 或 Direct。这个选项决定进入 Shadowrocket 的流量怎样选路,不是连接开关。只切换模式不会自动建立连接;选好模式后,回到 Home 核对连接状态。

按使用目的选择模式
界面选项 流量处理 适用场景 切换前核对
Config(配置) 按当前配置中的规则选择策略。 不同站点或地址需要走不同路径。 在 Config 确认实际启用的文件与规则顺序。
Proxy(代理) 进入客户端的流量走所选代理,不按分流规则选择路径。 暂时排除规则影响,确认当前服务器能否处理测试请求。 在 Home 确认选中的是要测试的服务器。
Direct(直连) 进入客户端的流量不经代理服务器。 为同一请求建立直连基线,判断问题是否只在代理路径出现。 这不是关闭连接;如需断开,使用 Home 的连接开关。

如果同一站点在 Proxy 下可访问,在 Config 下却失败,先查看它命中了哪条规则、该规则指定了哪个策略,再决定是否改配置。如果两种模式都失败,不要先重排整份规则;先确认当前网络、所选服务器和实际测试的目标地址。比较时只换模式,其他条件保持一致。

02 匹配与策略

规则分流:匹配条件、顺序与兜底

在 Config 打开准备使用的配置,检查其中的 Rule 段。规则前半部分写匹配条件,末尾指定匹配后的策略,例如 PROXY 走代理、DIRECT 走直连、REJECT 拒绝请求。配置生效后,还要在 Global Routing 选择 Config,否则修改规则不会改变该模式下的选路。

按请求信息选规则类型

  • DOMAIN 精确匹配主机名,适合只改一个具体域名的路径;DOMAIN-SUFFIX 匹配域名后缀,适合主域及其子域采用同一策略。
  • DOMAIN-KEYWORD 按域名中的字串匹配。字串越短越容易误伤,应在使用前检查是否会命中无关域名。
  • IP-CIDR 和 IP-CIDR6 按 IPv4 和 IPv6 网段匹配;GEOIP 按地址的地理归类匹配。以域名发起的请求如果需要依靠目标地址判定,还应检查解析结果。
  • USER-AGENT 按可取得的请求标识匹配,不等同于按应用名称识别流量。客户端拿不到相应字段时,不应依赖这条规则完成分流。

具体规则放前面,FINAL 放末尾

规则按顺序匹配,先命中的规则决定策略。下面用示例域名演示例外规则:第一行仅让 static.example.com 直连,第二行才让同一域名后缀的其余请求使用代理。调换前两行后,较广的后缀规则就会先命中,具体例外将不会生效。

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

这是规则顺序示例,不是完整配置。FINAL 只处理前面没有匹配到的请求;是否使用 DIRECT 兜底,应根据你希望怎样处理未列出的目标决定。改动前保存原配置,验证时至少检查一个明确命中的目标和一个应落入兜底的目标。若要用 REJECT 拦截,先从范围明确的域名开始,避免把登录或静态资源依赖一并拦截。

03 连接资料

Subscribe、Add Server 与服务器选择

在 Home 管理已有的服务器资料。如果你拿到的是订阅链接,从添加入口进入 Add Server,将类型选为 Subscribe,填入完整链接并保存;如界面提供更新操作,再刷新订阅并确认条目出现在 SERVER 列表。订阅链接可能含访问凭据,不要把完整链接发到公开帖子、截图或诊断记录中。

如果你拿到的是单台服务器的参数,在 Add Server 选择资料注明的协议,再逐项填入地址、端口及该协议要求的认证和传输参数。Shadowsocks、VMess、VLESS、Trojan、Hysteria2 与 WireGuard 的字段不完全相同,不要把某个协议的参数套到另一个协议上。保存后返回 Home,从 SERVER 选中要用的条目,再做 Connectivity Test 和实际访问验证。

客户端一次性买断 ≠ 线路套餐。 订阅链接或服务器资料从你的服务商处获取。本站不提供、销售或推荐节点或订阅。

订阅更新和配置文件更新是两件事:前者更新服务器条目,后者改变参与匹配的规则。更新订阅后如果原条目已被替换,要重新检查当前选择;若配置按名称引用服务器或策略组,也要检查名称是否仍对应。遇到订阅刷新失败时,先从更新状态判断是不是列表没有取回,不要把已有条目的连接故障和订阅更新故障混在一起排查。

04 连接条件

On Demand:按网络条件连接

On Demand 控制连接何时由系统按条件触发,不负责决定某个请求走代理还是直连。先在 Home 手动连接一次,确认系统连接授权已完成、服务器可用;再到 Settings 打开 On Demand,按界面提供的网络条件设置。先启用一条需要的条件并验证,再加入例外,较容易判断是哪一项改变了连接行为。

例如,你希望切换到蜂窝网络后才自动连接,可以先只设置对应的网络条件。保存后在 Wi-Fi 和蜂窝网络之间切换,使用同一个测试目标,分别记录切换前、切换后及返回原网络时的连接状态。仅在设置页看到开关开启,不足以证明条件已触发。

手动断开后,如果设备仍满足自动连接条件,系统可能再次建立连接。需要确认手动断开的效果时,先暂时关闭 On Demand 再测试。若连接状态符合预期而访问路径不对,应检查 Global Routing 和规则,而不是反复调整按需连接条件。

05 用量核对

Data:读取流量统计

Data 用于查看客户端记录的流量。进入 Data 后,先看当前统计范围与单位,再区分发送和接收。如果要估算一次操作产生的用量,先记下当前读数,只执行一次操作,等读数更新后比较前后差值。测试时尽量避免同时下载、同步或播放媒体,以免其他请求一起计入。

应用侧统计、系统蜂窝数据统计和服务商账单可能覆盖不同的流量与时间范围,不宜直接相减来判断漏计。若读数看起来没有变化,先确认连接仍在运行,再确认该请求是否进入客户端,以及显示精度能否看出这次变化。需要判断单个请求是否命中某条规则时,应查请求记录;仅凭流量总量无法确定具体策略。

06 常用选项

Settings:解析、测试、同步与诊断

开始排查前,记下当前配置、服务器和路由模式。每次只改一个选项,并使用同一个目标复测。这样即使结果没有改善,也能恢复原值,不必重新配置整套连接。

DNS:先核对当前配置的解析设置

DNS 决定域名怎样解析成地址。若当前配置已指定解析服务器,先在 Config 查看该文件的 General 段,例如是否设置了 dns-server;不要在未核对配置时就把结果归因于系统网络。确有解析问题时,记录原设置,再更改解析项,重新测试同一域名。自定义解析服务器必须在当前网络条件下可达;能连上服务器,也不意味着目标域名一定能解析。

Test Method:统一连通性测试条件

在 Settings 查看 Test Method,按界面提供的方式选择测试方法,再返回 Home 运行 Connectivity Test。比较多个条目时,应保持测试方法、网络和目标一致。测试成功只说明本次探测达到该方法的成功条件,不能保证所有站点都可用;反过来,单个探测目标失败,也不等于服务器对所有目标都不可达。

Today Widget:查看状态与使用快捷操作

在 Settings 查找 Today Widget,按应用中可见的选项设置小组件功能,再到系统的小组件界面查看设备是否支持添加。用小组件执行操作后,可回到 Home 核对连接状态与当前服务器。小组件提供的是快捷操作;如果点了之后很快重新连接,应先检查 On Demand 条件。

iCloud:换设备前核对同步范围

在 Settings 查找 iCloud 相关选项。准备同步时,先检查两台设备是否使用同一个 Apple 账户、系统是否启用了相应的 iCloud 功能,再核对客户端实际列出的同步项目。换机前保留重要配置的副本;换机后逐项检查服务器列表、启用的配置和连接授权。已购项目恢复与应用资料同步是两件事,重新安装成功不表示原设置已恢复。

Diagnostics:按时间定位故障

在 Settings 打开 Diagnostics 或界面提供的诊断入口,记下问题出现的时间,然后只重现一次失败操作。查看相邻记录,先区分域名未解析、规则选错策略和连接超时,再回到对应设置处理。需要转发诊断信息时,只保留故障相关片段,删除订阅链接、认证字段与私人地址;诊断完成后把为排查临时调高的记录级别恢复原值。

查看逐项设置说明 · 查询界面与规则术语