官方手册 · 功能与设置
Shadowrocket 功能与设置
先确定 Global Routing,再核对服务器与 Config。按场景调整 On Demand、DNS 和测试方式,用 Data 与 Diagnostics 验证结果。
- Global Routing:Config / Proxy / Direct
- 规则按顺序匹配
- 每次只改一个设置
Global Routing:配置、代理与直连
Global Routing 决定当前连接采用哪一种路由方式。在 Home 中打开 Global Routing,可选择配置、代理或直连,对应界面词为 Config、Proxy、Direct。它控制的是整体处理方式,不是服务器协议,也不是连接质量档位。更换服务器后,仍应单独确认这里的选择。
日常需要按域名或 IP 分流时,先在 Config 中确认已选中的配置文件,再使用 Config。临时判断问题是否出在规则上时,可以短暂切换 Proxy 或 Direct,对同一个目标重复测试。测试结束恢复原来的模式,避免把临时排查状态留作日常设置。
| 模式 | 处理方式 | 何时使用 | 需要核对 |
|---|---|---|---|
| 配置 · Config | 按照当前 Config 的规则与策略处理连接。 | 日常按目标分流,或验证某条规则是否生效。 | 活动 Config、规则顺序、规则指向的策略。 |
| 代理 · Proxy | 将受客户端处理的连接交给当前代理选择。 | 临时检查当前服务器能否完成目标访问。 | 服务器可用性、协议参数与目标响应。 |
| 直连 · Direct | 将受客户端处理的连接直接送往目标。 | 检查本地网络到目标的直接访问情况。 | 本地网络、DNS 与目标本身是否正常。 |
Direct 不等于关闭连接开关,也不等于系统已经移除了 VPN 配置。Proxy 同样不代表所有应用请求都必然成功;服务器出口、目标服务和当前网络仍会影响结果。判断问题时,分别记录“开关状态”“Global Routing 模式”和“目标能否访问”,不要把三者混成一个结论。
规则分流:匹配条件、顺序与策略
规则描述“什么连接交给什么策略”。在 Config 中打开正在使用的配置,检查规则与策略定义;新增或修改后保存,并确认该文件处于选中状态。仅把文件导入列表,并不等于它已经用于当前连接。Global Routing 也应设为 Config,才能按当前配置核对规则分流。
匹配条件与策略是两部分。DOMAIN、DOMAIN-SUFFIX 等关键字用于描述目标;DIRECT、REJECT 或配置中存在的代理策略名称用于描述处理方式。策略名称必须与实际配置一致,不能只根据名称猜测它指向哪台服务器。规则通常从上向下匹配,较精确的例外应放在较宽泛的条件前面。
| 关键字 | 匹配对象 | 设置注意点 |
|---|---|---|
DOMAIN | 完整域名。 | 适合只处理一个明确主机名的情况。 |
DOMAIN-SUFFIX | 域名后缀及其子域名。 | 影响范围比单个 DOMAIN 更大。 |
DOMAIN-KEYWORD | 域名中包含的关键词。 | 容易覆盖额外目标,先检查匹配范围。 |
IP-CIDR / IP-CIDR6 | IPv4 / IPv6 地址段。 | 确认地址族、网段与解析行为。 |
GEOIP | 按 IP 地理数据库分类的目标。 | 分类依据是目标 IP 的地理数据库记录,不是域名后缀。 |
USER-AGENT | 可供规则识别的 User-Agent 信息。 | 并非每种连接都能提供该信息,不宜作为通用兜底。 |
FINAL | 未命中前序规则的连接。 | 放在末尾,并确认兜底策略可用。 |
下面是规则语法示例,不是供直接替换整份 Config 的文件。其中 PROXY 表示代理策略,使用前需核对当前配置中的实际策略定义;example.com 仅为示例域名。
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
DIRECT 表示直接连接,REJECT 表示拒绝匹配的连接。使用 REJECT 前先确认目标用途,避免让登录、内容加载或后台请求一并失败。若某个目标在 Proxy 下可访问、在 Config 下失败,应优先查看命中的规则与最终策略,而不是先增加更多宽泛规则。
Config 还可能包含 DNS、策略组和其他设置。调整规则时只修改相关部分,保留原文件副本;连接期间的旧会话可能继续沿用此前的路径,验证时重新发起请求,必要时重新连接。规则基础可结合名词解释阅读。
多协议:按已有服务器参数填写
Shadowrocket 可使用多种连接协议,包括 Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard,以及 HTTP、SOCKS5。协议规定客户端与服务器如何交换数据,不是可随意替换的速度选项。应以自己已有服务器的实际配置为准,在 Home 的 Add Server 中选择对应类型,或导入包含这些参数的已有链接。
先核对地址与端口,再核对身份验证、传输方式和 TLS 相关字段。不同协议所需字段并不相同:有的使用密码,有的使用 UUID,WireGuard 则涉及密钥、地址和对端配置。不要把一种协议的值套入另一种类型,也不要为了让连接暂时通过而随意关闭证书校验。
VMess、VLESS 等连接还可能依赖配套的传输参数。地址相同并不代表路径、Host 或 Server Name 可以省略。导入后出现超时,先逐项对照原始信息,确认没有遗漏额外参数。服务端需要支持相同的组合,单独切换客户端中的协议名称不能完成服务端转换。
订阅与服务器管理:导入、选择与更新
Home 用于查看服务器与订阅分组,并选择当前使用的服务器。已有单条服务器信息时,可通过 Add Server 按类型填写;已有二维码时,可使用 Scan QR Code 导入并检查解析结果。已有订阅链接时,在 Add Server 中选择 Subscribe,按界面填写链接与备注,再保存并更新列表。
订阅是批量获取服务器条目的来源,不等同于 Config 规则文件。更新订阅通常是刷新服务器列表,不代表活动 Config、DNS 或 Global Routing 会按预期一起改变。导入后应检查分组是否出现、字段是否完整,并明确选择要使用的服务器,再进行连接测试。
管理时为手动条目与订阅分组使用能辨认的备注。手动修改订阅生成的条目可能在后续刷新时被覆盖,长期调整前应确认该条目由谁维护。更新失败时,先检查当前网络能否访问订阅地址、链接是否仍有效,再联系自己的服务商核对;不要反复删除分组,以免丢失可比较的旧信息。
订阅地址、二维码与服务器凭据都可能授予访问权限。不要把完整链接放进公开截图、日志或求助文本。删除分组前先保留必要的原始信息;批量更换服务器后,用同一种 Test Method 再测一次,避免把不同测试口径的结果放在一起比较。
On Demand:按网络条件触发连接
On Demand 用于让系统按设定条件处理 VPN 的连接需求,减少每次手动切换的操作。它不是判断服务器健康状态的开关,也不能修复无效凭据。在应用的 Settings 中查找 On Demand,进入后依据当前界面提供的网络条件配置;先让手动连接工作正常,再启用按需连接。
设置前明确希望在哪些网络下连接、在哪些条件下不触发,然后从一条条件开始测试。涉及 Wi-Fi 条件时,仔细核对网络名称及匹配范围。保存后依次切换测试网络、重新发起请求,并观察系统 VPN 状态与应用显示是否符合预期。不要仅凭开关颜色判断触发规则已经正确执行。
排查“刚断开又连上”的现象时,优先检查 On Demand 是否仍处于启用状态。需要临时停用连接时,应一并核对按需规则。切换 Wi-Fi 与蜂窝网络后,系统行为还会受到当前网络、系统权限和已有 VPN 配置影响;每次只调整一个条件,保留可复现的测试记录。
Data:查看流量与活动变化
Data 展示客户端记录的流量统计,适合观察连接期间上传、下载及相关统计项的变化。在 Data 中先辨认当前页面的统计范围、时间口径与单位,再进行一次明确操作,例如打开同一个网页,比较操作前后的变化。页面提供的细分项目以当前界面为准。
流量增加说明有数据经过相应的统计范围,不代表目标页面已经完整加载,也不能直接证明某条规则命中正确。后台同步、媒体预加载和应用重试都可能产生流量。如果某个应用没有打开,统计仍持续增加,应先检查后台活动,而不是直接认定服务器异常。
客户端统计与服务商账单可能采用不同的计量范围、重置时间和单位,数值不必完全一致。需要保留排查证据时,先记录统计时间与连接状态,再使用界面提供的重置功能。Data 不应当作设备全部网络流量的唯一账本,也不适合单独用于判断服务器速度。
Settings:DNS、测试、快捷入口与同步
Settings 汇集常用行为设置。进入后先辨认项目作用,再决定是否修改。部分行为还可能由活动 Config 控制,因此排查时应同时记录 Settings 与 Config 中的相关配置。不要一次更换 DNS、测试方式和服务器,否则结果变化后难以确定原因。
DNS:检查解析路径与配置来源
DNS 将域名解析为地址,解析失败会表现为服务器似乎已连接、目标却打不开。在 Settings 的 DNS 相关选项及活动 Config 中检查解析配置,先确认当前实际使用的来源,再修改对应设置。DNS 地址本身也需要能通过当前网络路径访问,不能只因为名称熟悉就直接替换。
测试时区分域名解析失败与目标连接失败,并留意 IPv4、IPv6 结果是否不同。若配置使用带加密传输的解析方式,还应核对域名、证书验证与连接路径。保留原设置,每次更改后重新发起同一个请求;不要把清空全部 DNS 设置当作固定修复步骤。
Test Method 与 Connectivity Test:统一比较口径
Test Method 决定连接测试采用的方式。在 Settings 中选择当前界面提供的测试方法,再回到 Home 执行 Connectivity Test。不同方式测量的环节不同,结果不能直接混比;测试失败也不一定等于服务器完全不可用,应结合实际访问与日志判断。
比较服务器时,保持网络、测试方法与测试目标一致,并尽量在相近时间重复测试。延迟较低不等于持续传输一定更快,测试通过也不代表所有目标服务都能正常工作。遇到超时,可按服务器超时排查流程继续检查。
Today Widget:配置快捷查看与操作入口
Today Widget 用于快捷查看或操作相关状态。先在 Settings 中检查 Today Widget 的可用设置,再在系统的小组件界面添加设备当前提供的项目。组件形式与可用操作受系统及应用支持情况影响,实际名称和展示方式以设备界面为准。
快捷入口不替代完整配置检查。通过组件操作后,仍应在应用内确认当前服务器、Global Routing 和连接状态;需要修改规则或核对失败原因时,回到 Home、Config 或 Diagnostics,而不是反复触发同一个快捷操作。
iCloud 同步:先保留本地副本
iCloud 同步用于在符合条件的设备之间同步应用支持的数据。在 Settings 的 iCloud 相关项目中核对开关,同时检查系统是否允许该应用使用 iCloud。两台设备需使用适当的 iCloud 账号与权限;App Store 的购买账号和 iCloud 同步账号承担不同用途,不应混淆。
启用前保存重要 Config 与必要信息,并阅读当前界面标明的同步范围,不要默认所有设置、统计或连接状态都会同步。同步不是历史备份;删除或覆盖操作可能传播到其他设备。换设备后先确认数据完整,再连接,不要在两台设备上同时大量编辑同一份配置。
Diagnostics:用最小复现记录定位问题
Diagnostics 用于收集与连接问题相关的诊断信息。在 Settings 中打开相应入口,按界面提供的项目检查;需要复现时,记录网络类型、服务器、Global Routing、活动 Config 与错误出现的时间,再重复一次失败操作。具体日志范围以当前界面为准。
阅读信息时,先区分解析错误、连接超时、身份验证失败与目标返回错误,再回到对应设置核对。对外提供诊断内容前,移除订阅地址、密码、密钥和可识别个人的信息,只保留解决问题所需的片段。问题解决后,恢复临时开启的额外记录设置。
设置核对顺序:从可连接到按规则使用
把配置过程拆成三个阶段:先验证服务器,再验证分流,最后加入自动化与同步。每个阶段都使用同一个测试目标,确认结果后再继续。这样可以避免在一次失败中同时怀疑协议、DNS、规则和 On Demand。
- 确认基础网络。先检查设备本身的网络是否可用,记录当前是 Wi-Fi 还是蜂窝网络。存在需要登录的网络时,先完成网络要求的操作。
- 确认已有服务器。在 Home 中选择明确的条目,核对协议参数,用统一的 Test Method 执行 Connectivity Test,再验证实际目标访问。
- 确认活动配置。在 Config 中选中预期文件,将 Global Routing 设为 Config,检查目标命中的规则和策略,保留能正常工作的文件副本。
- 逐项加入设置。按需要调整 DNS、On Demand、Today Widget 或 iCloud 同步。每改一项就重复测试,并记录与此前结果的差异。
- 使用数据验证。通过 Data 观察活动变化,必要时使用 Diagnostics 复现错误。若新设置引入问题,先恢复上一项,再判断是否需要继续修改。
首次配置可按教程逐步操作;已经连接但目标访问失败,可进入问题诊断按症状排查。购买、重新下载与设备兼容性则在App Store 正版核对页确认,不需要为连接问题重新购买客户端。