官方手册 · 功能与设置

Shadowrocket 代理模式

先确定 Global Routing,再检查 Config 与服务器。连接开关、请求采用的策略和最终能否访问,是三个需要分别验证的环节。

模式选择 规则匹配 设置验证

以下以 iPhone / iPad 常见界面为操作参照;不同平台的入口位置和可用设置可能不同,以当前应用显示为准。Shadowrocket 提供 iPhone / iPad、Mac(Apple 芯片与 Intel)、Windows、安卓和 Linux 版本,获取入口见全平台下载。

模式选择

Global Routing 三种模式

配置、代理、直连分别对应界面中的 Config、Proxy、Direct。模式决定请求如何选择路径,不等同于连接开关。

是什么:Global Routing 是整体路由方式的选择入口。在 Home 中找到 Global Routing,进入后查看当前勾选项。初次设置时,应先导入已有服务器并确认可用,再决定日常使用哪一种模式;不要为了尝试不同选项而同时更换服务器、DNS 和配置文件。

界面选项请求处理方式适用情形检查重点
Config(配置)依照当前启用配置中的规则选择策略。日常按域名、地址或其他条件分流。配置是否启用、规则顺序与策略引用是否正确。
Proxy(代理)整体采用代理路径,具体处理仍受应用及平台能力约束。短时对照测试,判断问题是否与规则选择有关。选中的服务器是否可连接,目标服务是否可访问。
Direct(直连)整体采用直接连接的路径。检查本地网络,或临时进行直连对照。本地网络及目标服务自身是否正常。

如何选择与恢复

已有经过确认的规则配置时,通常从 Config 开始。若某个目标在 Config 下失败,而同一服务器在 Proxy 下可以访问,应回到规则与策略检查,不必立即重导订阅。若 Direct 也无法访问本应直连的目标,先检查 Wi-Fi、蜂窝网络或目标服务状态。每次只改变一个条件,记录对照结果,结束测试后恢复原计划使用的模式。

注意什么:选择 Direct 不等于关闭连接,选择 Proxy 也不保证目标服务一定可用。系统仍可能显示连接状态;判断请求走向应结合请求记录,而不是只看系统状态图标。排查时还要区分新请求与已经建立的连接,切换后重新发起访问再观察。

匹配条件与执行策略

Config 与规则分流

规则类型描述“匹配什么”,策略描述“匹配后怎么处理”。两者不能互相替代。

规则类型如何区分

在 Config 中查看当前配置的 Rule 内容。DOMAIN 用于精确域名,DOMAIN-SUFFIX 用于域名后缀,DOMAIN-KEYWORD 用于域名关键字。IP-CIDR 与 IP-CIDR6 描述地址范围,GEOIP 按地址对应的地区数据匹配;其结果受数据和解析情况影响,不能把它当作网站所属地区的保证。

USER-AGENT 是否能够匹配,取决于请求中是否存在可供检查的相应信息。不要假定所有连接都能提供它。添加规则前先明确目标请求实际使用的域名或地址,避免把页面显示名称误当成请求域名。

策略如何区分

DIRECT 表示直接连接,REJECT 表示拒绝,PROXY 表示交由相应代理策略处理。配置也可能引用自定义策略名称,因此规则中出现的名称必须与配置中定义的策略对应。仅在规则末尾写入一个名称,不会自动创建可用服务器或策略。

处理误匹配时,应先确认命中了哪条规则,再决定修改匹配值还是策略。若目标被 REJECT 命中,更换服务器通常不会改变结果;若规则引用的策略不可用,则需要检查该策略自身的成员与选择状态。

规则顺序与验证方法

以下仅是规则语法样张,不是完整配置,也不提供服务器信息。example.com 用于说明后缀匹配,实际配置应使用你需要处理的目标。

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

规则通常按顺序检查,先命中的规则决定请求采用的策略。具体规则应放在覆盖范围更大的规则之前,FINAL 用作前面没有匹配时的最终处理。编辑前保留当前可用配置的副本,在 Config 中确认新配置已经启用,然后将 Global Routing 设为 Config,重新访问目标,并在请求记录中对照命中规则与策略。

注意什么:远程配置更新可能覆盖本地改动。需要长期保留的自定义内容,应结合当前应用提供的配置管理方式单独维护。保存成功只说明内容已写入,不说明规则已经被选中或目标请求一定经过该条规则。

连接信息管理

订阅与服务器管理

Subscribe 管理一组服务器的更新来源,Add Server 管理具体连接信息;Config 则负责规则与相关配置。

导入与手动添加

是什么、在哪:在 Home 中查看已有服务器及其分组,通过添加入口进入 Add Server。已有订阅链接时使用应用支持的 Subscribe 入口;已有单台服务器信息时,按对应协议填写。二维码可通过 Scan QR Code 导入,但扫描前仍需确认内容来自你的服务商。

怎么设:订阅链接从你的服务商处获取,完整保留其中的路径、查询参数和大小写,粘贴前后检查是否混入空格或换行。手动添加时,先选协议,再逐项填写服务器地址、端口和该协议要求的认证、传输及 TLS 参数。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等协议的字段并不相同,不应直接套用另一种协议的填写方法。

导入完成后,先确认 Home 出现服务器条目,再选择一个条目进行 Connectivity Test,并尝试实际访问。订阅导入成功意味着获得了列表,不代表其中每台服务器都可用;Connectivity Test 有结果也不代表所有网站都能访问,两类验证需要分别进行。

更新、重命名与删除

订阅内容发生变化时,对相应订阅执行更新,再检查服务器数量、分组和当前选择是否改变。更新失败时先确认本地网络可以访问订阅地址,再核对链接是否失效、返回内容是否为应用可识别的格式。错误页面、登录页面或普通网页不能当作服务器订阅导入。

注意什么:批量清理前区分订阅生成的条目与手动添加的条目。订阅更新可能重建其管理的内容,不宜依赖对自动生成条目的临时修改。订阅地址通常含有访问凭据,截图、日志与求助信息中应遮盖完整链接及认证字段;不要把它粘贴到公开评论或不必要的检测工具中。

查看订阅导入与首次连接教程 →

连接触发条件

On Demand 按需连接

On Demand 处理何时建立连接;Global Routing 与规则处理建立连接后如何分流。

是什么、在哪:On Demand 用于依据所设条件触发连接。在 Settings 中查找 On Demand 或对应的按需连接设置入口,查看当前条件和开关状态。可配置条件应以当前平台实际显示为准,不要将其他设备上的设置列表视作本机必有选项。

怎么设:先关闭自动触发的干扰,手动连接并确认服务器、DNS 与规则都能正常工作,再设置按需条件。如果当前界面提供针对 Wi-Fi、蜂窝网络或指定网络的条件,逐项确认哪些情况下连接、哪些情况下不触发。保存后在可控环境下切换一次网络,观察连接是否符合预期,再测试目标请求采用的策略。

注意什么:On Demand 不是服务器故障修复工具。手动连接已经失败时,开启它只会重复遇到相同问题。若关闭连接后又自动连上,先检查按需条件及系统中的相关连接设置,不要立即删除配置。临时排查时记录原条件并暂停自动触发,排查结束后再恢复,避免把预期中的自动连接误判为异常。

用量观察

Data 流量统计

统计用于观察客户端记录的传输情况,不能替代服务商用量或运营商账单。

是什么、在哪:打开 Data 查看应用提供的流量统计,先阅读当前页面标注的统计范围与时间范围,再比较上传、下载或不同类别的数据。若某个平台把相关内容放在其他入口,应以实际界面名称和说明为准。

怎么用:排查某次操作是否产生流量时,先记录当前值,只进行一次明确操作,再回到 Data 查看变化。长期观察前应确认计数是否跨连接保留、是否存在重置选项,以及本次重置会影响哪些记录。不同范围的数据不要直接相减后认定为某个应用的精确用量。

注意什么:协议开销、重传、统计口径与计费周期都可能造成差异。Data 有增长只能说明应用记录到了传输,不能单独证明某个网页请求通过了指定服务器。需要核对分流时仍应查看请求与策略;怀疑后台用量异常时,再结合系统的应用网络用量和电池记录进行对照。

常用项逐项说明

Settings 常用设置

先保留能够正常连接的基线。下面各项应分别调整,调整后使用相同目标进行验证。

DNS

是什么、在哪:DNS 负责把域名解析为地址;相关设置可能位于 Settings 或当前 Config 的配置内容中。先确认正在使用哪份配置,以及该配置是否定义了 DNS,避免只改全局入口却忽略配置中的相关设置。

怎么设、注意什么:从当前可工作的解析方式开始,只在有明确需求时切换到自定义 DNS 或 DNS over HTTPS。填写后用同一域名重新发起请求,对照解析结果、访问结果与记录。DNS over HTTPS 端点自身也必须可达,它不会自动修复错误的规则、认证信息或不可用服务器。详细取舍见DNS 设置说明。

Test Method

是什么、在哪:Settings 中的 Test Method 用于选择连接测试的方法。不同方法观察的是不同环节;测试结果应连同所选方法一起阅读,不能只比较一个孤立数值。

怎么设、注意什么:对照服务器前保持测试方法、测试目标与本地网络一致,再执行 Connectivity Test。端口可连接不等同于完整代理请求成功,测试目标可访问也不等同于其他目标可访问。若测试与实际体验不一致,先核对测试方法和目标,再查看实际请求记录,不应据此频繁更换全部设置。

Today Widget

是什么、在哪:Today Widget 是相关平台提供的快捷查看或操作入口。在 Settings 查找对应设置,并在系统提供的组件管理界面确认是否可以添加;不同系统版本的呈现方式可能不同。

怎么设、注意什么:先在应用内完成服务器选择和连接验证,再配置组件中实际可用的项目。添加后测试一次快捷操作,并返回应用核对当前状态。组件显示可能存在刷新间隔,不宜把未及时更新的文字当作连接失败的唯一依据;组件缺失时先检查当前系统与应用是否提供该入口。

iCloud 同步

是什么、在哪:iCloud 相关设置用于应用支持的数据同步或备份能力。在 Settings 查看具体说明,同时检查系统的 iCloud 权限、账户和可用存储。同步范围以应用明确列出的项目为准,不假定所有数据都会迁移。

怎么设、注意什么:首次启用前保留本地可用配置,先在一台设备完成上传或同步,再在另一台核对内容。遇到冲突时先辨认哪份是需要保留的内容,避免连续覆盖。同步不等于持续有效的独立备份,删除动作也可能传播;服务器凭据与订阅链接应按敏感数据管理。

Diagnostics

是什么、在哪:Diagnostics 提供定位连接与请求问题的辅助信息。进入 Settings 中的相应入口,先查看工具实际检查的对象和当前输出,不把单项诊断结果扩大解释为整个网络的结论。

怎么用:记录发生问题的目标、当前 Global Routing、选中的服务器以及网络类型,再复现一次。检查是域名解析失败、连接超时、认证失败还是策略选择不符合预期,随后只调整对应环节。相同故障在不同网络出现时,也应分别记录,不要混在同一次诊断里。

注意什么:导出或分享前检查日志中是否含有服务器地址、订阅链接、认证字段及个人访问记录,按最小必要范围提供。需要进一步定位时,可按症状进入排查手册;不需要为了求助公开完整配置。

设置后的检查

按顺序验证配置

把“服务器可用”“模式正确”“规则命中”分开确认,能够减少反复改动。

  1. 检查输入。在 Home 核对服务器或订阅是否已导入,协议字段是否完整;不要只看条目名称判断导入正确。
  2. 检查连接。使用一致的 Test Method 执行 Connectivity Test,再发起实际请求。测试失败时先定位服务器、本地网络或认证信息。
  3. 检查模式。在 Global Routing 确认 Config、Proxy 或 Direct 是当前准备验证的模式,避免测试结束后遗留临时选择。
  4. 检查配置。使用 Config 时确认正确的配置处于启用状态,核对规则顺序、策略引用与最终处理。
  5. 检查自动行为。最后恢复 On Demand 等自动触发项,切换网络复测一次,确认自动连接与分流均符合预期。

如果一次修改后出现异常,先恢复上一步的可用设置,再按单一变量重新验证。需要从导入开始操作时,阅读首次使用教程;已经能够连接但个别目标失败时,优先阅读按症状组织的排查手册。客户端下载与安装问题统一在全平台下载页处理,不需要通过修改规则解决。

Shadowrocket 官方下载