官方手册 · 功能与设置

Shadowrocket
代理模式与设置详解

日常使用先选 Config,再检查配置规则与当前服务器。临时诊断才切换 Proxy 或 Direct;改动设置时一次只调整一项。

适用 iPhone / iPad / Mac / Windows / 安卓 / Linux。下文路径以 iPhone / iPad 为例,其他平台请按对应界面查找同名功能;选项位置与可用范围以当前客户端为准。

先区分模式、规则与服务器

Shadowrocket 的连接结果不是由一个开关单独决定。Global Routing 决定整体处理方式,Config 中的规则决定哪些请求走哪种策略,Home 中选中的服务器则为需要代理的连接提供实际出口。三者各有职责:切换服务器不会自动修正错误规则,更新订阅也不等于切换当前配置。

开始前应已持有自己的订阅或服务器信息。本站不提供、不销售、不推荐节点或订阅。客户端一次性买断 ≠ 线路套餐;客户端的获取费用与用户已有线路的可用状态是两回事。

Global Routing 三种姿态

配置对应 Config,代理对应 Proxy,直连对应 Direct。中文用于说明,操作时认准英文选项。

是什么:Global Routing 是整体路由方式的选择,不是服务器协议设置。在哪里:在 Home 查找 Global Routing。怎么设:日常按规则处理流量时选择 Config;需要对比代理与原始网络表现时,再短暂使用 Proxy 或 Direct。

选项处理方式适用情形检查重点
Config按当前配置中的规则决定连接策略。日常规则分流;按域名或地址区分访问方式。当前配置是否正确、规则顺序是否合理、策略目标是否可用。
Proxy将客户端接管的流量按代理模式处理。临时判断问题是否来自分流规则。当前服务器能否连接;不要将它理解为覆盖设备上的所有流量。
Direct将客户端接管的流量按直连模式处理。临时比较原始网络与代理路径。原始网络能否访问目标;该模式不等于关闭连接开关。

注意什么:若某个网站在 Proxy 下正常、在 Config 下异常,可以优先检查命中的规则与策略;这只是排查线索,不能直接认定配置有错,因为 DNS 解析与已建立连接也可能影响结果。切换模式后重新发起请求,必要时结束旧连接,再进行同条件对比。

排查结束后恢复原来使用的模式。长期停留在 Proxy 会改变原本的分流行为;长期停留在 Direct 则可能让需要代理的请求直接访问。模式切换也不能补齐缺失的服务器参数,TLS、传输方式与认证信息仍需正确。

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

先判断请求命中哪条规则,再看该规则指定了什么策略。

规则类型决定匹配对象

DOMAIN 匹配指定域名,DOMAIN-SUFFIX 匹配域名及其子域,DOMAIN-KEYWORD 按域名中的关键词匹配。IP-CIDR 与 IP-CIDR6 分别描述 IPv4、IPv6 地址范围,GEOIP 按地址所属地区匹配。USER-AGENT 涉及请求中的对应字段,其适用范围取决于流量是否可被识别,不能当作所有加密连接的通用识别方法。

策略决定连接处理方式

DIRECT 表示直接连接,PROXY 表示按对应代理策略处理,REJECT 表示拒绝连接。规则也可能引用配置中定义的策略组,此时还要核对组名和组内选择。FINAL 用于处理未命中前序规则的请求;它不是更高优先级的强制规则,通常应放在规则列表末尾。

在哪里:进入 Config,确认正在使用的配置,再查看或编辑其中的规则。怎么设:先保留配置副本,将范围较小、意图明确的规则放在通用规则之前。规则通常从上到下匹配,命中后按对应策略处理;因此同一域名的具体规则若被更早的宽泛规则覆盖,放在后面就不会达到预期效果。

DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

上面仅示范语法与顺序:example.com 及其子域走 PROXY,随后按 GEOIP 规则判断,其余交给 FINAL。它不是适合所有网络的完整配置。修改后应对目标域名发起新请求,并结合连接记录核对策略,不能只看首页是否显示已连接。

注意什么:有些地址类规则依赖解析结果,DNS 设置也会影响匹配。不要遇到一个异常就连续添加多条相似规则;先检查域名是否准确、目标策略是否存在,再排除规则顺序与缓存因素。更多关键字可查阅概念速查。

订阅与服务器管理

Subscribe 管理批量来源,Add Server 管理单个服务器参数。

是什么:订阅是用于取得和更新服务器列表的来源;单个服务器则包含协议、地址、端口及认证等连接参数。订阅更新通常刷新该来源下的条目,并不代表服务器一定可用,也不代表 Config 中的分流规则已经更新。

在哪里:在 Home 通过添加入口查找 Subscribe;手动添加使用 Add Server,二维码导入使用 Scan QR Code。怎么设:将自己服务商提供的完整订阅链接填入对应字段,保存并更新列表,再选择需要使用的服务器。手动添加时先选协议,再按已有信息填写地址与认证参数;VLESS、VMess、Trojan 等协议的字段不能互相套用。

  1. 导入前确认信息完整,尤其注意复制时是否混入空格、换行或说明文字。
  2. 导入后检查分组与条目名称,确认内容属于预期来源,避免重复导入同一份订阅。
  3. 需要更新时对相应订阅执行更新;若客户端提供自动更新选项,再按实际需要开启。
  4. 选中服务器后执行 Connectivity Test,并使用实际请求验证;测试通过不等于所有目标都能访问。

注意什么:订阅链接可能包含个人认证信息,不要放入公开截图、日志或讨论内容。由订阅生成的条目可能在更新时被覆盖,确需长期修改的参数应先保存独立副本,并确认与后续维护方式兼容。删除订阅前也应确认是否需要保留其中的服务器,避免把“更新”误操作成“移除”。

列表为空时先检查来源链接和返回内容,再检查自己的服务状态;列表存在但连接失败时,则转向服务器参数和网络检查。两类问题发生的位置不同,不应通过反复重新导入混在一起处理。具体导入顺序见入门指南。

On Demand 按需连接

控制何时尝试建立连接,与规则决定请求走向是两个层次。

先建立可用的手动连接

是什么:On Demand 利用系统支持的条件触发连接行为。在哪里:在 Settings 查找 On Demand,具体可配置条件以当前系统与客户端显示为准。怎么设:先关闭自动触发,手动确认服务器、Config 与连接授权均正常,再逐项添加需要的按需条件。

再验证触发与停止条件

注意什么:启用后,手动断开可能因条件仍成立而再次触发连接,这不一定是开关失效。测试时记录当前网络条件,分别检查进入条件与离开条件后的结果。需要暂时停止自动连接,应先调整或关闭 On Demand,再操作连接开关,避免将重复触发误判为服务器故障。

网络切换并不保证已有连接完全保持不变。Wi-Fi 与蜂窝网络之间的变化可能导致重新建立连接,后台行为也受系统调度影响。On Demand 不能修复失效的订阅或服务器,更不能替代规则配置;完成触发测试后,仍需确认实际请求采用了预期策略。

Data 流量统计

是什么:Data 用于观察客户端记录的流量情况,帮助判断某段使用期间是否产生请求,以及流量分布是否符合预期。在哪里:打开 Data,按当前界面提供的统计维度查看;不同平台的细分项目与统计周期可能不同。

怎么设:先确认页面显示的是累计值还是当前周期数值,再进行一次可复现的访问并对比前后变化。若准备重置统计,应先记录需要保留的数字,避免清空后失去问题发生时的参照。观察下载与上传时要区分方向,不把瞬时速率和累计流量混为一谈。

注意什么:客户端记录、设备系统记录与服务商记录可能使用不同计数范围,协议开销、连接时间和统计周期也可能不同,因此 Data 不能直接当作线路计费账单。出现流量增长只能说明有活动,不能据此证明某个网页请求一定成功;没有增长时也要先核对是否查看了正确周期与记录范围。

Settings 常用项

先记录原值,再单项修改;配置内设置与全局设置要一起检查。

DNS:域名解析

是什么:DNS 将域名解析为地址,是连接与部分规则判断的前置步骤。在哪里:在 Settings 查找 DNS,同时检查当前 Config 是否包含相关配置。怎么设:先确认实际生效的来源,再按网络环境填写可达的解析服务,保留原值以便回退。

注意什么:不要仅凭“连接失败”就更换 DNS。域名解析成功与目标连接成功是不同阶段;修改后还可能受缓存或旧连接影响。若问题只涉及 IPv6,应检查地址与路径是否匹配,不要同时改动 DNS、协议和规则。

Test Method:测试方法

是什么:Test Method 决定相应连通性测试采用的方式。在哪里:在 Settings 查找 Test Method,与 Home 的 Connectivity Test 配合使用。怎么设:选用当前界面提供的方法,在同一网络、同一服务器与相近时间内比较结果。

注意什么:不同方法测量的对象不完全相同,数值不能直接混比。测试超时可能与测试目标有关,测试成功也不能代表每个网站或应用都正常。最终仍应以实际目标请求和诊断记录作为判断依据。

Today Widget:快捷入口

是什么:Today Widget 是系统支持时提供的快捷操作入口。在哪里:在 Settings 查找 Today Widget,并在系统允许的组件管理界面检查是否可添加。怎么设:按当前显示的选项配置,先在应用内验证连接,再测试组件操作。

注意什么:组件能否添加、刷新及显示哪些内容受系统版本限制。若当前系统未提供对应入口,不必寻找不存在的开关;从 Home 完成连接操作即可。组件显示可能滞后,排查连接状态时应返回应用确认。

iCloud:配置同步

是什么:iCloud 相关功能用于在支持的 Apple 设备间保存或同步客户端允许的数据。在哪里:在 Settings 查找 iCloud,并检查系统中的 iCloud 权限与账号状态。怎么设:操作前先保留本地副本,确认是上传、恢复还是同步,再按界面提示执行。

注意什么:同步范围以界面说明为准,不默认所有服务器凭据与运行状态都会同步。多设备编辑可能产生覆盖或冲突,应先确定要保留的副本。此处的 iCloud 功能不等于跨所有平台共享配置,也不是恢复 App Store 购买记录的入口。

Diagnostics:定位失败阶段

是什么:Diagnostics 提供当前客户端支持的诊断信息,帮助区分解析、连接、认证或规则处理等阶段的问题。在哪里:在 Settings 查找 Diagnostics;如果当前平台将诊断放在其他位置,以实际界面为准。怎么设:通常先按需开启或执行相关诊断,复现一次问题,再查看对应时间段的结果。

  1. 记录问题发生的网络环境、Global Routing 选项、当前 Config 与服务器,先建立可比较的条件。
  2. 只访问一个明确目标,记录出现错误的时间和提示,避免同时运行大量测试造成干扰。
  3. 先查看域名能否解析,再看连接是否建立;出现认证或 TLS 提示时,回查服务器参数与设备时间。
  4. 若仅 Config 下异常,检查规则与策略;若 Proxy 下也异常,再检查服务器和网络路径。

注意什么:诊断结果是线索,不是自动修复结论。不要把某一条超时信息直接解释成整个网络不可用。需要保留记录时先检查其中是否包含订阅链接、服务器地址或认证信息,分享前删除敏感部分;完成排查后,将临时增加的记录选项恢复到合适范围。

常用设置检查顺序

按层检查,比同时重置多项设置更容易复现与回退。

  1. 确认来源。已有订阅能否更新,服务器字段是否完整,是否误选了旧条目。
  2. 确认模式。日常使用是否为 Config,临时测试后是否忘记恢复。
  3. 确认配置。当前启用的 Config 是否是刚修改的文件,策略名称是否存在。
  4. 确认解析与路径。分别检查 DNS、服务器连通性与实际目标请求,不用单个测试数字代替所有判断。
  5. 确认自动行为。On Demand 是否重新触发,iCloud 或订阅更新是否覆盖了本地修改。
  6. 记录与回退。每改一项就复测,记录有效变化;没有改善时恢复原值,再检查下一层。

如果尚未完成第一次导入,先阅读入门指南;需要理解规则关键字时查阅概念速查;遇到商店获取、系统安装或已购恢复问题,则前往全平台下载说明和常见问题。这些问题与 Global Routing 的职责不同,不需要通过重写规则解决。