官方手册 · 功能参考

Shadowrocket
功能与设置

先确定 Global Routing,再检查规则、服务器与 DNS。每次只改一项,用相同请求验证结果。

覆盖 iPhone、iPad、Mac、Windows、安卓与 Linux;下文以 iPhone / iPad 的英文界面词为操作示例,其他平台的入口位置及可用设置以实际界面为准。

  • Global Routing → 规则 → 策略
  • 一次修改一项设置
  • 以日志与实际请求验证

Global Routing 三种模式

模式决定请求是否交给配置规则判断,不等于选择了哪台服务器。

是什么:Global Routing 是整体路由方式。在 Home 打开 Global Routing,可选择配置、代理或直连,对应英文界面词 Config、Proxy、Direct。日常按域名和地址分流通常选择 Config;需要隔离规则影响时,才临时使用 Proxy 或 Direct 作对照。不要把“切换模式”和“启动连接”当成同一步,模式选好后仍需核对 Home 的连接状态。

界面选项请求处理方式适合场景检查重点
Config · 配置由当前配置的规则决定策略。日常分流、局域网直连、特定域名指定策略。当前配置、规则顺序与 FINAL。
Proxy · 代理以代理方式处理接管的请求,不按常规分流规则逐条决定。临时排查是否由规则导致路径差异。当前选中的服务器与实际可达性。
Direct · 直连以直连方式处理接管的请求。对照本地网络本身是否能访问目标。当前网络、目标服务与 DNS。

怎么设:先在 Config 确认要使用的配置,再回到 Home 将 Global Routing 选为 Config,选择已有服务器后开启连接。使用同一个目标发起一次新请求,检查日志中的命中规则及策略。测试时保留相同的网络条件,避免同时切换 Wi-Fi 与路由模式,否则很难判断哪项改动产生影响。

注意什么:Proxy 不是修复所有连接问题的开关,Direct 也不等于关闭系统中的 VPN 连接。模式只描述路由处理;系统接管范围、配置中的例外及平台网络机制仍会影响结果。排查结束后恢复原本使用的模式,避免临时设置一直保留。

规则类型与策略

规则回答“匹配什么”,策略回答“匹配后怎么处理”。

在 Config 编辑当前配置

是什么:规则分流按请求的域名、地址等条件选择处理方式。在 Config 找到当前使用的配置,通过其编辑入口检查 [Rule] 段。规则按从上到下的顺序判断,命中后使用该行策略,所以越具体的例外通常越应放在较宽泛的规则之前。

怎么设:DOMAIN 匹配完整域名;DOMAIN-SUFFIX 匹配域名及其子域;DOMAIN-KEYWORD 按域名中的关键词匹配。IP-CIDR 与 IP-CIDR6 分别匹配 IPv4、IPv6 网段;GEOIP 按地址归属数据匹配。USER-AGENT 依赖可获得的请求信息,不能假定所有连接都具备这一条件。

注意什么:PROXY 使用代理策略,DIRECT 直连,REJECT 拒绝请求。界面选项 Proxy 与规则策略 PROXY 的大小写不同,编辑配置时保持关键字原样。FINAL 是前面都未命中时的兜底,应放在末尾;过早出现会使后面的规则失去作用。

以上仅演示语法,不是适合所有网络的完整配置。修改前保存原配置副本,修改后重新发起请求并查看命中记录。已有连接可能继续复用原路径,因此不能只刷新一个已有长连接就认定新规则没有生效。需要完整的段落结构与匹配说明时,继续阅读配置大全。

订阅与服务器管理

服务器参数、订阅来源与配置文件是不同对象,分别维护。

Home、Add Server 与 Subscribe

是什么:服务器条目保存地址、端口、协议和认证信息;Subscribe 用于从用户已有的订阅地址获取服务器列表;Config 则保存路由规则等配置。导入订阅不代表自动获得适合当前需求的分流规则,切换配置也不等于替换服务器列表。

在哪与怎么设:在 Home 通过 Add Server 新增条目,按信息提供方给出的协议填写参数。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 需要的字段不同,不应只看名称相似就套用另一种协议的参数。已有二维码时使用 Scan QR Code;已有订阅地址时选择 Subscribe,核对地址后保存并执行更新,再从列表中选择条目。

  1. 导入前确认内容是单个服务器、订阅地址,还是配置文件,选择对应入口。
  2. 保存后检查条目数量与名称是否符合自己的预期,再运行 Connectivity Test。
  3. 选择一个条目实际连接,发起正常业务请求,确认可用后再整理旧条目。

注意什么:订阅更新可能覆盖从该来源生成的条目,手工修改前应考虑下一次更新的影响。订阅地址可能带访问凭据,不要放进公开截图、聊天记录或问题描述。Connectivity Test 的结果只是所选测试方法下的表现,不能替代实际访问验证;更新失败也不等于所有已保存服务器同时失效。

如需迁移配置,先区分配置导出与服务器信息导出,避免把包含凭据的内容当作普通规则公开分享。对不熟悉的配置先检查规则、DNS 和重写部分,再决定是否启用;不要仅凭文件名判断用途。

On Demand 按需连接

先验证手动连接,再增加自动触发条件。

是什么:On Demand 根据设置的网络条件请求系统建立连接,减少重复的手动操作。它控制的是何时发起连接,不负责判断某个域名应走 PROXY 还是 DIRECT;建立连接以后,请求仍按 Global Routing 与当前配置处理。

在哪与怎么设:在 Settings 中找到 On Demand,核对界面提供的 Wi-Fi、蜂窝网络或网络例外条件。先让手动连接成功,再只启用一个需要的条件;保存后切换到对应网络,观察系统连接状态,并用同一个请求验证。若要针对特定 Wi-Fi 设置例外,确认网络名称准确,且条件之间没有互相抵消。

注意什么:开启 On Demand 后,手动断开可能被符合条件的系统触发再次连接,这不一定是连接开关失效。希望暂停自动连接时,应先停用相关条件,再断开连接。遇到需要网页认证的 Wi-Fi,先完成网络登录再测试;系统权限、休眠与网络切换时机也可能影响触发过程,不能承诺任何情况下都立即重连。

Data 流量统计

先看统计范围,再比较数值;客户端记录不是服务商账单。

是什么:Data 展示客户端可记录的流量使用情况,可用于观察连接期间上传、下载的变化,并辅助定位持续产生请求的情况。统计范围取决于实际界面所标明的对象和时间范围,不应将一个页面中的合计直接理解为设备全部网络用量。

在哪与怎么用:打开 Data,先读清当前显示的统计范围及可用筛选项。排查异常用量时,记录测试前数值,暂停不相关应用的后台活动,只执行一次目标操作,再回到 Data 比较变化。如果界面提供重置入口,先保留必要记录,确认后再重置,避免丢失前后对照依据。

注意什么:协议封装、重试、统计周期和计量口径都会造成客户端数值与系统或服务商记录存在差异。订阅中显示的用量通常来自订阅响应所携带的信息,并不等于 Data 的本地累计;没有显示订阅用量,也不能据此判断订阅失效。流量增长只表示有数据传输,仍需结合请求结果与日志确认业务是否成功。

Settings 常用项

入口以当前平台界面为准;配置中已有的设置也要一起检查。

DNS:域名解析与配置来源

是什么与在哪:DNS 将域名解析为地址,既影响连接目标,也可能影响依赖地址的规则判断。在 Settings 查找 DNS 相关项,同时检查当前 Config 是否指定了解析设置,避免只修改一处却忽略实际生效的配置。

怎么设与注意事项:先保留当前可用设置,确认问题发生在域名解析还是后续连接,再决定是否调整解析方式。修改后用相同域名重新测试并查看日志,必要时按界面提供的操作清理相关缓存。不要同时改 DNS、服务器与规则;加密解析也需要可达的网络路径,填入一个解析地址不代表它一定能被访问。

Test Method:Connectivity Test 的测试方法

是什么与在哪:Settings 中的 Test Method 决定 Connectivity Test 如何检测条目。不同方法验证的层次不同,有的结果更接近基础连通性,有的还依赖测试目标的响应,不能把它们当作同一种指标直接比较。

怎么设与注意事项:比较多个条目时固定 Test Method、测试目标和本地网络,连续测试后再观察结果。超时可能来自服务器、测试目标或当前网络;显示可达也不保证所有目标服务可用。排查时先通过测试缩小范围,再用实际需要访问的业务确认,不以单个延迟数值作最终结论。

Today Widget:快捷查看与操作

是什么与在哪:Today Widget 用于在系统支持的组件入口查看状态或执行快捷操作。先在 Settings 检查相关设置,再按系统组件管理方式添加;具体可展示内容与操作能力以系统及当前应用界面为准。

怎么设与注意事项:完成主应用的权限与连接设置后,再配置组件并试用。组件显示可能受系统刷新时机影响,不能将暂未更新的状态当作最终连接结果。遇到显示与预期不一致时,回到 Home 检查当前状态;不要用重复点击组件的方式替代确认。

iCloud 同步:跨设备配置管理

是什么与在哪:在提供该选项的 Apple 设备上,Settings 的 iCloud 相关设置用于管理应用支持同步的内容。同步依赖系统 iCloud 状态、账户与应用权限,不能假定它包含服务器、配置、历史记录等所有对象。

怎么设与注意事项:先确认两台设备使用预期的 iCloud 账户,再阅读界面列出的同步范围。首次开启前分别保留本地副本,先在一台设备完成修改并等待同步,再到另一台核对,避免同时编辑产生覆盖或冲突。同步不等于独立备份,也不等于 App Store 的购买记录;配置迁移与应用重新获取应分开处理。

Diagnostics:收集排查依据

是什么与在哪:Diagnostics 提供用于连接排查的诊断信息,在 Settings 查找该入口。它的作用是帮助定位失败发生在解析、连接建立还是后续请求阶段,不是自动修复按钮。

怎么设与注意事项:先记录问题发生时的网络类型、Global Routing 和当前配置,再按界面提供的方式运行诊断或查看记录。为了让日志便于分析,只复现一次目标问题,不要同时进行大量测试。分享前移除服务器地址、订阅链接、认证信息和不必要的访问记录;保留错误类型与操作顺序即可,不应直接公开整份含敏感信息的记录。

设置后的检查顺序

将“能否连接”“如何分流”“是否自动触发”分开验证。

  1. 核对基础网络。先确认当前 Wi-Fi 或蜂窝网络本身可用,需要网页认证时先完成认证,记录测试所用的网络。
  2. 核对服务器信息。检查协议、地址、端口与认证字段,再运行 Connectivity Test;不要把测试失败直接归因于规则。
  3. 核对 Global Routing。需要规则分流时选 Config,确认启用的是刚编辑的配置,而不是名称相近的副本。
  4. 核对单次请求。发起新的目标请求,查看命中规则和策略;解析失败先查 DNS,命中不符再查顺序与条件。
  5. 最后验证自动化。手动连接稳定后才启用 On Demand,再检查网络切换、Today Widget 状态与 Data 变化。

如果改动后出现问题,恢复刚修改的一项,使用原测试条件再次验证。能稳定复现的前后差异比一次性调整多项参数更有参考价值。首次操作可阅读入门指南,需要逐行检查规则时使用配置大全,安装与获取问题则查看全平台下载说明。

切换到 Proxy 后可用,Config 下不可用,先查哪里?

先确认当前配置,再比较同一目标在 Config 下的命中规则与策略。检查是否被较早的 REJECT、DIRECT 或宽泛匹配截获,同时注意域名解析结果;不要在还未看清命中记录前直接替换整份配置。

关闭连接后又自动连接,怎样暂停?

先检查 On Demand 是否仍有符合当前网络的触发条件。暂停相关条件后再断开,并观察系统状态。若仍反复连接,再检查系统中其他与该连接有关的自动化设置。