官方手册 · 功能与设置

Shadowrocket 代理模式
与常用设置

先确定请求由哪种方式处理,再调整规则、连接与诊断选项。Global Routing 决定整体处理方式,Config 决定规则细节,服务器信息决定实际连接目标。

Shadowrocket 是仅在 Apple 平台通过 App Store 发行的付费闭源商业应用。本页主要说明 iPhone 与 iPad 上的操作;系统要求以 App Store 页面标注为准。

01 · 请求处理方式

Global Routing:Config / Proxy / Direct

先选整体姿态,再观察具体请求,不把模式选择与连接开关混为一件事。

是什么,在哪里设

Global Routing 是整体路由方式的选择入口,通常从 Home 进入。本文将三种常用姿态称为配置、代理、直连,界面选项仍分别保留 Config、Proxy、Direct。切换这里不会替你填写服务器地址,也不会让失效的认证信息恢复有效;它解决的是“请求按什么方式处理”,不是“连接信息从哪里来”。

选项中的 Config 与底部的 Config 页面有关联,但作用不同:前者表示按当前配置处理流量,后者用于管理和编辑配置文件。仅仅保存了一份规则文件,并不能证明当前连接已经按那份文件分流,还需要确认所选文件与 Global Routing 的状态。

界面选项 处理方式 何时使用 需要核对
Config 依据当前配置中的规则和策略处理请求。 日常按域名、地址或其他条件分流。 当前配置、规则顺序、策略目标与最终兜底规则。
Proxy 以代理方式处理流量;实际行为仍受应用及系统网络边界影响。 临时核对所选服务器是否能处理目标请求。 服务器可用性,以及该服务器到目标服务的连接情况。
Direct 以直接连接方式处理流量。 比较本地网络路径,排查代理路径相关的问题。 本地网络是否本来就能访问目标,以及 DNS 是否仍有自定义设置。

怎么切换,怎么比较

先在 Home 确认所选服务器,再进入 Global Routing 选择需要的姿态。比较时使用同一个目标、同一类请求,必要时重新建立连接,避免旧连接复用影响观察。若 Proxy 下可用而 Config 下异常,下一步应检查规则命中和策略选择;若两者都异常,应继续检查服务器信息、本地网络与 DNS,而不是反复更换规则。

Direct 适合做路径对照,但不应被理解为关闭所有网络相关设置。DNS、已有连接以及系统行为仍可能影响结果。完成临时测试后,恢复原先打算使用的姿态,并检查连接开关;不要把测试时的状态长期留在日常配置里。

02 · 匹配条件与策略

规则分流:先匹配,再决定处理方式

规则类型说明“匹配什么”,策略说明“匹配后怎么处理”。

在 Config 中检查当前配置

规则分流用于让不同请求采取不同的处理方式。进入 Config,确认当前使用的文件,再查看其中的规则与策略。通常按顺序匹配,先命中的规则决定该请求的处理方式,因此一条宽泛规则放得过早,可能让后面的精确规则没有机会生效。调整前先保存原配置,随后只移动或修改与问题目标有关的少量规则。

DOMAIN 匹配指定域名;DOMAIN-SUFFIX 匹配域名后缀及其子域;DOMAIN-KEYWORD 根据域名中的关键词匹配,范围可能比预想更大。IP-CIDR 与 IP-CIDR6 分别描述地址网段;GEOIP 根据地址归属数据库判断,不等同于服务的注册地或使用语言。涉及域名与地址转换时,还要考虑 DNS 解析结果。

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

以上只是语法阅读示例,不是一份完整配置。PROXY 表示交给代理处理,DIRECT 表示直接连接,REJECT 表示拒绝;如果规则引用自定义策略名,该策略必须在当前配置里存在。FINAL 是前面条件都未命中时的兜底,放置位置和目标策略都需要检查。

注意匹配条件的适用范围

USER-AGENT 依赖请求中可供匹配的信息,不能假设每个请求都具有相同的可见字段。不要仅凭某条规则的名字判断它必然生效。出现偏离预期的请求时,先查看可用的连接记录,核对目标域名、地址及所用策略;确认 Global Routing 为 Config 后,再检查规则顺序和引用关系。规则解决的是路径选择,不会修复目标服务自身的错误。

远程规则与订阅服务器是两类不同内容。更新服务器列表不代表规则也随之更新;更换配置文件也可能改变策略名。若需要系统整理配置之间的关系,可继续阅读订阅与服务器管理手册,先建立清晰的来源与用途记录,再做批量调整。

03 · 连接信息

Subscribe 与 Add Server

订阅用于集中管理已有服务器信息,手动添加用于逐项核对字段。

Subscribe:导入已有订阅

在 Home 通过添加入口进入 Add Server,选择 Subscribe,并粘贴自己已有的订阅链接。保存后执行更新,检查是否生成服务器条目,再选择实际需要使用的一项。订阅链接与单条服务器分享链接不是同一种内容;若导入结果异常,先确认填写入口是否与内容类型一致,再检查链接是否完整。

为多个订阅设置能辨认用途的备注,避免只看排序位置选择。更新会根据远端返回内容调整条目,手动改动的名称或参数可能被后续更新覆盖。执行更新前记下当前选中项,更新后重新确认选择,不要把“更新完成”视为每个服务器都能正常连接的证明。

Add Server:手动核对字段

已有独立服务器信息时,在 Add Server 选择对应的 Type,再填写地址、端口及该协议要求的认证字段。Shadowsocks、VMess、VLESS、Trojan、WireGuard、Hysteria2 等协议的参数并不通用;应逐项按已有资料填写,而不是只改 Type 后沿用上一组内容。

若资料包含 TLS、服务器名称或传输相关字段,应保持与服务器端配置一致。保存成功只表示本地条目已建立,并不等于认证和连接均已通过。先做 Connectivity Test,再实际访问目标;出现问题时保留原始资料进行对照,避免在多个字段之间同时试改。

扫码、剪贴板与多订阅整理

使用 Scan QR Code 或剪贴板导入前,确认内容来自自己已有的服务器资料。导入后检查协议、地址、端口及备注,二维码识别成功不代表参数一定完整。订阅链接、分享内容与配置备份可能含认证信息,不应放入公开截图或诊断说明;展示问题时仅保留必要的字段名称。

整理多订阅时,先按用途区分,再做测试和排序。删除订阅前确认操作会影响哪些关联条目,并保存仍需保留的个人配置。订阅更新与 App Store 应用更新各有作用:前者改变服务器资料,后者更新客户端,不能互相替代。

04 · 条件触发连接

On Demand 按需连接

先建立可重复的手动连接,再配置自动触发条件。

是什么,怎么设置

On Demand 用于按已配置的条件触发 VPN 连接。它解决的是何时建立连接,而 Global Routing 与 Config 负责连接建立后如何处理请求。可在 Settings 中查找 On Demand 相关设置,具体可用条件以当前应用界面为准。先明确希望在哪类网络环境下触发,再启用对应条件;不要为了自动连接而一次打开所有选项。

设置前应先手动选择服务器、确定 Global Routing,并完成一次实际访问验证。随后配置 On Demand,在切换 Wi-Fi 或蜂窝网络后观察系统连接状态和应用内状态是否符合预期。测试时还应记录当前网络条件,避免把服务器暂时不可用误判为触发条件没有工作。

注意断开后的自动行为

启用按需连接后,手动断开不一定意味着连接会持续保持断开;当条件再次满足时,系统可能重新发起连接。排查“断开后又连接”的现象,应先查看 On Demand,而不是重复删除配置。若需要暂停自动行为,先关闭相应条件,再观察一次完整的网络切换过程。

On Demand 不负责判断所有网站是否可用,也不保证服务器持续在线。它仍受系统调度、网络环境以及有效配置影响。调整规则或服务器时,可暂时停止自动触发,以免自动重连干扰比较;验证完成后再恢复原来的条件。

05 · 用量观察

Data 流量统计

统计用于观察应用记录范围内的流量,不作为外部计费依据。

在哪里看,怎样理解变化

进入 Data 查看当前界面提供的流量统计,先辨认统计对象、时间范围与重置状态,再比较数值变化。不同统计项可能采用不同口径,不能把一次连接的数据、某个服务器的数据与设备整体网络用量直接画等号。系统网络、传输开销和外部服务的计量方式也可能造成差异。

需要判断某次操作是否产生流量时,先记录起始状态,再执行一个明确的访问动作,最后返回 Data 查看变化。测试过程中尽量减少其他应用的后台活动。这里的累计用量不是速度测试结果:数值增加只说明记录范围内发生了传输,不能据此判断带宽、响应质量或所有请求都按预期分流。

重置与排查时的注意事项

若界面提供重置操作,先保存需要比较的记录,再执行重置;不要把清空统计当成修复网络的方法。流量持续增长而目标页面打不开时,仍需检查请求是否命中正确策略、DNS 是否成功以及服务器能否访问目标。反过来,统计没有明显变化,也可能是观察范围或已有缓存造成,不能单独作为连接失败的结论。

06 · 常用设置入口

Settings:解析、测试与诊断

以下项目按实际用途分别调整;入口和可用选项以当前应用界面为准。

DNS:先确认解析路径

DNS 负责把域名解析为地址。进入 Settings 查看 DNS 相关项,同时检查当前 Config 是否另有 DNS 配置,避免只修改一处却忽略另一处的影响。开始时保留能正常工作的设置;只有在明确出现解析失败、返回地址异常或需要指定解析路径时,再调整相关内容。

自定义 DNS 或 DNS over HTTPS 都需要可达的解析服务,并不天然比系统 DNS 更适合所有网络。修改时只更换一个变量,重新建立连接并访问同一目标,再根据解析记录判断是否改善。使用 DoH 也不等于所有请求都自动走代理;解析路径与目标连接路径要分别核对。

Test Method:统一测试口径

在 Settings 中找到 Test Method,选择当前界面提供、且适合当前网络的测试方式,再回到 Home 使用 Connectivity Test。不同方法检查的层次不同,测得的时间也不能直接跨方法比较。若使用需要目标地址的测试,先确认这个目标本身可访问,再观察服务器差异。

测试通过不等于所有服务都能访问,测试超时也不能直接证明整条连接完全不可用。要比较多个服务器,应保持方法、目标和本地网络一致,并结合实际请求判断。排序只是当时测试结果的排列,不是长期质量结论。

Today Widget:快捷入口与状态查看

Today Widget 相关选项用于配置系统提供的快捷查看或操作入口。先在 Settings 检查应用支持的项目,再按系统允许的位置添加。可用形式受系统环境影响,以实际显示为准;不要把某种系统布局视为所有设备都具备的固定界面。

快捷入口适合减少重复打开应用的步骤,但设置后应返回 Home 核对服务器、Global Routing 和连接状态。若快捷入口显示与应用内状态暂时不同,先打开应用重新确认,而不是直接修改服务器参数。连接是否建立与目标请求是否正常仍需分别验证。

iCloud:同步范围与恢复顺序

在 Settings 查看 iCloud 相关同步或备份选项,先读清楚当前界面标注的同步对象,再决定是否启用。同步配置不等同于恢复购买记录;应用获取和已购恢复仍通过 App Store 完成。不同设备上的系统权限与当前连接状态,也不应假设会随文件一起完整复制。

启用前先保存本地已有配置,尤其是在两台设备都做过修改时。恢复后逐项核对订阅、服务器选择和当前 Config,再手动验证连接。含订阅链接或认证字段的内容应按敏感资料管理;同步便利不能替代对备份范围及内容的检查。

Diagnostics:围绕一次问题收集线索

Diagnostics 用于查看或执行当前应用提供的诊断项目,可从 Settings 查找相关入口。开始前明确问题发生在哪一步:订阅无法更新、连接无法建立、域名无法解析,还是某个目标请求失败。先记录当前网络、模式及操作顺序,再运行与现象有关的检查。

一次只调整一项设置,复现后比较结果。诊断材料可能包含地址、域名、请求信息或认证相关内容,分享前应检查并遮去敏感部分。诊断工具提供的是线索,不是自动修复保证;若本地设置与已有资料一致,仍需继续核对服务器端状态和目标服务的可用性。

07 · 实际操作顺序

从连接信息到规则命中

按层检查,避免同时改变多个条件后无法定位原因。

  1. 确认连接资料。检查 Subscribe 更新结果,或逐项核对 Add Server 中的协议、地址、端口与认证字段;保存原始资料作为对照。
  2. 确认当前选择。在 Home 核对实际服务器与 Global Routing,不依赖上次使用时的记忆,也不把列表第一项当成当前选中项。
  3. 先验证连接,再验证分流。结合 Connectivity Test 与实际请求判断连接情况;使用 Config 时,继续核对配置文件、策略引用和规则顺序。
  4. 分别检查 DNS 与目标访问。解析成功和连接成功是两个环节。只在证据指向 DNS 时调整解析设置,避免用更换 DNS 掩盖其他问题。
  5. 最后恢复自动化。手动状态验证完成后,再启用 On Demand、同步与快捷入口,并观察网络切换后的实际行为。

需要从首次打开开始操作,可阅读入门指南;需要整理多个订阅与配置文件,可阅读订阅手册。涉及购买和设备兼容性时,前往App Store 正版核对页,按开发者 Shadow Launch Technology Limited、官方图标和应用 ID 932747118 核对;价格、系统要求及通用购买以 App Store 页面标注为准。

下载 Shadowrocket