官方手册 · 设置参考

Shadowrocket 功能与设置

先确定请求如何路由,再调整连接、解析与诊断选项。

本页以 iPhone / iPad 上的操作为主。每节依次说明功能是什么、入口在哪里、怎样设置,以及哪些现象不能仅凭一个开关判断。界面布局可能随设备与应用调整而变化,具体选项以当前应用显示为准。

Global Routing

配置、代理、直连:三种路由模式

Global Routing 决定连接启用后,请求采用哪一类处理方式。它不是服务器列表,也不会替用户补齐缺失的连接参数。

入口与设置:在 Home 打开 Global Routing,选择 Config、Proxy 或 Direct,再返回检查当前 SERVER 与连接开关。这里的“配置、代理、直连”分别指对应英文选项;Config 模式与底部用于管理文件的 Config 页面有关,但两者不是同一个操作入口。

模式处理方式何时使用检查重点
Config · 配置按当前启用的配置规则与策略处理请求。日常按网站、域名或地址分流。确认配置已启用,规则顺序与最终策略正确。
Proxy · 代理将受客户端接管的请求交给当前代理策略处理。临时检查选中服务器能否完成目标请求。确认服务器可用;不要将测试结果等同于全部应用的行为。
Direct · 直连以直连方式处理受接管的请求。对照检查本地网络,或临时采用直连路径。模式选择不等于关闭系统 VPN 连接。

建议顺序:已有可用配置时先选 Config;若某个目标异常,可暂时切换 Proxy 或 Direct,用同一网络、同一目标做对照。结束测试后切回原模式,避免把临时排查设置当成日常设置。

注意:Proxy 不能修复失效凭据、错误端口或不可达服务器;Direct 也不表示客户端连接已经停止。需要停止连接时,应检查 Home 的连接开关及系统 VPN 状态。模式变化后,既有长连接可能仍保留旧路径,必要时重新建立目标应用的连接再判断。

Rule / Config

规则分流:匹配条件与策略

规则回答“这条请求是否符合条件”,策略回答“匹配后怎样处理”。只有理解这两部分,才能解释某个网站为何走 PROXY 或 DIRECT。

入口与设置:在 Config 找到当前使用的配置,先备份,再通过配置的编辑入口检查规则。回到 Home,将 Global Routing 设为 Config。仅把文件导入 Config 列表,并不能证明该文件正在生效;还要确认当前启用项。

常用的 DOMAIN 匹配完整域名,DOMAIN-SUFFIX 匹配域名后缀,DOMAIN-KEYWORD 检查域名中的关键词。IP-CIDR 与 IP-CIDR6 面向地址网段,GEOIP 按地址所属地区数据库匹配。USER-AGENT 依赖请求中相关信息是否可见,不应被当作对所有加密连接都有效的应用识别方法。

关键字检查内容设置注意
DOMAIN完整域名适合只处理明确的主机名。
DOMAIN-SUFFIX域名后缀及其子域名确认后缀覆盖范围,避免扩大匹配。
IP-CIDRIPv4 地址网段目标解析结果与规则顺序会影响判断。
FINAL此前规则均未命中的请求放在末尾,明确兜底处理方式。

DIRECT 表示直连,PROXY 使用相应代理策略,REJECT 用于拒绝匹配请求。若使用自定义策略名称,名称必须与配置中实际定义的一致。规则通常按顺序匹配,较明确的条件应放在宽泛条件前面;把一条规则移动位置,可能比修改规则内容更直接地改变结果。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

以上只是教学用的最小规则片段:example.com 及其子域名走 PROXY,其余请求由 FINAL,DIRECT 处理。它不是完整配置,也不包含服务器信息。保存修改后,用目标域名重新发起请求,再结合连接记录检查匹配结果;不要只看浏览器页面是否显示成功。

需要展开阅读时,可查看指定网站走 PROXY 的规则写法。修改远程配置前还要考虑更新策略:后续重新获取文件,可能覆盖本地编辑。

Subscribe / Add Server

订阅与服务器管理

服务器记录保存连接所需的参数,Subscribe 用于更新一组已有记录,Config 则负责规则与相关配置。三者用途不同,不应只凭名称相近就互相替代。

使用前提:用户已经拥有自己的订阅或服务器信息。客户端一次性买断 ≠ 线路套餐。购买 Shadowrocket 获得的是客户端使用权,仍需自行准备有效的连接参数;本手册只说明如何导入、整理与使用已有信息。

入口与设置:在 Home 通过添加入口进入 Add Server。手动添加时,先按已有信息选择 Type,再填写 Address、Port 以及协议要求的认证字段。Shadowsocks、VMess、VLESS、Trojan 等类型的字段不完全相同,不能只更换 Type 而沿用所有旧值;传输、TLS 与服务器名称等附加设置也要逐项对应。

导入订阅时选择 Subscribe,填入自己的完整订阅地址并保存。支持的分享内容也可通过 Scan QR Code 或剪贴板导入;导入后仍要检查 Type、地址与端口,不要把“识别成功”当成“连接成功”。订阅地址可能含访问凭据,不应贴进公开截图或问题描述。

多组订阅可用便于识别的备注区分用途,更新后检查记录是否增减、当前选择是否仍存在。订阅下的记录通常由远端内容维护,直接修改其中的字段可能在下次更新时被替换。需要保留独立调整时,先确认备份与单独保存的方式,再进行编辑。

测试与整理:使用 Connectivity Test 前,先确认 Test Method,再测试候选服务器。延迟结果只反映该方法与目标下的响应情况,不等于吞吐能力,也不保证某个网站一定可用。选定 SERVER 后重新发起实际请求;删除旧记录前,确认它不再被当前配置或日常操作依赖。

关于扫码、分享内容、更新与备份的连续步骤,见订阅与服务器管理手册。出现导入为空时,先核对链接是否完整及已有订阅的状态,不要连续创建多份相同记录。

On Demand

按需连接与网络切换

On Demand 是触发连接的机制,不是决定网站走哪条路径的规则。连接建立后,具体请求仍受 Global Routing 与当前配置控制。

入口与设置:在应用中找到 On Demand 相关设置,先查看当前启用状态与已有条件,再按实际需要调整。不同设备上的入口位置与可选条件以应用显示为准。首次使用时,应先在 Home 手动验证服务器和配置能够正常工作,再启用按需行为。

如果当前界面支持针对网络类型或 Wi-Fi 条件设置行为,先从一条容易验证的条件开始。保存后,在预期网络中观察系统 VPN 状态;随后切换到另一网络,再检查连接是否按设定变化。一次增加多条条件,会让“哪条条件触发了连接”变得难以判断。

注意:启用 On Demand 后,仅在 Home 手动断开连接,可能仍会因条件再次满足而重连。需要暂时停用时,应同时检查按需设置。它也不保证一定节省电量:网络质量、重连频率与持续请求都会影响电池用量,应结合一段时间的实际使用记录判断。

Data

流量统计与观察范围

Data 用于观察客户端记录到的流量变化。它适合辅助判断连接活动,但不是网络账户的计费凭证。

入口与设置:打开 Data,先阅读当前视图的统计对象、方向与时间范围。观察上传与下载变化前,记录起点;如需清空统计,应先保存需要的记录,再使用当前界面提供的重置入口。不要在排查中途清空后又把新旧数值直接比较。

验证时可关闭不相关的前台任务,用同一个目标完成一次请求,再返回 Data 观察变化。若目标应用正在后台刷新,或仍有媒体与同步任务运行,流量增加不一定来自刚才打开的页面。显示有流量,也只能说明存在数据活动,不能单独证明特定请求命中了预期规则。

注意:客户端、系统蜂窝网络统计与已有服务的用量记录,可能采用不同的统计范围、周期与计算口径。数据经过的路径、协议开销及是否包含直连请求等因素,都可能造成差异。查看剩余用量时应以相应账户记录为准;排查路由时则应把 Data 与连接记录结合起来。

Settings

DNS、测试与同步设置

Settings 中的选项影响不同层次。建议保留一份可用基线,不要因为某个目标异常而同时改动 DNS、测试方法与全部连接参数。

DNS:检查域名如何解析

是什么与入口:DNS 将域名转换为连接所需的地址。相关选项可能出现在 Settings 与当前 Config 中,排查时应把两处一起核对。先确认配置是否已定义解析相关行为,再判断需要修改哪一个实际生效的设置。

怎样设置:记录现有解析设置,按自己的网络与配置要求调整一个选项,重新建立连接,再对同一域名复测。若 IP 地址可访问而域名失败,解析是值得检查的环节,但不能据此直接认定只有 DNS 出错;TLS、目标服务状态与规则匹配也可能影响结果。

注意:域名解析结果还可能参与地址类规则的匹配。切换解析方式后,检查目标返回地址以及匹配策略,不要将“解析成功”等同于“请求一定按预期路由”。已有缓存与长连接可能使修改暂时不明显,应使用新的连接进行验证。

Test Method:让测试结果可以比较

是什么与入口:Test Method 是 Connectivity Test 使用的测试方式,可在 Settings 中检查。不同方法可能检查不同目标与连接阶段,因此同一服务器在不同方法下得到不同结果,并不矛盾。

怎样设置:比较服务器前,固定测试方法;如当前选项允许指定测试目标,也应保持目标一致。在同一网络中重复测试,结合实际网站请求判断稳定性。不要把一次超时立即归结为全部连接失败,也不要只按单个最低数字长期固定选择。

Today Widget:快捷操作与状态查看

是什么与入口:Today Widget 用于系统提供的相应组件区域,相关偏好可在 Settings 查找;组件是否可添加、可显示哪些操作,以设备系统与应用实际支持为准。添加后先检查显示内容是否符合预期。

怎样设置与注意:需要快捷控制时,按系统组件管理方式添加,并回到 Home 对照状态。组件显示与系统连接状态可能存在刷新间隔,不能只凭组件的一次显示判断连接已经建立。操作异常时先回到应用检查,再处理组件展示。

iCloud:同步不替代备份核对

是什么与入口:iCloud 相关同步选项用于在支持条件下保存或同步应用数据。先检查系统 iCloud 可用状态及应用内相关选项,再查看当前界面标明的同步范围;不要默认所有订阅、配置、历史记录与认证信息都会一并同步。

怎样设置与注意:首次启用或更换设备前,保留独立备份,并在另一设备逐项核对记录。两台设备同时编辑同一内容时,应留意覆盖或冲突。订阅与配置可能包含敏感连接信息,备份、同步与导出时都应确认保存位置及访问权限。

Diagnostics

诊断设置与故障检查顺序

Diagnostics 用于收集排查线索。有效诊断不是打开全部记录长期运行,而是用一次可复现的请求解释具体失败环节。

入口与设置:在 Settings 中查找 Diagnostics 或相关诊断入口,阅读当前工具说明,再启用完成此次检查所需的记录。先记录网络环境、Global Routing、当前 SERVER 与配置名称,然后复现一次问题,避免多次切换条件把线索混在一起。

  1. 先看连接层。确认 Home 的连接开关与系统 VPN 状态,检查当前网络是否能完成基本请求。
  2. 再看服务器。核对当前选择与已有认证信息,使用固定 Test Method 执行 Connectivity Test。
  3. 检查解析与规则。对同一目标核对域名解析、匹配条件与最终策略,必要时临时切换模式进行对照。
  4. 最后回到目标应用。重新建立连接复测,并把 Data 的变化作为辅助线索,而不是成功结论。

注意:“测试有响应”“系统显示已连接”“目标网页打开”分别说明不同层面的情况,不能互相替代。若仅一个网站异常,先限定到该域名和对应规则;若全部请求异常,再检查公共的服务器、网络与配置因素。完成检查后恢复原设置,并关闭不再需要的详细诊断记录。

分享排查信息前,应遮盖订阅地址、密码、认证字段与不必要的访问记录,只保留理解问题所需的错误现象和操作步骤。更多分场景解释见常见问题;需要从导入到首次连接连续操作时,转到使用说明。