官方手册 · 功能介绍

Shadowrocket 功能与常用设置

先确认 Global Routing,再核对 Config 与服务器。本页按“是什么、在哪里、怎么设、注意什么”解释常用功能,适用于 iPhone 与 iPad 上的日常配置和排查。

01 · 连接模式

Global Routing:先决定路由方式

Global Routing 决定流量采用哪种整体处理方式。配置、代理、直连是中文说明,对应界面中的 Config、Proxy、Direct;它们不是三个不同的服务器。

界面选项 作用 何时使用 首先核对
Config(配置) 按当前配置的规则及策略处理请求。 需要区分域名、地址或其他匹配条件时。 生效的 Config、规则顺序、最终策略。
Proxy(代理) 让由客户端处理的流量统一采用代理路径。 临时检查所选服务器及代理路径是否可用时。 Home 中所选服务器、连接参数及服务状态。
Direct(直连) 让由客户端处理的流量统一采用直连路径。 临时核对当前网络的直接访问情况时。 当前网络能否访问同一目标。

在哪里切换,怎样选择

在 Home 找到 Global Routing,进入后选择所需模式,返回确认当前显示值。已有分流配置且希望按规则访问时,使用 Config;需要检查服务器是否能建立可用连接时,可短暂切换到 Proxy;需要对照本地网络时,可用 Direct 做一次同目标测试。完成排查后恢复原先计划使用的模式,避免把临时测试状态留作日常设置。

注意 Global Routing 与连接开关是不同层级:前者决定处理方式,后者控制客户端连接状态。选中 Proxy 不代表服务器一定可用,选中 Config 也不代表配置中的每条规则都已经正确。若切到 Proxy 后可访问、回到 Config 后失败,应优先检查规则与策略;但这只是缩小范围的线索,不能仅凭一次结果断言故障原因。

02 · 匹配与策略

规则分流:先匹配,再决定去向

规则描述“什么请求采用什么策略”。在 Config 中核对当前生效的配置,再确认 Global Routing 已选择 Config。

规则类型回答“匹配什么”

DOMAIN 匹配完整域名;DOMAIN-SUFFIX 匹配域名后缀及其子域;DOMAIN-KEYWORD 按域名中的关键词匹配。IP-CIDR 与 IP-CIDR6 分别描述 IPv4、IPv6 地址范围;GEOIP 根据 IP 地理数据库匹配。

USER-AGENT 针对可供匹配的 User-Agent 信息,并不是所有请求都能提供这一条件。不要把它理解为任意应用都可用的应用识别开关;具体可用信息与请求类型、配置有关。

策略回答“如何处理”

PROXY 表示采用代理策略,DIRECT 表示直连,REJECT 表示拒绝。配置也可能引用自定义策略组名称,此时需要继续检查该组实际选择了什么,而不是只看规则末尾的名字。

规则通常自上而下匹配,应把较具体的条件放在宽泛条件前面。FINAL 是前面均未命中时的兜底策略;把它设为拒绝或指向不可用路径,可能影响大量没有专门规则的请求。

怎样设置与验证

在 Config 先确认生效文件,修改前保留可恢复的副本。新增规则时同时核对类型、匹配值与策略,保存后重新发起目标请求,再通过记录检查实际命中项。一次只调整一条规则,避免同时改变 DNS、服务器和最终策略。右侧仅演示语法,其中的示例域名不是服务地址,PROXY 也不会自动提供服务器。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY
FINAL 前序规则未命中时使用;此片段不代替完整配置。

查看规则关键字与策略术语 ›

03 · 连接资料

Subscribe 与服务器管理

订阅用于导入和更新已有的服务器条目;单个服务器条目用于保存一次连接所需的参数。导入成功只说明资料进入列表,不等于远端连接已经验证成功。

Add Server:手动核对参数

从 Home 的添加入口进入 Add Server,先选择与已有资料一致的协议类型,再填写地址、端口和对应的认证字段。Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2 的字段和传输条件并不相同,不能只替换类型名称而保留其余参数。

若资料通过二维码提供,可用 Scan QR Code 导入后再检查字段。尤其注意服务器地址、认证信息、TLS 与服务器名称等内容是否与原始资料一致;导入方式不会替用户判断服务是否仍有效。

Subscribe:更新已有列表

添加订阅时,在相应添加界面选择 Subscribe,填入自己已有的完整订阅地址并保存,再执行更新。之后回到 Home 检查分组内是否出现条目,并明确选择要使用的服务器。更新列表与选中服务器是两个动作,不能只完成前者就开始判断连接效果。

订阅地址可能包含访问凭据,应按敏感资料保管。列表为空时先检查复制是否完整,再核对订阅状态及返回内容格式;不要连续重复添加同一地址。更新可能改变条目名称或列表内容,重要的手动修改应提前记录。

Connectivity Test 不是实际使用结果

在 Home 的服务器列表使用 Connectivity Test,可以辅助检查当前条目在选定测试方式下的响应情况。测试前先看 Settings 中的 Test Method;不同方法测量的对象不同,数值不适合直接混为一谈。较小的延迟不保证所有目标都能访问,也不等于持续传输速度更快。应在选中服务器后,用实际需要访问的目标再验证一次。

整理服务器时,建议用便于辨认的名称区分用途,并保留原始参数的安全备份。删除条目之前确认它是手动添加还是由订阅生成;对于订阅生成的条目,应从订阅管理逻辑理解后续更新结果。不要把 Config 配置文件与服务器订阅混淆,前者可以包含规则和其他设置,后者主要用于更新服务器资料。

04 · 连接触发

On Demand:按条件决定连接行为

是什么:On Demand 用于按照所设条件触发连接行为,适合已经确认手动连接正常、希望在网络环境变化时按预期处理连接的情况。它不是服务器可用性保证,也不负责修复错误的认证资料或规则。

在哪里:在 Settings 中找到 On Demand 相关入口,检查总开关和当前可配置的条件。具体选项以应用内显示为准。首次涉及系统 VPN 配置时,应阅读系统授权提示;系统层面的连接条件与应用内的设置需要一并核对。

怎么设:先记录原有状态,再添加确有需要的网络条件,逐项确认条件对应的连接行为。设置后分别在匹配与不匹配的网络环境下测试,并观察连接状态是否符合预期。若条件涉及 Wi-Fi 网络名称,应核对拼写,避免因名称不一致而误判设置没有生效。

注意什么:启用后,手动断开可能仍受既有触发条件影响。遇到“断开后又连接”的情况,先回查 On Demand,再检查系统 VPN 设置,不要立即删除整份配置。临时停用时记录原开关状态,排查结束后按实际需要恢复;若只有网络切换时异常,应把切换前后的条件和连接状态分别记下。

05 · 用量观察

Data:查看客户端流量记录

Data 用于观察客户端记录的流量变化。它帮助判断是否产生了数据传输,但不能单独证明目标请求已成功完成。

在哪里看,怎样读

进入 Data,先确认界面标注的统计对象、时间范围及是否包含历史累计,再观察上传、下载等项目。为了看清某次操作的变化,可以先记下当前数值,完成一次明确的访问后返回对照,而不是只看累计总量是否很大。

如果界面提供重置统计的操作,执行前先确认是否需要保留记录。排查时更适合记录“测试前后增加了多少”,不要频繁清空后又把不同测试混在一起。

与其他账单分开理解

Data 是客户端视角的记录,不等同于移动网络运营商或已有服务的计费用量。不同统计范围、协议开销、后台请求与累计周期都可能造成差异,不能仅凭两个总数不同就认定某项计费有误。

流量增加也可能来自其他后台活动;流量不增加则可能与请求没有经过当前路径、连接未建立或观察范围不符有关。应结合 Global Routing、连接状态和请求记录一起判断。

06 · 常用设置

Settings:按问题修改对应项

以下项目从 Settings 及其相关入口核对。配置文件也可能包含影响连接的参数,因此修改设置前应同时确认当前 Config,避免把不同来源的设置当成同一项。

DNS:域名解析路径

是什么、在哪里:DNS 将域名转换为连接所需的地址。检查 Settings 中的 DNS 相关设置,同时查看当前 Config 是否定义了解析参数;具体生效关系以应用当前配置为准。

怎么设、注意什么:先保留现有设置,再按已有网络方案调整解析方式。出现部分域名无法访问时,应区分解析失败与地址可得但连接失败,不要一次更换多个解析选项。只改 DNS 不能修复过期认证或不可用服务器,错误的自定义值反而可能扩大故障范围。

Test Method:测试方式

是什么、在哪里:在 Settings 找到 Test Method,它决定相关连通性测试采用的方式。它改变的是测试过程,不会把服务器本身的线路条件改得更好。

怎么设、注意什么:按当前排查目的选择界面提供的方法,然后返回 Home 执行 Connectivity Test。记录结果时一并记录方法;比较服务器时保持测试方式和网络环境一致。超时只能说明该测试未在条件内得到响应,不应直接推断所有实际请求都一定失败。

Today Widget:快捷查看与操作

是什么、在哪里:Today Widget 用于系统支持的小组件入口,相关选项在 Settings 中核对。是否显示、可以操作哪些项目,还与当前系统支持及系统侧添加情况有关。

怎么设、注意什么:先在应用内完成服务器选择和连接验证,再到系统的小组件编辑入口添加可用组件。若组件状态未及时变化,先打开应用核对真实连接状态,不要只根据组件文字判断连接结果。快捷入口不能替代首次授权,也不会补齐缺失的服务器参数。

iCloud:同步相关资料

是什么、在哪里:iCloud 相关入口用于应用支持范围内的同步或云端资料操作。先检查 Settings 内的对应选项,再确认系统的 iCloud 账户和权限状态;不同资料类型应分别核对。

怎么设、注意什么:在已有本地备份的前提下启用所需项目,等待同步后,到另一设备逐项确认资料是否到位。不要默认服务器、Config、统计及所有开关都会完整同步。云端资料同步也不等于 App Store 已购项目恢复,两者需要分别检查。

Diagnostics:先收集线索,再修改配置

是什么、在哪里:Diagnostics 是检查连接相关状态的诊断入口,在 Settings 中找到后按当前界面提供的项目执行。诊断信息用于缩小范围,不是对实际使用结果的承诺。

怎么设、注意什么:在问题发生时记录网络类型、Global Routing、所选服务器及现象,再运行相关检查。保存结果时保留必要的错误信息,分享前移除订阅地址、认证字段和其他私人资料。若每次检查都更换网络或配置,结果就难以互相对照;优先保持条件一致,再逐个验证假设。

设置核对清单

正常使用时不必逐个开启所有功能。更稳妥的顺序是先把基础连接验证清楚,再添加规则和自动连接条件。每一阶段都保留一个已经验证过的状态,后续出现异常时才有明确的恢复点。

  1. 确认资料:服务器类型、地址和认证参数与已有资料一致;Subscribe 已成功更新,且 Home 中选中了预期条目。
  2. 确认模式:Global Routing 与当前用途一致。使用 Config 时,再检查实际生效的文件、规则顺序和 FINAL。
  3. 确认访问:使用实际目标验证,不只依赖 Connectivity Test 或 Data 的数值。把测试时间、网络环境和表现一起记录。
  4. 再设自动化:基础连接稳定后再调整 On Demand、Today Widget 和 iCloud 相关选项,分别验证,不把多个变化合并测试。
  5. 保留恢复点:修改 DNS 或规则前保留原值,出现新问题先恢复最近一项变更,再用 Diagnostics 收集线索。

需要从首次打开开始操作,可阅读Shadowrocket 使用教程;遇到列表为空、连接后无法访问等具体情况,可转到常见问题。购买与已购项目恢复请查看App Store 正版获取说明,不要把应用购买、服务器资料和云端同步视为同一件事。

下载 Shadowrocket