Shadowrocket 官方手册 / 功能与设置

Shadowrocket 代理模式

先在 Home 确认 Global Routing,再检查规则、服务器和连接条件。遇到访问异常时,每次只改一项,用同一个目标复测。

Global Routing
连接如何处理
On Demand
连接何时启动
Data
记录了多少流量
01 路由方式

Global Routing 三种模式

在 Home 打开 Global Routing,可以选择配置(Config)、代理(Proxy)或直连(Direct)。它决定进入客户端处理范围的流量怎么走,不负责选择连接何时启动,也不会改写 Config 中保存的规则。以下以这些界面词为索引;不同平台的入口位置以实际界面为准。

按流量处理方式和测试场景选择
模式处理方式何时选用
配置(Config) 按当前启用的配置匹配规则,再执行命中的策略。 需要按域名或地址分别处理连接时使用。先核对实际启用的配置,再确认目标命中了哪条规则。
代理(Proxy) 不逐条按配置分流,将进入该模式处理范围的连接交给所选代理服务器。 已有服务器并需要单独验证它能否访问某个目标时短时使用。测试结束后恢复日常模式。
直连(Direct) 在客户端仍处于连接状态时,不通过代理服务器转发相应流量。 用于对照当前网络能否直达目标。若要验证完全停用客户端时的表现,需另行关闭连接。

例如,某个站点在 Proxy 下可访问、在 Config 下却失败,应先查看它是否命中了预期的策略,而不是直接更换服务器。反过来,如果同一目标经代理失败,但直连正常,再检查服务器信息和代理路径。对照时保持同一 Wi-Fi 或蜂窝网络,并重新发起请求;已有连接可能沿用切换前的路径。

Proxy、Direct 是模式;PROXY、DIRECT 是配置里的策略。选中全局模式与某一条规则命中策略,不是同一项操作。

02 匹配顺序

规则类型与分流策略

在 Config 找到当前启用的配置,打开它的规则列表,再回到 Home 确认 Global Routing 为 Config。规则描述的是匹配条件和处理结果:DOMAIN 匹配具体主机名,DOMAIN-SUFFIX 匹配指定域名及其子域,DOMAIN-KEYWORD 按主机名包含的字符串匹配,范围更宽。只想处理一个主机时,先用 DOMAIN,避免把名称相近的其他主机也纳入规则。

IP-CIDR 和 IP-CIDR6 分别匹配 IPv4、IPv6 网段;GEOIP 根据地址的地理归类匹配,不是根据域名后缀判断。USER-AGENT 则取决于是否能读到相应请求标识,不能假定所有连接都会提供这个信息。若目标既可能通过域名发起,也可能直接使用地址,复测时要区分两种访问方式。

PROXY 将匹配的连接交给代理,DIRECT 直接连接,REJECT 拒绝连接。下面只演示规则顺序:具体主机走直连,同一域名下的其他主机走代理,其余请求由 FINAL 兜底。

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

规则通常按顺序检查,命中后采用对应策略。把示例中的前两条对调,docs.example.com 就会先匹配到更宽的后缀规则。修改前保留一份原配置,具体规则放在宽泛规则之前,最后再核对兜底策略。保存后确认生效的是刚编辑的文件;如果只在预览中改动或仍启用另一份配置,后面的访问测试就无法验证这次修改。

03 已有连接资料

订阅导入与服务器管理

订阅用于维护一组已有的服务器条目;手动添加服务器适合只配置一个已知端点。手上若是服务商给出的订阅地址,在 Home 打开 Add Server,选择 Subscribe 后填入地址并保存。若已有单个服务器的参数,则在 Add Server 选择与资料一致的协议,再填写地址、端口及该协议所需字段。不要把订阅地址填到单个服务器的地址栏。

导入完成后,回到 Home 的服务器列表确认条目已经出现,再选择一条进行 Connectivity Test。测试结果与测试方法和目标有关;测试通过后,还要在准备使用的 Global Routing 模式下访问实际目标。若失败,先复核协议及地址、端口等原始资料,再区分是单条服务器出错,还是同一订阅里的多条记录同时失败。

刷新订阅前记下正在使用的条目;远端更新后,名称、地址或条目数量可能改变,旧条目不一定仍可选。订阅地址可能包含访问凭据,不要把完整链接贴到共享文档、公开截图或诊断记录里。本站只说明如何使用你已有的订阅或服务器信息,不提供、销售或推荐这些服务。

04 连接条件

On Demand 按需连接

On Demand 按设定的网络条件触发连接,并不是每次访问时临时选择一条分流规则。先在 Home 用手动方式确认连接正常,再到 Settings 查找 On Demand,按当前平台显示的条件设置适用范围。先从一个容易复现的场景开始,例如从 Wi-Fi 切换到蜂窝网络,再检查连接是否按预期启动。

复测时同时关注触发和不触发两种场景。如果手动断开后连接又恢复,先核对当前网络是否仍符合 On Demand 的触发条件;需要测试纯手动连接时,可暂时关闭按需连接,排查结束后再恢复。出现频繁重连或待机耗电变化时,先留意网络是否反复切换,并用相近的时间段比较,再决定是否缩小触发范围。

05 流量观测

Data 流量统计

在 Data 查看客户端记录的流量,先确认界面显示的是累计值还是某个统计区间,以及当前看到的是上传还是下载。若要判断一次操作增加了多少流量,可以先记下起始读数,再在同一个网络下完成一次可重复的访问,最后记录结束读数。相比直接清空统计,这样既能保留历史,也便于将差值与操作时间对应起来。

后台同步、媒体预加载和重复请求都可能使数字继续增长。若同一时段内有多个应用活动,总量差值不能单独证明某次请求占用了多少流量。Data 反映的是客户端的统计口径,不等同于系统蜂窝用量或服务商账单;要核对某次访问采用了哪个策略,应回到规则匹配或诊断记录,而不是从流量数字推断。

06 设置与排查

Settings 常用项

先记录当前设置和值,再针对症状修改。解析异常查 DNS,测试结果不一致查 Test Method,自动重连查 On Demand。不要同时改动多项,否则即使连接恢复,也很难判断是哪项设置起了作用。

DNS:域名解析

DNS 决定域名如何解析。在 Settings 查看当前设置,也核对已启用的 Config 是否定义了解析选项。网络原本可用时,保留当前值即可;需要改动时,先确定异常发生在普通域名还是仅在局域网名称,然后一次只替换一项,用同一网络和同一域名复测。已有连接或缓存可能使结果不会立刻变化;解析成功也不代表后续连接一定能建立。

Test Method:连通性测试方法

Test Method 用来选择连通性测试的方式。到 Settings 查看可用选项,再回到 Home 对同一条服务器执行 Connectivity Test。比较多个条目时保持方法、目标和网络条件一致;不同方法测量的环节不同,读数不宜直接比较。低延迟也不能代替实际访问验证,尤其不能据此判断吞吐量。

Today Widget:快捷访问

在支持这一入口的设备上,Today Widget 用于从系统小组件查看状态或使用界面提供的快捷操作。先在 Settings 检查该项,再到系统的小组件界面添加。若面板状态没有及时更新,以打开 Home 后看到的连接状态为准;要改路由模式或确认当前配置,仍应在客户端内操作。

iCloud 同步:跨设备使用配置

需要在支持 iCloud 的设备间使用同一份配置时,先在 Settings 核对同步选项及实际同步范围,再确认设备使用的是预期的账号。启用前保留重要配置的副本,选择一份容易辨认的配置验证另一台设备是否收到。文件出现不等于已启用,也不代表连接权限随之迁移;接收端仍需核对当前配置并单独测试连接。

Diagnostics:定位连接失败

在 Settings 打开 Diagnostics,用一个明确的目标复现问题,并记录发生时间、网络类型和当时的 Global Routing。如果工具显示请求记录,按可见信息区分域名解析失败、规则走向不符和服务器连接失败;只凭一条超时记录,不能断定服务端故障。对外分享之前,删去订阅地址、账号字段、私有域名和不必要的访问记录。

查阅 Settings 设置详解 →

全平台获取与使用说明

iPhone / iPad 版从 App Store 产品页获取,美区 $2.99 一次性付费,购买后可在 iPhone 和 iPad 上使用,系统要求以 App Store 页面标注为准。Mac(Apple 芯片 / Intel)、Windows、安卓和 Linux 版免费,安装包通过本站 /dl/ 提供。核对商店条目时,请查看开发者 Shadow Launch Technology Limited、官方图标和应用 ID 932747118。

客户端一次性买断 ≠ 线路套餐。 配置连接时,请使用自己已有的服务器资料或订阅。首次设置按使用说明操作;需要下载或查看各平台的安装与首次打开放行步骤,前往全平台下载页。