官方手册 / 功能与设置
Shadowrocket
功能与设置详解
先确定 Global Routing,再检查 Config 与服务器。每次只改一类设置,用同一个目标复测,避免把规则、DNS 与连接问题混在一起。
查看首次连接教程适用设备:iPhone / iPad / Mac / Windows / 安卓 / Linux。下文以 iPhone / iPad 的界面组织说明;其他平台按同名项目查找,实际入口与可用项以当前平台界面为准。
01 / 整体处理方式
Global Routing 三种模式
入口:Home → Global Routing
Global Routing 决定客户端怎样处理进入其接管范围的请求。配置模式对应 Config,代理模式对应 Proxy,直连模式对应 Direct。日常按规则分流通常选 Config;排查某个请求是否受规则影响时,可以临时切换 Proxy 或 Direct 做对照。模式切换不是服务器切换,也不会自动修正账号、端口或协议参数。
| 界面选项 | 处理方式 | 何时使用 | 先检查什么 |
|---|---|---|---|
| Config / 配置 | 按当前启用的配置规则选择策略。 | 日常规则分流,分别处理需要代理与直接连接的请求。 | Config 是否启用、规则顺序与策略指向是否正确。 |
| Proxy / 代理 | 进入接管范围的请求主要按代理方式处理,仍需留意系统与配置中的绕过项。 | 临时排除规则匹配错误,确认所选服务器能否访问目标。 | Home 当前服务器、协议参数与服务端可用性。 |
| Direct / 直连 | 进入接管范围的请求按直接连接方式处理。 | 确认当前网络本身是否能访问目标,或临时停止使用代理策略。 | 本地网络、DNS 与目标服务是否正常。 |
在 Home 打开 Global Routing,选择需要的模式后返回,再用同一个网站或应用发起新请求。已有的长连接可能继续沿用原连接路径,必要时关闭目标应用后重新打开。Proxy 下可访问而 Config 下失败,重点检查规则与策略;两种模式都失败,则先确认服务器、网络和目标服务,不要立即扩大规则范围。
02 / 匹配与策略
Rule 规则分流
入口:Config → 当前配置中的 Rule
规则分流把“请求符合什么条件”和“符合后怎样处理”分开。DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD 是域名相关条件;IP-CIDR、IP-CIDR6 用于地址范围,GEOIP 用于地址所属区域判断。USER-AGENT 涉及请求头匹配,只有客户端能够取得相应信息时才有意义,不能把它当成适用于所有加密流量的应用识别方式。
常用策略包括 DIRECT、PROXY、REJECT。DIRECT 表示直接连接,PROXY 交给代理策略处理,REJECT 拒绝匹配的请求。配置还可能使用自定义策略名称,修改之前应确认该名称在当前配置里有定义,且指向预期服务器或策略组。名称相似并不代表作用相同。
[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,PROXY
DOMAIN-KEYWORD,example,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT
上面仅为语法示例,不是可直接覆盖现有配置的完整方案。DOMAIN 精确匹配指定域名;DOMAIN-SUFFIX 还匹配其子域;DOMAIN-KEYWORD 范围更宽,容易覆盖原本不打算处理的域名。规则一般按顺序检查,先命中的条件优先,因此具体规则通常放在宽泛条件之前,FINAL 放在末尾接住剩余请求。
设置时先备份当前 Config,添加一条范围明确的规则,确认 Global Routing 为 Config,再发起新请求并检查记录中的匹配结果。若规则没有命中,核对实际访问域名与重定向后的域名是否一致;若命中却走错路径,检查策略指向,而不是反复添加相同条件。涉及 IP 判断的规则还要考虑域名解析结果与配置中的解析选项。
03 / 信息导入与维护
Subscribe 与服务器管理
入口:Config / Subscribe、Home / Add Server
订阅用于批量获取并更新服务器条目,服务器条目保存实际连接所需的地址、端口、协议与认证参数。本文以你已有自己的订阅或服务器信息为前提;订阅链接统一从你的服务商处获取。客户端不会因为已购买或已安装就自动拥有可用线路。
已有订阅链接时,按 Config 中的 Subscribe 入口添加,保存后执行更新,并回到 Home 核对条目。只有单台服务器资料时,用 Add Server 选择对应类型,再逐项填写。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等协议需要的字段不同,应照服务商提供的信息填写,不能只复制地址和端口就认为完成。
Scan QR Code 和剪贴板导入适合已有分享信息的情况。导入前确认内容属于服务器分享信息还是完整配置,避免把配置地址填进服务器地址栏。订阅 URL 往往带有访问凭据,不应放入公开截图、聊天记录或诊断附件;更换泄露的链接应联系你的服务商处理。
更新前记录当前选中的服务器与重要备注。订阅更新可能替换条目,手动改在订阅条目上的字段也可能被覆盖,因此长期维护的手填服务器应单独整理。多订阅可按用途命名,先确认来源和所属分组再删除,避免只凭重复显示名称判断为同一条目。
查看订阅更新、排序与备份手册 →04 / 自动触发连接
On Demand 按需连接
入口:Settings → On Demand
On Demand 用来依据配置的网络条件自动触发连接,与 Global Routing 的作用不同:前者处理“什么时候连接”,后者处理“连接后请求怎样走”。它依赖平台提供的网络扩展机制和当前权限,不能理解为每个应用、每种网络状态下都能完全相同地运行。
先在 Home 手动连接并确认服务器可用,再进入 Settings 的 On Demand,按照当前界面提供的网络类型、Wi-Fi 等条件设置。首次只启用一组容易验证的条件,切换网络后观察连接状态,再决定是否增加例外。若当前平台没有相应入口,应按该平台实际提供的功能操作,不照搬其他设备的设置。
需要暂时停止自动连接时,应同时检查 On Demand,而不只是关闭 Home 开关。连接反复恢复时,先停用按需触发条件,再观察;不要通过删除全部服务器来解决。切换 Wi-Fi 与移动网络后出现短暂中断,还应区分网络本身重新建立连接与自动触发规则是否匹配。
05 / 用量观察
Data 流量统计
入口:Data
Data 用于观察客户端记录到的上传、下载与相关连接用量。阅读数字前先看统计范围:当前连接、累计记录以及按服务器展示的项目,可能采用不同的起止时间。这里的统计范围不等同于系统的蜂窝网络统计,也不等同于服务商账户中的计费数据。
想判断某个操作是否产生流量,可先记下当前计数,暂停其他后台传输,再执行一次明确的访问操作,比较前后变化。若当前界面支持清除统计,应先保存需要的记录再清除,避免把统计归零误认为恢复了服务商账户额度。
统计增加只能说明有数据经过相应记录范围,不能单凭数字证明目标内容已完整加载。连接重试、协议开销、后台同步也会产生流量。发现异常增长时,结合连接记录、服务器选择和目标应用逐项缩小范围;流量很少但页面打不开,则继续检查 DNS、连接建立与目标响应。
06 / 常用设置
Settings 项目说明
入口:Settings;配置内选项还需检查 Config
Settings 中的全局设置与 Config 内的配置项可能共同影响连接。遇到同名或相近选项时,先确认当前启用的配置与该项说明,不假定所有平台采用相同的覆盖关系。以下按使用目的说明,具体可选值以当前界面为准。
DNS:先确认解析,再判断分流
DNS 把域名转换为地址,是访问链路中的独立环节。检查 Settings 的 DNS 相关项目,同时查看启用的 Config 是否包含 DNS 设置。使用已知可用、适合当前网络的解析配置,一次只修改一个项目;保存后重新连接并用相同域名复测,避免缓存结果掩盖变化。
不要为了排查把所有 DNS 项一起替换。域名解析成功也不代表代理连接成功,DNS 请求经过哪条路径与目标连接采用哪个策略还需分别确认。若仅部分域名失败,先检查拼写、解析记录与规则匹配;若多个目标同时失败,再比较本地网络与所选解析方式。
Test Method:测试方法不等于实际体验
Test Method 影响服务器测试采用的方式。先在 Settings 查看当前方法,再从 Home 发起 Connectivity Test。测试结果反映特定探测条件下的可达性或耗时,不代表所有网站的响应速度,也不能证明认证、传输和目标访问的每个环节都正常。
比较服务器时应保持测试方法、网络和测试目标一致。某项探测失败时,先确认服务端是否响应这种探测,再用实际访问结果交叉判断;不要仅因一个测试数值较低就频繁切换正在稳定使用的服务器。
Today Widget:快捷入口与主界面核对
Today Widget 用于支持该组件的平台上的快捷访问或状态查看。先在 Settings 检查相关选项,再按系统提供的组件添加方式启用。组件可用性和展示位置取决于系统版本;如果设备没有对应入口,直接使用 Home 完成连接与切换。
通过组件操作后仍应回到 Home 核对服务器与连接状态。组件显示可能存在刷新间隔,不能只凭旧状态判断连接已经停止,也不宜把组件当成完整的规则或订阅管理界面。
iCloud 同步:同步前先备份
iCloud 同步适用于当前平台和界面支持的同步内容,不等于所有设备之间的完整实时镜像。先确认系统 iCloud 权限,再检查 Settings 的同步选项与具体对象。首次启用前保存本地备份,明确哪一台设备的数据作为基准,再在另一台设备检查结果。
同步配置不代表应用购买记录或服务商账户一并同步,也不意味着当前连接状态会自动一致。多设备同时编辑可能造成内容覆盖;大范围修改时先在一台设备完成并确认同步,再处理其他设备。同步文件也可能包含敏感连接信息,应维护好设备与云账户的访问权限。
07 / 定位故障
Diagnostics 与连接记录
入口:Settings → Diagnostics 相关项目
Diagnostics 用来辅助区分解析失败、服务器连接失败、认证失败或请求处理异常。打开当前界面提供的诊断与记录功能,先记下出错时间、所用网络、Global Routing 模式和当前服务器,然后只复现一次问题。这样能把记录与具体操作对应起来,而不是在长时间运行的记录中猜测。
先看失败发生在哪一层:没有获得域名解析结果,优先检查 DNS;连接服务器失败,检查地址、端口与网络;连接已建立但目标访问异常,继续看策略、协议附加字段与目标响应。不同错误可能产生相似表象,不能把所有超时都归为规则问题。
需要向你的服务商说明情况时,可整理错误文本、复现步骤和网络类型。分享前删除订阅 URL、密码、认证标识与不必要的访问记录;截图也应逐项检查。排查结束后恢复日常记录设置,并清理不再需要的诊断文件,避免长期保存敏感访问细节。
08 / 设置复核
按同一条链路检查
发生故障时先记录现状,再做单项对照。恢复正常后,撤回临时设置,保留确定有效的改动。
- Home:确认连接开关、当前服务器与 Global Routing,排除选错条目。
- Config:确认启用的配置、规则顺序及策略名称,不只检查下载是否成功。
- Connectivity Test:保持同一网络与 Test Method,结合实际访问判断。
- DNS / Diagnostics:依据失败环节排查,保存必要记录后恢复日常设置。