官方手册 · 设置

Shadowrocket
功能与常用设置

先区分请求走哪条路径、连接何时开启,再核对服务器、DNS 与统计。一次只修改一类设置,保留可回退的配置。

  • Config / Proxy / Direct
  • On Demand
  • Data
  • Settings
01 · 请求路径

Global Routing:配置、代理与直连

Global Routing 决定请求采用哪种路由方式,不负责判断服务器是否有效。在 Home → Global Routing 选择 Config、Proxy 或 Direct,然后回到 Home 核对连接状态。

模式 请求如何处理 何时使用 优先核对
配置 Config 按当前启用配置中的规则与策略决定路径。 日常按域名、地址或其他条件分流。 配置是否启用、规则顺序、最终策略。
代理 Proxy 通常将请求交给当前选定的代理服务器;仍需留意系统及应用的处理边界。 临时核对服务器连通性,或对照排查分流规则。 服务器参数、所选服务器、网络可达性。
直连 Direct 请求通过当前网络直接访问目标,不经所选代理服务器转发。 建立当前网络的访问基线,或临时检查直连结果。 当前网络是否可访问目标、DNS 是否正常。

怎么选:日常用 Config,排查时做对照

已有完整配置时,先选择 Config,并在 Config 页面确认实际启用的文件。需要核对服务器时,可临时切到 Proxy,使用同一个目标重复测试;如果 Proxy 可用而 Config 不可用,应继续检查规则命中与策略指向,而不是立即修改服务器参数。测试结束后恢复日常模式,避免把临时排查状态长期保留。

Direct 不是关闭连接开关的同义词。客户端可能仍保持系统 VPN 配置处于连接状态,但请求采用直连路径。需要彻底停止当前连接时,应回到 Home 关闭连接开关;若 On Demand 随后又触发连接,还要检查按需连接条件。模式、连接状态与触发条件是三个不同层面,不能仅凭状态栏图标判断请求一定经过代理。

02 · 匹配条件

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

规则决定哪些请求使用哪种策略,位置在 Config 的当前启用配置中。每条规则通常由规则类型、匹配值和策略组成。常见策略包括 DIRECT、PROXY、REJECT,也可能指向配置中已定义的策略组。策略组名称不是协议名,写入规则前应确认对应目标确实存在。

DOMAIN 对应完整域名,DOMAIN-SUFFIX 对应域名后缀,DOMAIN-KEYWORD 按域名中的关键词匹配;IP-CIDR 与 IP-CIDR6 分别描述地址范围,GEOIP 按地址归属数据匹配。USER-AGENT 依赖客户端能够获取相应请求信息,并不适用于所有流量,不能把它当作通用的应用识别方式。

怎么设:先放具体条件,再检查 FINAL

配置中的规则通常按从上到下的顺序匹配,先命中的规则决定处理方式。新增一条针对特定域名的规则时,应留意它前面是否已有更宽泛的条件;FINAL 用于前面的规则均未命中时收尾,通常放在规则列表末尾。编辑前保存副本,启用后只访问一个明确目标,再结合连接记录核对结果。

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

以上片段仅用于说明语法,不是可直接替代完整配置的文件。第一条按域名后缀使用 PROXY,第二条让指定私有地址范围使用 DIRECT,最后一条处理其余请求。实际局域网访问还受系统路由、网络权限和配置选项影响;当规则结果与预期不同,应先查命中记录,再判断是否涉及解析阶段或地址匹配条件。

配置文件更新也可能改变规则内容。若通过远程配置更新后行为发生变化,应对照更新前后的规则顺序、策略名称与 DNS 设置,而不是只看文件名。需要了解字段与协议参数,可继续阅读协议参考;第一次建立连接则按使用说明逐步操作。

03 · 连接资料

Subscribe 与 SERVER:更新来源,核对当前选择

服务器是单条连接资料,订阅是更新这些资料的来源。本节以用户已有自己的订阅或服务器信息为前提。在 Home 的 SERVER 列表核对服务器;手动录入可进入 Add Server,先选 Type,再填写服务商提供的地址、端口、认证与传输参数。导入已有订阅时,在 Add Server 中选择 Subscribe,填入自己的订阅地址并保存,再等待列表载入。

怎么设:先确认类型,再核对参数

Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard 与 Hysteria2 所需字段并不相同。不能只把地址与端口填齐就认定配置完整;还应核对认证方式、TLS、服务器名称及传输设置。存在 QR Code 或分享链接时,可使用相应导入入口,但导入后仍应查看 Type 与关键字段是否与原始资料一致。

订阅更新成功只表示资料已获取并解析,不表示其中每个服务器当前都可连接。更新后回到 SERVER 检查数量、名称和当前选中项,再做 Connectivity Test 与实际访问测试。如果列表没有预期条目,应先确认订阅地址是否完整、是否有效,以及当前网络能否访问该地址;不要通过反复修改 Global Routing 来替代来源核查。

注意什么:避免混淆订阅与 Config

Subscribe 主要用于维护服务器资料,Config 还可能包含路由、DNS 与其他行为设置,两者不能仅凭链接外观互换。订阅更新可能覆盖受其管理的条目,对这些条目做手动修改前应保留记录。删除订阅或服务器前,也要确认当前配置中的策略是否仍引用它们,避免名称存在但实际连接目标已失效。

订阅地址与分享链接可能包含访问凭据,排查时不应公开完整内容。客户端一次性买断 ≠ 线路套餐;Shadowrocket 的购买与用户已有连接资料分别管理。本站不提供、不销售、不推荐节点或订阅,应用的唯一获取入口为 App Store,购买前可先查看正版核验说明。

04 · 连接触发

On Demand:按条件连接,不代替规则分流

On Demand 用于在满足条件时触发系统 VPN 连接,Global Routing 则决定连接后的请求路径。在 Settings → On Demand 检查总开关和已设置的条件;不同设备上的具体可选项以当前应用界面为准。先在 Home 手动连接并验证配置可用,再启用按需连接,能避免把服务器故障误判为自动连接条件有问题。

怎么设:从单一场景开始

先确定期望自动连接的网络场景,再设置对应条件,不要一次加入多个互相重叠的条件。保存后切换一次相关网络,回到 Home 检查连接状态,并访问固定目标。记录测试时使用的 Wi-Fi 或蜂窝网络、Global Routing 模式与服务器,才能判断自动触发与请求分流是否分别符合预期。

如果手动关闭后又出现连接,先检查 On Demand 是否再次满足触发条件,这不一定代表开关操作失败。需要临时停止自动连接时,应先调整 On Demand,再关闭 Home 连接。网络切换时的连接恢复受系统调度、网络质量与服务器状态影响,开启此功能不等于连接始终连续,也不保证所有后台请求都即时完成。

05 · 使用记录

Data:看统计范围,再解释流量变化

Data 用于观察客户端记录的流量与相关统计,不是服务商账户的计费凭证。进入 Data 后,先核对当前界面显示的统计范围、时间范围与分类,再比较上传和下载。若页面提供重置操作,应在重置前记录现有读数,避免把重置后的数值误认为历史累计。

怎么用:同一时间范围内比较

排查流量增长时,先停止大文件传输和后台同步,记录基线,再执行一次明确操作并观察变化。需要判断某类请求是否直连,应结合 Global Routing、规则命中与连接记录,而不能仅凭总流量上升得出结论。统计是否包含特定分类,以及各项的含义,应以 Data 当前显示的标签为准。

客户端计数、系统网络统计与服务商统计的采样时间、协议开销和计算口径可能不同,因此数字存在差异并不自动说明异常。Data 也不能确认订阅是否到期或剩余可用量;这些信息应回到用户已有服务的账户记录核对。若发现异常增长,先查看测试前后的活动与请求,再逐项排除后台下载和同步任务。

06 · 日常选项

Settings:DNS、测试方式、小组件与同步

这些设置处理不同问题。修改前记录原值,每次只改一项;具体入口与可用选项以当前应用界面为准。

DNS

解析设置要与请求路径一起核对

DNS 将域名转换为地址;网页打不开时,解析失败与服务器连接失败需要分开检查。先查看当前 Config 中生效的 DNS 相关配置,再核对 Settings 中相关选项。配置文件与应用设置可能共同影响解析行为,不应只修改一处就假定全部请求已使用相同解析路径。

调整时先保存原值,再访问固定域名,并在 Diagnostics 或连接记录中核对结果。只改一个解析参数后复测,避免同时更改模式、服务器与 DNS。解析成功也不表示后续连接一定成功;还需要确认目标地址可达、规则策略正确,以及服务器名称与 TLS 参数匹配。

Test Method

测试方式不同,结果不能直接混比

Test Method 决定 Connectivity Test 使用哪种检测方式。在 Settings → Test Method 选择当前界面提供的方式,再回到 Home 执行 Connectivity Test。若可设置测试目标,应先确认该目标本身稳定可达,并记录所选方式和网络环境。

测试成功表示相应检测条件得到响应,不代表每个网站或每类应用请求均正常。比较服务器时应固定同一测试方式、目标与网络,随后再做实际访问。某种方式失败但实际访问成功时,优先核对测试目标和检测机制,不要仅凭单次结果删除服务器资料。

Today Widget

小组件入口不等于实时状态页

Today Widget 用于配置系统小组件提供的快捷信息或操作。在 Settings 中查看 Today Widget 相关选项,再到系统的小组件编辑入口添加当前设备支持的项目。能够显示哪些内容、位于哪个系统区域,以应用与系统当前提供的界面为准。

先在 Home 完成服务器选择与连接验证,再使用小组件作为快捷入口。系统可能限制小组件刷新频率,看到旧状态时应打开应用确认,不要连续点击切换来试图强制刷新。小组件不替代 Config,也不能单独证明当前请求命中了哪条规则。

iCloud

同步前确认范围,变更前保留副本

iCloud 相关功能用于在支持的设备与账户环境中保存或同步应用提供的资料。先检查系统 iCloud 中的可用空间与应用访问权限,再查看 Settings 的 iCloud 相关选项;哪些资料参与同步,应逐项按当前界面的说明确认。

同步不应被视为所有配置都能自动恢复的保证。重要变更前应另存可回退副本,新设备使用前逐项核对 Config、服务器列表与连接结果。同步资料可能包含连接凭据,应保护账户访问与设备解锁。应用购买记录由 App Store 管理,与 iCloud 中的配置资料不是同一件事。

07 · 故障定位

Diagnostics:先收集现象,再修改设置

Diagnostics 是核对运行信息与诊断线索的入口,不是自动修复按钮。在 Settings 中进入 Diagnostics,查看当前提供的诊断项目;结合 Home 的连接状态、Connectivity Test 与相关记录,区分服务器连接、域名解析、规则匹配和目标访问问题。不同诊断项目的结果回答不同问题,不能用单项通过替代完整验证。

怎么查:建立可重复的最小测试

  1. 记录当前网络、所选服务器、Global Routing 模式与正在启用的 Config。
  2. 选择一个明确的访问目标,执行一次测试,保留错误现象与对应记录。
  3. 只改变一个变量,例如从 Config 临时切到 Proxy,再访问同一目标。
  4. 对照诊断记录判断变化,完成后恢复原模式,必要时回退刚才的修改。

如果同一服务器在多个目标上都失败,先检查地址、端口、认证信息与服务有效状态;如果只有 Config 模式失败,则优先检查规则与策略;如果域名解析失败,则单独核对 DNS。如果当前网络连基础访问都不稳定,应先处理网络本身,再继续客户端排查。

设置并不是越多越好。能通过固定网络、固定目标、单项变更复现的问题,通常更容易定位。若仍无法访问,可继续阅读开关已打开却无法上网的逐项排查,按服务器、模式、DNS 与规则顺序核对。

设置常见问题

选择 Direct 后,为什么系统仍显示 VPN 状态?

Direct 是 Global Routing 的请求路径选择,不等于关闭连接。需要停止当前连接时,应在 Home 关闭开关,并检查 On Demand 是否会再次触发。判断是否经过代理,应核对模式、规则与连接记录,不能只看状态栏。

改了规则没有效果,应该先看哪里?

先确认 Global Routing 为 Config,再确认修改的是当前启用配置。随后查看规则顺序、前面是否有更宽泛条件、策略目标是否有效,以及 FINAL 的设置。必要时重新建立测试连接,避免继续观察修改前已建立的连接。

订阅更新成功,为什么 Connectivity Test 仍失败?

订阅获取与服务器连通是两个环节。先核对当前选中服务器的参数与有效状态,再确认 Test Method、测试目标和当前网络。最后执行实际访问测试,判断是检测条件受限,还是连接本身存在问题。

换设备后,购买记录与配置会一起恢复吗?

购买记录与配置资料分别管理。先在 App Store 核对原购买记录,再按实际启用的同步或备份方式恢复资料;通用购买适用性与系统要求以 App Store 页面标注为准。恢复后还要检查服务器、Config 与 On Demand 条件。

前往 App Store