Shadowrocket · 官方手册
Shadowrocket
功能与设置
先确定流量如何处理,再调整连接与诊断选项。本页按界面入口说明每项功能的作用、操作方法与检查要点,适用于 iPhone 与 iPad 上的日常配置。
- Global Routing
- Config / Settings
- Connectivity Test
首次操作可先阅读使用教程;逐项参数说明见Settings 设置手册。Shadowrocket 是 Apple 平台付费商业应用,唯一获取入口为 App Store,购买核对请查看获取应用说明。
Global Routing
配置、代理与直连模式
是什么:Global Routing 决定请求按哪一种总体方式处理。配置模式对应 Config,代理模式对应 Proxy,直连模式对应 Direct。它不是服务器列表,也不负责补齐服务器的认证信息;选好模式之后,连接是否成功仍取决于本地网络、目标地址以及所选服务器的状态。
在哪个界面、怎么设:在 Home 找到 Global Routing,打开后选择需要的模式。使用日常规则分流时选 Config,并到 Config 页面确认当前选中的配置文件。需要单独验证代理连接时可临时切到 Proxy;需要验证直接访问是否正常时可临时切到 Direct。切换后对同一目标重新发起请求,避免把先前已建立的连接当成新模式的结果。
| 模式 | 处理方式 | 适用情形 | 核对项目 |
|---|---|---|---|
配置 / Config | 按当前配置中的规则与策略处理请求。 | 日常按域名、地址或地区分流。 | 配置文件、规则顺序、策略引用。 |
代理 / Proxy | 以代理作为总体路由选择。 | 临时验证所选代理路径。 | 默认服务器、认证与协议参数。 |
直连 / Direct | 以直接连接作为总体路由选择。 | 检查本地网络与目标直连状态。 | 本地网络、DNS 与目标可达性。 |
注意什么:Direct 不等于关闭连接开关,系统 VPN 标识也不能证明某个请求一定经过代理。Proxy 不等于所有系统流量都能被接管。判断某条请求的实际去向,应结合请求记录、命中的策略与新连接的测试结果;排查完成后,把模式恢复为日常使用的选择。
Config / Rule
规则类型与处理策略
是什么:规则把匹配条件与处理策略连接起来。DOMAIN 匹配完整域名,DOMAIN-SUFFIX 匹配域名及其子域名,DOMAIN-KEYWORD 检查域名中的关键词。地址相关条件包括 IP-CIDR、IP-CIDR6 与 GEOIP,它们分别用于 IPv4 网段、IPv6 网段与 IP 地区判断;GEOIP 的结果取决于地址库,而不是网站使用的语言。
在哪个界面、怎么设:到 Config 确认已启用的配置,再编辑其中的 [Rule] 部分。通常将更具体的条件放在前面,将 FINAL 放在末尾,作为前面条件均未命中时的最终策略。修改前保存副本,修改后重新测试具体目标;仅保存了另一份未启用的配置,不会改变当前连接所用的规则。
[Rule]
DOMAIN,example.org,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,ads,REJECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
上例用于说明语法,不是一份适合所有网络的完整配置。PROXY 表示交给代理策略,DIRECT 表示直接连接,REJECT 表示拒绝请求。规则也可以引用配置中已定义的策略组;引用名称必须与实际定义一致,否则需要先修正引用关系。
注意什么:规则通常按顺序匹配,前面已经命中的条件会影响后面的规则是否还有机会执行。关键词匹配范围可能大于预期,拒绝规则应尽量具体。域名规则与 IP 规则看到的对象不同,DNS 解析结果也会影响地址规则;不要只看规则文本,就认定某个目标一定会命中。USER-AGENT 依赖请求中可见的对应字段,并不是对所有加密请求都有效的通用分类方法。
需要逐条理解语法时,可继续阅读规则关键字与匹配顺序。排查时先确定实际目标域名,再检查先命中的规则,最后核对对应策略,而不是反复追加同一条条件。
Home / Add Server / Subscribe
服务器与订阅管理
是什么:单个服务器条目保存协议、地址、端口以及认证等连接信息;订阅则用于从用户已有的链接取得并更新一组条目。订阅更新改变的是服务器列表内容,不代表规则配置同时更新,也不代表更新后的每个服务器都能连接。
在哪个界面、怎么设:在 Home 使用添加入口进入 Add Server,根据已有信息选择类型并填写字段。Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2 等协议的字段并不完全相同,应按原始连接参数填写,不要仅凭相似名称套用另一种协议的表单。已有二维码可通过 Scan QR Code 导入;导入后仍需核对协议与地址。
导入订阅时,在 Add Server 的类型中选择 Subscribe,填入自己的订阅链接并保存,再执行更新。返回 Home 后点选要使用的服务器,核对选中标记。默认服务器与配置里的策略组选择可能是两层不同的设置,使用策略组的配置还应检查组内当前选择。
注意什么:订阅链接可能包含访问凭据,截图、复制日志或发送求助材料前应遮盖完整链接与认证信息。手动修改订阅生成的条目可能在下一次更新时被覆盖;需要保留调整时,应先了解更新行为并另存必要记录。手动更新失败时,分别检查链接是否完整、当前网络是否可达、返回内容是否为支持的格式。
删除订阅与删除一条服务器记录并不总是同一范围的操作,执行前阅读确认提示。名称相同也不表示参数相同,地址、端口、认证和 TLS 相关字段都需要逐项核对。具体刷新步骤见订阅更新与失败排查。
On Demand
按需连接与触发条件
是什么:On Demand 用来根据设定的网络条件触发连接行为。它解决“什么时候连接”的问题,Global Routing 解决“连接后怎样处理请求”的问题;两者作用不同。按需连接也不会修复错误的服务器信息或失效的订阅。
在哪个界面、怎么设:在 Settings 中找到 On Demand 相关入口,按当前界面提供的条件配置。设置前先手动连接,使用 Connectivity Test 确认基础路径正常。之后一次只调整一类条件,在计划使用的 Wi-Fi 或蜂窝网络下分别验证;涉及特定 Wi-Fi 的条件时,应仔细核对网络名称。
注意什么:启用自动触发后,手动断开并不一定会让连接长期保持关闭,匹配条件可能再次触发系统连接。需要临时停止自动连接时,应同时检查 On Demand 状态。系统的网络切换与省电行为也可能影响触发时机,不应将它理解为每一刻都持续探测服务器的健康检查。
如果出现“刚断开又连接”的现象,先记录发生时的网络类型,再核对触发条件,不要立即删除配置。相反,若切换网络后没有按预期连接,应先确认条件确实匹配,再检查系统 VPN 配置是否有效,以及手动连接是否仍可成功。
Data
流量统计与请求记录
是什么:Data 用于查看应用记录的流量及相关请求信息。它有助于观察连接期间的数据变化、定位访问对象,并结合记录核对策略。应用内统计有自己的统计范围与计数时机,不应直接当作移动通信账单或远端账户用量。
在哪个界面、怎么设:打开 Data,先确认当前查看的是哪一类统计或记录,以及页面显示的统计范围。需要观察某次操作时,先记下现有计数,再只打开一个目标页面,返回检查新增记录与流量变化。当前界面若提供筛选、清理或重置入口,应先确认作用范围,再决定是否执行。
注意什么:缓存、后台连接、协议封装与不同统计边界,都可能让计数与直觉不一致。有新增流量不等于业务请求完成;没有立即出现记录,也可能与已有连接复用或记录设置有关。比较两次测试时应尽量保持网络、目标与测试动作一致。
请求记录中的域名、IP 与时间可以帮助定位问题,也可能暴露个人访问习惯。分享材料时只保留与故障相关的条目。若需要清理记录,先保存必要的排查线索;清理后的列表无法再用于还原之前的测试过程。
Settings
DNS、测试与辅助设置
Settings 集中管理解析、测试与辅助功能。下面按用途说明常用项,而不是给出一套覆盖所有设备的固定数值。已有配置可能同时包含相关参数,编辑前应确认当前生效来源;默认值与开关状态以当前应用实际显示为准。
DNS:先区分解析与连接
是什么、在哪:DNS 将域名解析为地址,相关选项可在 Settings 的 DNS 设置及当前配置的相关部分核对。域名无法解析、解析到不适用的地址与代理认证失败,是不同阶段的问题。
怎么设、注意什么:先记录现有设置,确认当前配置是否指定了解析服务器或解析行为,再修改目标选项。排查时使用同一域名观察修改前后的解析结果,一次只改变一个因素。自定义解析地址本身也需要可达,不能用“填入了地址”代替实际测试。TLS 相关故障还应检查域名与证书匹配,不要把关闭证书校验当作常规 DNS 修复。
Test Method:测试方式与数值含义
是什么、在哪:Test Method 决定延迟测试采用的方式,在 Settings 中查看并调整。不同方式关注的连接阶段不同,因此同一服务器在不同方法下得到的结果不宜直接混排比较。
怎么设、注意什么:先选定一种测试方式,再对需要比较的条目执行测试。若当前方式使用测试地址,还应确认该地址本身可访问。测试成功只证明对应测试过程完成,不代表所有网站都能使用;延迟数值也不是持续下载速率。需要确认实际业务时,再打开目标服务并查看请求记录。
Today Widget:组件入口与显示
是什么、在哪:Today Widget 提供组件相关的快捷查看或操作选项。先在 Settings 核对应用提供的组件设置,再到系统对应的组件编辑界面添加可用组件。具体形式取决于当前系统与应用支持情况。
怎么设、注意什么:按实际需要选择展示或操作内容,添加后回到应用确认连接状态。组件显示可能存在刷新间隔,不能作为请求已经成功的唯一证据;若组件状态与应用不同,先打开应用刷新核对,再判断连接是否异常。组件快捷操作仍受系统权限与按需连接条件影响。
iCloud:同步范围与恢复核对
是什么、在哪:iCloud 相关选项用于应用支持的数据同步或云端保存流程。进入 Settings 查看相关开关,并确认系统中该应用的 iCloud 权限。只有当前界面明确支持的内容,才应纳入同步预期。
怎么设、注意什么:跨设备操作前先保留现有配置副本,再核对两台设备的账户与同步状态。同步不等于完整备份,也不等于重新下载应用后所有数据都会自动恢复。恢复后应逐项检查服务器列表、当前配置与策略选择,不要只根据文件名称判断内容一致;敏感订阅链接也应按私人凭据管理。
需要查找更细的设置解释,可转到Settings 设置项参考。避免一次性调整 DNS、测试方式和自动连接条件,否则即使故障消失,也难以确认真正有效的改动。
Diagnostics / Connectivity Test
诊断顺序与结果核对
是什么:Diagnostics、日志与 Connectivity Test 用于观察不同阶段的状态。一个用于探查连接的测试结果,不能替代 DNS、规则与实际目标访问的全部检查。诊断的目的,是把问题缩小到可重复验证的一步。
在哪个界面、怎么设:先在 Home 核对服务器选择、连接开关与 Global Routing,执行 Connectivity Test。进一步排查时,在 Settings 查看当前提供的 Diagnostics 或 Log 相关入口,按需记录一次故障过程。各项入口以当前界面为准,记录完成后恢复原来的日志设置。
- 确认本地网络。先验证网络本身可用,排除需要登录确认的 Wi-Fi;在同一网络下重复一次测试,记录故障是否稳定出现。
- 确认服务器参数。对照用户已有信息检查协议、地址、端口与认证字段。订阅能更新但不能连接时,仍需单独测试实际选中的服务器。
- 隔离路由因素。临时比较
Proxy与Config下同一目标的结果。如果前者正常、后者异常,优先核对当前配置、命中规则与策略组选择。 - 核对解析与请求。查看目标是否解析成功、实际地址是什么,以及请求最终采用的策略。只有个别目标异常时,先围绕该目标检查,不必立即重建全部配置。
- 恢复并复测。保留已经确认有效的改动,撤销临时测试设置,恢复日常路由与按需连接条件,再做一次真实访问验证。
注意什么:日志中可能包含服务器地址、认证内容、订阅链接和访问记录。对外分享前逐项检查并遮盖敏感字段;完整凭据不应作为排查材料公开。系统出现 VPN 标识、服务器测试成功、目标页面加载成功是不同层面的证据,应分别确认。