官网 · 官方手册

Shadowrocket
代理模式与常用设置

先确定 Global Routing,再检查规则、服务器与 DNS。On Demand 决定何时连接,Data 与 Diagnostics 用来核对连接后的结果。

本页以 iPhone / iPad 界面组织操作路径。其他平台的入口位置可能不同,应以实际界面显示为准。

Global Routing

配置、代理、直连:三种模式怎么选

Global Routing 是全局处理方式。先确认这里的选择,才能判断 Config 中的规则是否参与当前请求。

在 Home 打开 Global Routing,可以看到 Config、Proxy、Direct 等选项。本页将这三种常用姿态分别称为配置、代理、直连,但实际操作仍按英文界面词查找。它们不是三台服务器,也不表示连接质量的高低;服务器选择与全局模式需要分别确认。

日常需要按域名或 IP 区分去向时,选择 Config,并在 Config 页面确认已选中的配置文件。只想临时验证某台服务器是否能处理目标请求时,可以切到 Proxy。需要对照设备原有网络表现时,可以短暂使用 Direct。测试完成后,应恢复原先需要的模式,避免将排查状态当作长期设置。

Global Routing 三种模式的作用与适用场景
界面选项处理方式何时使用需要注意
Config依据当前配置的规则决定策略。日常规则分流,分别处理不同目标。核对当前配置、规则顺序及策略引用。
Proxy以代理方式处理流量,受系统及应用实际可接管范围限制。临时检查所选服务器或排除规则影响。不能将此模式理解为所有应用的所有流量都必定经过同一路径。
Direct以直连方式处理流量。比较原有网络表现,检查问题是否与代理路径有关。选中 Direct 与关闭系统连接不是同一个操作。
Config · Rule

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

规则回答两个问题:什么请求符合条件,以及符合后交给哪一种策略。

是什么,在哪里设置

规则通常位于 Config 中所选配置的规则部分。DOMAIN 用于完整域名匹配,DOMAIN-SUFFIX 用于域名后缀匹配,DOMAIN-KEYWORD 按域名中的关键词匹配;IP-CIDR 与 IP-CIDR6 分别描述 IPv4、IPv6 地址段。GEOIP 依赖地址数据库判断,数据库分类不等同于网站所属机构所在地。

PROXY、DIRECT、REJECT 是处理去向:分别表示交给代理策略、直连、拒绝。PROXY 具体使用哪个服务器,还要看当前服务器选择及配置中的策略引用。USER-AGENT 只适用于能够获得相关字段的请求,不能把它当作适用于所有加密流量的应用识别方式。

规则语法示例

以下仅说明匹配结构,不是可直接套用的完整配置。

DOMAIN-SUFFIX,example.com,PROXY
DOMAIN,ads.example.net,REJECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

示例域名用于说明语法,不包含任何服务器信息。

怎么设,注意什么

先备份现有配置,再进入编辑界面添加或调整规则。将范围更明确的例外放在宽泛规则之前,最后使用 FINAL 处理前面没有匹配的请求。规则通常按顺序判断,先命中的条目会影响后续处理;同一目标存在多条规则时,应检查较靠前的条目,而不是只看刚添加的那一行。

完成编辑后保存,并确认当前使用的是刚修改的文件。测试时重新打开目标页面或建立新连接,旧连接可能仍沿用先前的路径。若规则涉及 IP 判断,同时检查 DNS 解析结果、IPv6 与配置中的解析相关选项。不要为了让一次测试通过就删除全部规则,否则会失去可比较的基线。需要理解协议字段时,可继续查看协议参考。

Home · Add Server · Subscribe

订阅与服务器管理

以用户已有自己的订阅或服务器信息为前提。服务器条目、订阅集合与 Config 文件需要分开管理。

添加与核对

Home 中的 SERVER 区域用于查看和选择服务器。手动添加时进入 Add Server,先选择 Type,再逐项填写地址、端口与认证字段。Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2 的字段并不相同,不应只因地址和端口一致就切换协议类型。

使用 Scan QR Code 导入后,也要打开条目核对 Type 与必要参数。二维码可能承载单个服务器或其他导入信息,扫码完成不代表所有参数都正确。密码、证书相关设置与传输参数应按用户已有信息填写,不凭连接错误自行猜测。

订阅更新与整理

已有订阅可从添加入口选择 Subscribe 类型,填写订阅地址并保存,再执行更新。更新成功只说明客户端取得并解析了内容,不代表其中每台服务器当前都可连接。若条目为空,先确认订阅地址是否完整、是否仍有效,再检查网络与返回内容。

给不同来源设置容易辨认的名称,先用一个集合验证连接,再逐步整理分组和排序。订阅生成的条目可能在下次更新时被覆盖,长期修改前应明确修改位置。删除重复条目前先看所属订阅;直接重复导入同一地址,往往只会增加排查负担。

订阅链接可能包含访问凭据,分享截图、日志或配置前应移除完整链接、密码和用户标识。iCloud 同步也不能替代服务器信息本身的有效性检查。本站不提供、不销售、不推荐节点或订阅;导入操作只处理用户已有的信息。

On Demand

按需连接:先设条件,再验证触发

On Demand 用于在指定网络条件出现时请求系统建立或断开连接。它解决的是“何时连接”,而 Global Routing 解决的是“连接后如何处理请求”。启用 On Demand 不会自动生成分流规则,也不会修复错误的服务器参数。

在 Settings 中查找 On Demand 及对应规则入口,按实际界面设置 Wi-Fi、蜂窝网络或域名相关条件。开始时只保留一条容易复现的条件,例如针对一个已知 Wi-Fi 名称设定动作;保存后切换到该网络,等待系统处理,再回到 Home 查看连接状态。不同系统版本显示的选项可能不同,未显示的条件不应按其他版本的截图硬套。

多条条件共存时,需要核对匹配范围和先后顺序。过于宽泛的条件可能先于具体 Wi-Fi 条件生效。域名相关触发也不等同于所有应用发出的每个 DNS 查询都会触发;缓存、已有连接与系统行为都可能改变观察结果。验证时一次只改变一项条件,并用新请求测试。

如果刚手动断开又立即连接,优先检查 On Demand 是否仍满足触发条件,而不是立即重装应用。需要暂停时,应同时检查客户端中的设置与系统 VPN 页面中的按需连接状态。网络切换、休眠唤醒和重新启动后都建议各测试一次,确认结果符合预期。

查看 On Demand 触发条件详解 →
Data

流量统计:用于观察,不替代账单

Data 用来查看客户端提供的流量记录与统计。打开后先阅读统计范围、时间区间及计数名称,再比较上传和下载变化。它反映的是相应统计口径下的活动,不应直接理解成设备全部应用流量,也不等同于服务器端或运营商的计费数值。

要判断某次操作是否产生流量,可以先记录当前值,再执行一次明确操作,随后返回 Data 比较变化。如果界面提供清零功能,清零前应保留需要的记录;清零只影响对应统计,不会改变服务器状态或重置外部服务的用量。

Settings

常用设置:按问题逐项调整

先保留可工作的配置,再修改单个选项。以下入口以实际 Settings 显示为准,配置文件中的相关设置也应一并检查。

DNS

DNS 将域名解析为地址,并可能影响按 IP 判断的规则。在 Settings 或当前 Config 的 DNS 设置中查看解析服务器与相关选项。先记录原值,再按明确需求调整,保存后重新连接并发起新请求;不要一次混用多套未经验证的解析设置。

出现“IP 可以访问、域名失败”时,DNS 是检查方向之一,但证书、域名填写错误也可能产生相似现象。修改解析服务器不会让所有问题自动消失。还应留意 IPv6 地址结果与局域网域名是否需要使用当前网络提供的解析方式。

Test Method

Test Method 决定 Connectivity Test 使用的测试方式。在 Settings 找到该项后,按实际可选方式和测试目标设置,再回到服务器列表测试。比较多台服务器时,应保持测试方式、目标与网络环境一致。

测试结果衡量的是指定探测过程,不是持续下载速度,也不代表所有网站都能正常使用。某台服务器测试失败时,应再用实际目标建立连接;测试成功但页面失败时,继续检查规则、DNS、TLS 与目标服务响应。

Today Widget

Today Widget 用于在系统支持的组件入口查看状态或进行快捷操作。先在 Settings 检查相应选项,再到系统组件编辑界面确认是否可添加;显示内容及支持形式以当前系统和应用实际提供的项目为准。

组件显示可能存在刷新延迟。若组件与 Home 的连接状态暂时不一致,应打开应用核对,不要只依据组件文字判断连接是否已建立。快捷操作后仍需要观察系统连接状态及实际请求结果。

iCloud

iCloud 相关功能用于在支持的设备间保存或同步相应数据。在 Settings 查看可同步项目,同时核对系统 iCloud 权限和当前 Apple 账号。只将界面明确列出的项目视为同步范围,不将其理解为整个应用状态的完整复制。

换设备前先手动备份重要配置,再等待同步完成。两台设备同时编辑可能产生覆盖或冲突;建议先确定一台作为本次编辑来源,另一台确认收到后再继续修改。应用购买记录与配置同步是两件事,恢复下载不会自动保证所有服务器信息已迁移。

Diagnostics

Diagnostics 用于收集或查看排查连接所需的信息。在 Settings 打开对应入口,先确认记录选项,再复现一次问题,并按时间找到相关错误。保留发生时间、当前网络类型、Global Routing 选择及错误原文,有助于区分解析、连接与认证阶段。

日志可能包含目标域名、服务器地址及其他敏感信息。提交给有权查看的人之前,应检查并移除凭据和私人内容。记录量较大时,完成测试后恢复日常设置;不能把某一条错误日志单独当作整个网络故障的最终结论。

检查顺序

设置改动后,怎样验证

  1. 保留一个可比较的起点

    记录当前 Config、Global Routing、所选服务器与网络类型。先确认设备原有网络可用,再复现目标问题。每轮只改动一个变量,否则即使恢复连接,也难以知道是哪项设置起作用。

  2. 从模式检查到请求结果

    确认连接状态后,依次核对模式、配置是否选中、规则是否被前面的条目覆盖,以及服务器认证字段。随后检查 DNS 和 Diagnostics。若切换模式后表现不同,应沿对应处理路径继续排查,而不是同时重置所有设置。

  3. 恢复日常配置

    测试结束后恢复预期的 Config、On Demand 条件与日志设置。重新连接并测试一个应走 PROXY 的目标和一个应走 DIRECT 的目标,必要时检查 REJECT 是否误命中。涉及具体报错,可到 FAQ 继续按现象查找。

Shadowrocket 全平台下载