官方手册 · 设置参考

Shadowrocket 设置
路由、规则与连接核对

先确认 Global Routing 与当前配置,再调整 DNS 或自动连接。一次只改一项,并用相同目标复测,才能区分规则、服务器与本地网络的问题。

本页按 iPhone / iPad 的界面组织操作,其他平台的布局与可用选项以实际界面为准。Shadowrocket 提供 iPhone / iPad / Mac / Windows / 安卓 / Linux 版本;Mac 分为 Apple 芯片与 Intel 两种。

iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。客户端下载与各系统安装放行说明见客户端下载页,电脑与安卓等安装包统一由本站 /dl/shadowrocket/ 路径提供。

01 · 路由入口

Global Routing:配置、代理与直连

三种模式决定流量如何选择路径,不会替代服务器参数,也不会自动修复不可用的服务。

在 Home 打开 Global Routing,可以在 Config、Proxy、Direct 之间选择。日常使用通常先选 Config,让当前配置文件中的规则决定请求走向。选择模式后,还要核对 Home 中选中的服务器以及连接开关;模式名称本身并不表示连接已经建立。

界面选项主要作用适用场景核对事项
Config · 配置按当前配置中的规则与策略处理请求。需要区分域名、地址与默认路径的日常使用。Config 中选中的文件是否正确,规则顺序是否符合预期。
Proxy · 代理以代理路径处理流量,不按 Config 的常规分流意图逐条选择。临时判断服务器路径是否可用。当前服务器是否有效;本地网络资源可能受影响。
Direct · 直连以直连路径处理流量。临时对照本地网络的访问表现。Direct 不等于关闭连接开关,也不代表网络一定可达。

怎么设:先固定条件,再切换模式

先记录当前模式和服务器,选定一个需要验证的目标。在同一网络下先用 Config 测试,再短暂切到 Proxy 对照。如果 Proxy 能访问而 Config 不能,应优先检查规则命中与策略引用,而不是立刻重填服务器。若两种模式都失败,再检查服务器信息、DNS 与本地连接。

Direct 适合观察不经过代理路径时的表现,但不要把一次直连成功当成全部服务正常。不同目标可能依赖不同的解析与连接条件。完成对照后,恢复原先的 Config 模式,避免临时测试设置长期保留,造成局域网访问或日常分流与预期不符。

02 · Config

规则分流:先匹配条件,再执行策略

规则分流是在 Config 模式下,根据域名、IP 地址等条件为请求选择处理策略。进入 Config,先确认当前选中的文件,再打开该文件查看规则内容。导入过文件不代表正在使用它;修改了另一个文件,也不会改变当前连接的分流结果。

规则通常按从上到下的顺序匹配,先命中的规则决定后续处理。具体域名与局域网地址应放在适当位置,宽泛条件放后面,FINAL 用于接住此前没有命中的请求。不要仅凭某条规则“已经存在”就判断它会生效,还应检查它前面是否有更早命中的条件。

关键字匹配对象设置注意
DOMAIN指定的完整域名。适合精确控制单个主机名。
DOMAIN-SUFFIX指定域名及其子域名。不要写成完整网页地址或附带路径。
DOMAIN-KEYWORD域名中包含的关键词。覆盖面较宽,应留意意外匹配。
GEOIPIP 对应的地区分类。结果依赖解析得到的地址及所用数据。
IP-CIDR / IP-CIDR6IPv4 / IPv6 地址段。核对地址族与前缀长度。
FINAL此前未命中的请求。放在规则末尾,明确默认路径。

怎么设:用少量明确规则验证

下面的片段只演示语法与顺序,不是完整配置,也不包含可连接的服务器。PROXY 指向代理处理,DIRECT 指向直连,REJECT 用于拒绝匹配请求。若引用自定义策略名称,应确认该名称在当前配置中存在,不能只把示例中的名称复制进去。

[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

修改前保存原文件,修改后确认文件仍被选中,必要时重新建立连接,再访问目标并查看记录。浏览器现有连接可能继续复用旧路径,因此仅刷新页面未必足以验证新规则。更完整的匹配解释见规则关键字匹配逻辑。

03 · Home / Add Server

订阅与服务器管理

服务器条目保存连接所需的地址、端口、协议与认证信息;订阅则用于导入和更新一组服务器条目。操作以用户已有自己的订阅或服务器信息为前提。本站不提供、不销售、不推荐节点或订阅服务,客户端一次性买断 ≠ 线路套餐。

在 Home 使用添加入口进入 Add Server。单条服务器需要先选对 Type,再按已有资料填写参数;导入订阅时选择 Subscribe,填写已有订阅地址并保存。协议类型不同,所需字段也不同,不能把 VLESS 的字段机械套到 Trojan 或 Shadowsocks 上。

更新订阅与切换服务器不是同一操作

订阅更新用于重新获取列表,并不保证自动切换到你希望使用的条目。更新后应返回 Home 确认当前选择,尤其是原条目被移除或重命名时。订阅地址本身也不应填写到 Config 的文件地址位置:前者通常提供服务器列表,后者负责规则与配置内容,二者应按来源说明分别处理。

删除订阅前先确认是否还需要其中的条目;在订阅生成的条目上手动修改参数,后续更新可能重新覆盖这些内容。订阅地址、二维码和认证字段可能包含访问凭据,截图与分享排障信息前应遮挡。完整导入流程可按首次使用教程逐步操作。

04 · 自动连接

On Demand:按条件触发连接

On Demand 用于按设定条件触发 VPN 连接,不负责替你挑选可用服务器,也不改变规则的匹配顺序。在应用的 On Demand 设置入口检查可用条件;具体入口与条件项目可能随系统和应用界面调整,以设备实际显示为准。

怎么设:手动连接通过后再启用

先关闭自动触发,确认当前服务器、Config 与手动连接能够正常工作。随后进入 On Demand,根据实际需要设置网络条件,再启用功能。如果界面提供 Wi-Fi 名称条件,应逐字核对网络名称;网络更名后,原条件也需要重新检查,不要凭记忆认为它仍会匹配。

验证时应实际完成一次网络变化,例如在符合与不符合条件的网络之间切换,再观察系统 VPN 状态和应用连接记录。仅在设置页打开开关,不能说明条件已经正确命中。测试过程中保持服务器和配置不变,才能判断变化是否来自 On Demand。

其他 VPN 配置与系统网络状态也可能影响触发结果。出现连接循环时,先停用 On Demand,恢复一次稳定的手动连接,再逐项恢复条件。自动触发并不保证网络始终可用,睡眠唤醒、网络切换以及服务器状态变化仍需单独核对。

05 · 用量观察

Data:观察流量,不代替服务账单

Data 用于查看应用记录的流量统计。打开 Data 后,先读清当前页面展示的统计范围、时间或连接对象,再观察上传与下载变化。不同统计口径之间不宜直接相减,更不能把应用记录当成服务商的结算结果。

怎么用:固定时间窗口观察变化

需要判断某次操作是否产生流量时,先记录当前数值,再保持其他应用活动尽量稳定,执行一次明确访问,随后回到 Data 查看变化。如果界面提供重置统计功能,重置前应记录需要保留的信息;重置客户端统计不会改变服务端记录,也不会恢复任何服务额度。

有流量只说明发生了数据传输,不代表目标内容一定加载成功;没有明显增长,也可能与缓存、已有连接或观察对象不一致有关。应把 Data 与访问记录、Global Routing 和实际结果一起看。发现异常增长时,先确认后台应用活动与当前网络,不要仅凭累计数字判断某个服务器存在问题。

06 · Settings

常用设置:每次只改一个变量

入口以当前界面为准。部分选项依赖系统能力或当前配置,排查时先确认实际生效位置,而不是同时改动多个相似开关。

DNS:确认域名如何得到地址

DNS 负责把域名解析为连接所需的地址。先在 Settings 检查 DNS 相关选项,再到当前 Config 查看是否定义了 dns-server 等设置,避免只改了一处却忽略另一处。记录原值后,再按所用网络与配置要求调整;不要为了排障一次填入多个来源不明的地址。

设置后使用同一域名复测,结合记录区分解析失败与连接失败。IP 能通而域名不能通,可把解析作为重点检查方向,但仍需留意 TLS 与目标服务对域名的依赖。下面是配置中使用系统解析的语法示例,并不是适用于所有网络的推荐结论。

[General]
dns-server = system

Test Method:明确 Connectivity Test 测了什么

Test Method 用于选择连接测试的方式,可在 Settings 中核对,再回到 Home 执行 Connectivity Test。不同方式关注的网络环节不同,因此切换方法后,结果不应直接与此前数值比较。若界面允许设置测试目标,应使用明确且能正常响应的目标。

测试通过不等于所有网站都能访问,测试失败也不能单独证明认证信息错误。保留测试方式、目标和网络条件,再结合一次实际请求检查。批量测试时应等待结果完成,避免连续触发造成结果难以区分。

Today Widget:快捷查看与操作入口

Today Widget 是系统支持时可使用的快捷入口。先在 Settings 查看相关设置,再按系统提供的小组件添加流程配置。能显示哪些状态、能否执行操作,取决于当前系统和应用实际提供的能力,不应把小组件上的旧状态当成即时连接记录。

初次使用应先打开主应用完成配置与必要授权,再测试小组件。若显示与主应用不一致,先返回 Home 确认当前连接,随后检查系统中的组件设置。服务器参数、规则编辑和诊断仍应回到应用内完成。

iCloud:先辨认同步范围,再处理覆盖

在 Settings 查看 iCloud 相关入口,同时检查系统中当前 Apple 账户与应用的 iCloud 使用权限。同步前先确认界面列出的对象,不要默认服务器列表、规则文件、统计和所有偏好都会同步。不同设备的可用项目应以实际显示为准。

首次在另一台设备启用前,保留本机的重要配置。若出现内容不一致,先停止两端同时编辑,确认要保留哪一份,再按界面提供的操作处理。同步不等于独立备份,误删后的状态也可能继续传播;含认证信息的文件应按敏感资料管理。

07 · Diagnostics

诊断与复原:从失败环节定位设置

Diagnostics 用于收集和查看排障信息,可从 Settings 中的相关入口查找。进入后按当前界面提供的工具检查连接、解析或请求记录。诊断信息只能帮助缩小范围,不应在没有对应证据时,把所有失败都归结为 DNS、规则或服务器中的某一项。

怎么查:保留最小可重复过程

  1. 确认当前状态。记录网络类型、Global Routing、选中的服务器和 Config 文件,先排除修改了非当前文件的情况。
  2. 复现一个目标。只执行一次明确访问,记住发生时间,避免多个应用同时测试使记录混杂。
  3. 辨认失败阶段。先看是否得到地址,再看连接与认证是否继续,最后核对规则选择的策略是否符合预期。
  4. 修改一项并复测。保留前后结果;没有改善就恢复原值,再检查下一项,而不是叠加多项不确定修改。

如果 Proxy 可用而 Config 不可用,优先检查规则与策略;如果更换网络后恢复,重点比较网络条件与解析;如果导入后始终连接失败,重新核对原始服务器资料。上述现象只是排查方向,最终仍应以当前请求记录和重复测试为依据。

分享诊断内容前,应遮挡服务器认证字段、订阅地址中的凭据、个人域名与其他敏感信息。不要直接发送整份含凭据的配置文件。恢复时优先使用修改前保存的文件与设置记录,重新核对 Config、Global Routing 与 On Demand,最后再确认一次实际访问。

改完规则没有变化,先检查哪里?

先确认 Global Routing 为 Config,再检查 Config 中选中的文件、规则顺序及策略名称。重新建立连接并发起新请求,排除旧连接复用后,再看对应记录。

Data 有流量,为什么页面仍打不开?

流量可能来自连接尝试、其他应用或已建立的连接。应核对具体请求的解析、策略与连接结果,不能只用累计流量判断目标访问是否成功。

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

先检查并停用 On Demand 的触发条件,再关闭连接。随后观察系统 VPN 状态;需要恢复自动连接时,再逐项启用条件并验证。

继续查阅:首次配置按教程操作;商店、开发者与购买记录核对见正版指南。