官方手册 / 功能与常用设置

Shadowrocket 功能 与常用设置说明

先在 Home 确认服务器与 Global Routing,再到 Config 检查规则。本页按“是什么、在哪里、怎么设、注意什么”梳理各项功能,适用于已有订阅或服务器信息的用户。

  • Home / 连接与服务器
  • Config / 配置文件
  • Data / 流量记录
  • Settings / 常用设置
01 / Home

Global Routing 三种模式

配置、代理、直连分别对应 Config、Proxy、Direct。它们决定连接如何处理,不等同于服务器协议。

Global Routing 是全局路由模式选择入口,通常在 Home 中调整。Config 读取当前生效配置文件的规则;Proxy 将受客户端接管的连接交给所选服务器;Direct 则让受接管的连接直接访问目标。系统保留流量、排除项及既有连接可能另有处理,因此不能只凭模式名称判断设备上的每一条连接。

日常需要区分不同目标的处理方式时选择 Config;排查某个目标是否因规则走错策略时,可短暂改为 Proxy 做对照;需要检查本地网络能否直接访问目标时,可用 Direct 对照。切换之后重新打开目标或重新发起请求,避免把旧连接的结果当成新模式的表现。

界面模式 主要处理方式 适用场景 设置前核对
Config / 配置 按当前配置文件中的规则选择策略 日常规则分流,分别处理域名与地址范围 当前生效文件、规则顺序及 FINAL
Proxy / 代理 受接管的连接使用所选服务器 与 Config 对照,定位规则相关问题 服务器参数、服务状态及实际访问结果
Direct / 直连 受接管的连接直接访问目标 检查本地网络与目标自身的可达性 当前网络、目标地址及本地 DNS 环境
02 / Config

规则分流与匹配顺序

先看匹配对象,再看策略;从上到下匹配,命中即停。

规则分流用来决定某个连接走服务器、直接连接还是拒绝。进入 Config,先确认当前启用的是哪一份配置文件,再查看或编辑其中的规则。仅导入或保存文件不等于已经启用;编辑了另一份未生效文件,Home 中的连接行为也不会随之改变。

常见规则由类型、匹配内容与策略组成。DOMAIN 匹配完整域名,DOMAIN-SUFFIX 匹配指定域名及其子域名,DOMAIN-KEYWORD 匹配域名中的关键字。需要精确控制时,优先使用边界清楚的域名规则,避免宽泛关键字把不相关的目标一并匹配。

IP-CIDR 与 IP-CIDR6 分别匹配相应的地址范围;GEOIP 依据地址归属数据库判断,并不等于识别网站内容或用户所在位置。域名是否先解析、采用什么解析结果,也可能影响地址类规则的匹配。排查时要把规则与 DNS 设置一起核对。

[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,PROXY
DOMAIN-KEYWORD,ads-example,REJECT
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY

以上仅用于解释语法,不是适用于所有网络的完整配置。示例域名不代表任何连接服务。

PROXY

将命中的连接交给代理策略处理。还需确认对应服务器或策略引用有效,规则本身不会生成可用服务器。

DIRECT

让命中的连接直接访问目标。适合明确应由本地网络访问的地址,但结果仍取决于当前网络和目标服务。

REJECT

拒绝命中的连接。使用前确认匹配范围,若页面资源或登录接口被误命中,可能表现为页面缺失或操作失败。

调整时把范围更具体的例外放在宽泛规则前面,并将 FINAL 留在最后作为兜底。若前面的规则已经命中,后面再精确的规则也不会继续参与处理。每次只改一组规则,记录目标、预期策略和实际结果;不要同时更换服务器、DNS 与规则,否则很难确定是哪项变化产生了影响。

涉及 USER-AGENT 等依赖请求信息的规则时,还要确认当前连接是否具备可供匹配的条件,不能假设所有流量都能读取相应字段。更完整的排列与兜底解释见自定义规则优先级与 FINAL。

03 / Home · Add Server

订阅与服务器管理

服务器条目保存连接参数,订阅用于维护一组条目,配置文件负责规则等设置。三者不能相互替代。

添加已有服务器信息

在 Home 通过 Add Server 添加条目。先按你的服务商提供的信息选择 Type,再逐项填写地址、端口、认证及传输相关字段。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等协议所需字段不同;不要只因为地址与端口相同,就把一套参数用于另一种 Type。

通过 Scan QR Code 导入时,应核对来源与识别后的字段。二维码只是参数载体,不代表其中内容已经过验证。保存后在 Home 选中预期条目,执行 Connectivity Test,再进行实际访问。若测试失败,先回查录入完整性、认证内容和服务有效性,不要直接归因于规则。

导入与更新已有订阅

已有订阅链接时,通过添加入口选择 Subscribe,粘贴完整地址并保存。订阅通常包含敏感凭据,应避免出现在截图、公开文档或聊天记录中。若复制内容带有前后空格、换行或遗漏查询参数,可能出现解析失败或列表为空。订阅地址与普通网页地址也不能仅凭外观相似就互换。

服务商调整列表后,使用对应订阅的更新操作获取新条目。更新列表不等于替换当前 Config,也不保证更新前选中的条目继续存在。更新后重新检查分组、所选服务器和实际连接;对订阅生成条目的手工改动可能在下次更新时被覆盖,重要参数应通过你自己的安全方式留存。

删除前先判断条目来源

整理列表时,先区分手工添加条目与订阅条目。删除某个订阅分组可能影响组内多条服务器记录,而只改显示名称未必改变连接参数。若准备替换订阅,先验证新列表可用,再清理旧记录;不应在未确认恢复方式时一次删除全部条目。解析问题可继续查看订阅解析失败自查清单。

04 / Settings · On Demand

On Demand 按需连接

按条件触发连接行为,不负责判断所选服务器是否适合当前任务。

On Demand 用于让系统根据已配置的网络条件触发 VPN 连接。在 Settings 中查找 On Demand 相关设置,按实际可见的选项配置条件。它与 Home 中的手动连接开关用途不同:手动开关控制当下连接,On Demand 则可能在条件再次满足时重新发起连接。

设置前先完成一次稳定的手动连接,确认所选服务器与 Global Routing 都符合预期。随后从单一条件开始,分别验证进入条件、离开条件、锁屏后恢复以及网络切换时的行为。不要一次堆叠多组条件,否则某组条件覆盖另一组时,容易出现“已经关闭却又连接”的误解。

若设备重新连接,先检查 On Demand 是否仍处于启用状态,再检查系统 VPN 设置及其他相关自动化条件。暂时需要停止自动连接时,应处理触发条件,而不只是反复切换 Home 开关。不同系统环境下的触发时机可能不同,保存后必须用实际网络切换验证。

05 / Data

Data 流量统计与记录

用于观察客户端记录到的传输活动,不应直接当作服务商账单。

Data 用来查看应用所提供的流量统计与相关记录。先核对当前页面展示的统计范围和时间口径,再解释上传、下载或累计数值。不同记录可能针对当前连接、某个对象或一段统计范围;不要把不同口径的数据直接相加,也不要将单个页面的数值等同于设备全部网络用量。

验证某个操作是否产生流量时,先记录观察起点,再单独打开目标并等待传输结束,随后返回 Data 对照变化。后台同步、媒体预加载及应用自身请求都可能同时产生流量,因此短时增长只能帮助缩小范围,不能单独证明某个域名命中了指定策略。

服务商的计费口径可能包含不同的时间边界、协议开销或统计规则,Data 与其用量显示不一致时,应分别确认双方口径。清理统计之前保存确实需要的记录,并阅读清理操作的作用范围;清零本地记录不等于改变远端用量。若要确认分流是否正确,应结合目标请求的连接信息与当前规则,而不是只看总流量。

06 / Settings

Settings 常用项

下列名称按英文界面辨认。具体入口层级与可用选项以当前应用实际显示为准,相关设置也可能由当前配置文件提供。

DNS:核对域名解析路径

DNS 将域名解析为连接使用的地址。检查 Settings 中 DNS 相关设置时,也要查看当前 Config 是否包含 DNS 参数,不能只改一个页面就假定实际解析路径已经变化。记录原设置后再调整,确认所填地址和格式符合对应选项要求,并检查解析请求通过什么路径发送。

出现域名访问失败、地址类规则与预期不同或某些资源偶尔加载失败时,可先查看解析结果,再与实际连接地址对照。一个域名可能返回多个地址,缓存也可能保留旧结果;修改后应重新发起请求,必要时使用应用提供的相关清理操作。不要仅凭更换解析地址后某次访问成功,就断定所有连接问题都已解决。

Test Method:理解 Connectivity Test 的含义

Test Method 决定连接测试采用的方式,在 Settings 的测试相关选项中查找。不同方式探测的层面不同:某项测试能够成功,并不代表认证、目标网页及完整传输过程都正常。先确认测试方法和测试目标,再从 Home 对所选服务器执行 Connectivity Test。

比较条目时应保持方法、目标和本地网络一致,尽量在接近的时间完成。某条目测试没有结果,也可能与测试目标或探测方式有关;应再用实际需要访问的目标验证。不要把一次测试数值当成长期稳定性结论,也不要为了获得更小的数值反复改动与测试无关的配置。

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

Today Widget 相关设置用于配置相应小组件入口的显示或操作内容。在 Settings 中核对应用提供的选项,再到系统支持的小组件界面完成添加。能否展示、如何添加以及可执行哪些操作,取决于当前系统与应用支持情况,不能把某种布局视为所有设备上的固定界面。

小组件适合快速查看状态,但显示可能存在刷新间隔。执行操作后回到 Home 核对实际连接状态与所选服务器,不要仅凭组件文字判断当前连接一定成功。若组件表现与应用内不一致,先在应用中确认状态,再检查系统的小组件刷新与可用性。

iCloud:同步后确认实际生效内容

iCloud 相关功能用于在符合条件的设备间保存或同步应用支持的数据。在 Settings 中查看相关选项,并检查系统已登录的 Apple 账户及 iCloud 权限。开启前先阅读应用对同步范围的说明,不应假定所有服务器、配置文件、统计与系统 VPN 状态都会一起同步。

跨设备使用时,先保留重要资料,再等待同步完成并逐项核对列表。同步得到某份配置文件后,仍需确认它是否已被选为当前文件,以及对应服务器是否有效。不要把同步当成独立备份:删除或修改也可能被同步到其他设备,连接凭据同样需要谨慎保管。

Diagnostics:围绕一个失败现象收集线索

Diagnostics 用于查看应用提供的诊断信息或执行相关检查。在 Settings 中寻找该入口,记录发生问题时的网络、Global Routing、所选服务器及操作顺序,再复现一次问题。不同诊断项目回答的问题不同,应先明确是在检查解析、建立连接,还是后续的数据传输。

阅读结果时,把目标地址、失败阶段与配置联系起来,不要根据单条错误文字连续改动多个设置。需要保存或转述诊断内容时,先移除订阅地址、认证信息、个人访问记录等敏感内容。诊断用于定位问题,不会自动修正服务商侧状态,也不能替代对已有服务信息的核对。

07 / 验证顺序

设置之后怎样确认结果

一次只改变一个变量,并保留可回退的原设置。

先确认连接基础

  1. 在 Home 核对所选服务器,确认没有选到旧条目。
  2. 核对 Type、认证与传输参数,执行 Connectivity Test。
  3. 检查连接开关和系统 VPN 状态,再进行实际访问。
  4. 如存在自动重连,回查 On Demand 的启用状态与条件。

再确认分流结果

  1. 确认 Global Routing 为 Config,且目标配置文件已生效。
  2. 从上到下查找首条可能命中的规则,检查策略引用。
  3. 核对 DNS 结果与地址类规则的匹配条件。
  4. 重新发起目标请求,对照连接信息;完成后恢复日常模式。
修改 Config 后,为什么连接行为没有改变?

先确认修改的是当前生效文件,再确认 Global Routing 选择 Config。随后检查目标是否被更靠前的规则命中,并重新建立目标连接。已有连接、DNS 缓存及编辑了未启用文件,都可能造成“修改没有生效”的表象。

订阅更新成功,是否表示全部服务器都可用?

更新成功表示本次获取与解析列表完成,不等于每条服务器都已通过认证和实际访问验证。更新后要重新核对所选条目,再执行测试并访问目标。若仅部分条目失败,应分别检查参数与服务状态,而不是立即重置所有设置。

Data 有流量,为什么页面仍然无法正常打开?

有传输记录不等于整个请求成功。解析、连接尝试、部分资源或后台任务都可能产生流量。应检查具体失败目标和阶段,确认是否有 REJECT 误匹配、认证失败或目标服务异常,再用 Diagnostics 收集对应线索。

首次配置请从使用说明按步骤完成;需要从获取、授权到日常维护的连续说明,请阅读新手到进阶完整手册。