Shadowrocket 功能介绍与常用设置 - 小火箭Shadowrocket 官网

ROUTING

Global Routing：三种工作方式

Config 按规则决定去向，Proxy 使用代理方式，Direct 使用直接连接方式。

是什么：Global Routing 决定客户端如何处理进入其网络通道的请求。它不是服务器列表，也不等同于连接开关。选择某台服务器，只是确定需要代理时所用的出口；选择 Config、Proxy 或 Direct，则是在决定请求按什么原则处理。三种方式适用于不同的验证场景，不能用切换方式代替修复错误的服务器参数。

在哪里、怎么设：进入 Home，打开 Global Routing，按当前需求选择 Config、Proxy 或 Direct。需要按域名、地址等条件分流时，先在 Config 确认启用的配置，再选 Config；需要暂时检查当前代理服务器能否承载请求时，可选 Proxy；需要比较当前网络直接访问的表现时，可选 Direct。切换后重新发起目标请求，不要只观察原来已经建立的连接。

界面选项	处理原则	适用情形	核对重点
Config 配置	按当前启用配置中的规则与策略处理请求。	需要对不同目标分别指定 DIRECT、PROXY 或其他已定义策略。	配置是否启用、规则先后顺序、策略名称是否存在。
Proxy 代理	对进入客户端处理范围的请求采用代理方式。	临时确认所选服务器与代理链路是否可用。	SERVER 选择、协议参数、目标服务是否可访问。
Direct 直连	对进入客户端处理范围的请求采用直接连接方式。	比较当前网络的直接访问结果，辅助定位分流问题。	本地网络是否正常，是否仍存在自动连接条件。

CONFIG · RULE

规则分流：匹配条件与执行策略

是什么：规则由“匹配什么”和“匹配后怎么处理”两部分组成。DOMAIN、DOMAIN-SUFFIX 等关键字描述匹配条件，DIRECT、PROXY、REJECT 等描述处理策略。规则按顺序检查，前面已匹配的请求通常不会再交给后面的规则，因此规则的位置与规则内容同样重要。Global Routing 选为 Config 时，才应围绕当前配置的规则检查分流结果。

在哪里、怎么设：进入 Config，确认当前启用的文件，再检查其中的 [Rule] 段。修改前保留一份原配置，只调整与目标请求相关的条目。将明确、范围较小的例外放在合适的前序位置，并检查最后的 FINAL。若策略引用配置内定义的组名，还要确认名称拼写一致、组内有可用选择。

关键字	匹配或处理含义	使用时注意
`DOMAIN`	匹配完整域名。	适合只处理一个明确主机名的情况。
`DOMAIN-SUFFIX`	匹配域名本身及其子域名。	范围比单个 DOMAIN 更广，先确认子域名是否也适用。
`DOMAIN-KEYWORD`	按域名中包含的关键字匹配。	过短的关键字容易包含不相关目标。
`IP-CIDR` / `IP-CIDR6`	匹配 IPv4 或 IPv6 地址范围。	注意地址族、掩码与实际连接地址。
`GEOIP`	按 IP 地理归属数据库匹配。	归属判断不等同于域名所属地区，结果受数据库影响。
`DIRECT` / `PROXY` / `REJECT`	分别用于直接连接、代理处理或拒绝请求。	它们是策略，不是域名匹配类型。
`FINAL`	处理前面的规则均未匹配的请求。	通常放在规则末尾，明确剩余请求的去向。

最小规则片段

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

这个片段只说明匹配逻辑：与 example.com 及其子域名匹配的请求交给 PROXY，其余交给 DIRECT。它不是适用于所有用户的完整配置；PROXY 的实际出口仍需结合当前配置及服务器选择确认。编辑后重新访问测试目标，查看连接记录中的目标与策略，再判断是否命中预期条目。

注意：网页可能同时访问多个域名。主页面能打开，不代表图片、登录或接口请求使用相同策略。排查时记录具体失败的目标，避免凭网站名称一次添加过宽的规则。规则关键字的进一步说明见术语表。

HOME · ADD SERVER

订阅与服务器管理

是什么：服务器条目保存连接所需的地址、端口、协议与认证信息；Subscribe 则通过用户已有的订阅链接读取一组服务器条目。订阅、服务器与 Config 是不同对象：导入一组服务器，不表示规则文件也已正确启用；启用 Config，也不表示其中引用的服务器一定有效。

在哪里、怎么设：在 Home 打开 Add Server。已有订阅时，将 Type 设为 Subscribe，粘贴自己的服务商提供的完整链接，保存后检查导入结果。已有单台服务器信息时，按提供的协议选择 Type，再逐项填写参数。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等协议的字段并不相同，不应仅因名称相近就套用另一种协议的参数。

先核对输入内容是否完整，特别是订阅链接末尾的参数；不要把说明文字一起粘贴。
保存后查看 Home 中的分组与服务器条目，确认导入的是预期内容，再执行 Connectivity Test。
选择要使用的 SERVER，然后检查 Global Routing；如使用 Config，同时确认规则实际引用的策略。
更新订阅后重新检查当前选择，条目名称或内容可能变化，不要假定原来的选择始终有效。

注意：订阅更新失败和服务器连接失败是两个环节。前者先检查链接有效性、当前网络能否取得订阅内容；后者再检查服务器地址、端口、认证与传输设置。订阅链接可能包含访问凭据，截图、日志或求助文字中应遮去完整链接及认证字段。删除条目前先确认是否保留了原始信息，手工编辑订阅生成的条目也可能在后续更新时被替换。

ON DEMAND

On Demand：按条件触发连接

是什么：On Demand 用于在符合已配置条件时由系统触发 VPN 连接。它解决的是“何时建立连接”，而 Global Routing 与 Config 解决的是“建立连接后请求怎么处理”。打开 On Demand 不会自动补齐服务器信息，也不会使错误的配置变为可用。

在哪里、怎么设：进入 Settings，查找 On Demand 相关设置，按应用内提供的网络条件配置。开始前先手动连接，确认当前 SERVER 和 Config 能正常工作；随后只加入一个明确需要的触发条件，保存并切换到对应网络验证。若界面按 Wi-Fi 或蜂窝网络提供条件，应分别测试，不要从一种网络的结果推断另一种网络。

注意：启用后，手动断开连接不一定代表系统以后不会再次连接。排查“关掉后又连接”的现象时，先检查 On Demand 与系统中对应的按需连接设置，再观察网络切换后的行为。暂时需要完全停止自动触发时，应先关闭相关条件，再操作连接开关。

On Demand 本身不能单独说明耗电高低。信号质量、网络切换频率、请求量以及持续连接都可能影响电池表现。建议保持其他条件相近，在系统电池页面比较一段实际使用情况，而不是只凭 VPN 标识是否出现作判断。连接稳定后再逐步增加条件，便于确认是哪一次修改改变了行为。

DATA

Data：流量统计与请求观察

是什么：Data 用于查看客户端记录的流量与连接相关信息，帮助确认使用期间是否产生请求、流量是否持续增长，以及调整设置前后的变化。它是客户端侧的观察入口，不等同于服务商的账单，也不能单凭总流量判断某一条规则是否正确。

在哪里、怎么设：进入 Data，先看当前显示的统计范围与时间口径，再进行一次可重复的访问测试。需要观察单个问题时，先记下现有统计或保存必要记录，随后打开同一个目标，比较测试前后的变化。若使用清除记录或重置统计功能，先确认操作范围，避免把仍需排查的证据一并清掉。

注意：上传与下载、直接连接与代理连接、当前会话与累计记录可能采用不同口径，应按界面实际标签阅读。服务商侧的计量可能包含协议开销，结算周期也可能不同，因此双方数值不一定完全相同。系统蜂窝网络统计又有独立的时间范围，比较前需要把观察区间对齐。

发现“流量在增加但页面打不开”时，不要立即判断服务器正常。增加的流量可能来自后台应用或其他域名，应继续核对目标请求与错误信息；发现没有新增记录时，则先检查连接开关、测试请求是否重新发起，以及请求是否进入客户端处理范围。分享记录时只保留排查所需部分，并遮去私人域名、地址与认证信息。

SETTINGS

Settings：常用项逐项核对

先记录当前值，一次只改一项；配置文件中的设置也要一并检查。

DNS：先判断解析问题还是连接问题

是什么、在哪里：DNS 将域名解析为地址。相关选项可在 Settings 的 DNS 设置以及当前 Config 的 DNS 相关内容中检查；实际生效方式需要结合所用配置判断，不能只看一个页面。

怎么设、注意什么：先保持已有可用设置，记录出问题的域名与当前网络。只有在确认存在解析异常后，再按配置需求调整 DNS，并重新建立连接、发起请求验证。能解析出地址不代表目标连接一定成功，地址变化也不一定是故障。不要同时修改 DNS、服务器与规则，否则无法判断是哪项设置影响结果。

Test Method：统一 Connectivity Test 的测试口径

是什么、在哪里：Test Method 决定服务器测试所采用的方法，在 Settings 中检查。它影响 Connectivity Test 的结果含义，而不是替代真实业务请求。

怎么设、注意什么：按测试目的选择应用内提供的方法，比较服务器时保持方法、测试目标与当前网络一致。不同测试方法检查的环节不同，结果不宜直接混在一起比较。测试成功后仍需打开实际目标；测试失败也要结合服务器协议与网络环境核对，不能仅凭一次结果删除全部条目。

Today Widget：快捷操作后仍需确认状态

是什么、在哪里：Today Widget 是系统快捷查看或操作客户端状态的入口；在 Settings 中检查相关选项，并在系统允许的位置添加对应组件。组件是否可添加及其呈现方式，以当前系统和应用内支持情况为准。

怎么设、注意什么：先在应用内完成服务器与路由设置，再配置快捷入口。使用后回到 Home 确认连接状态、所选 SERVER 与 Global Routing。系统组件的显示可能需要刷新，不能只凭组件上一次展示的内容推断当前状态；排查故障时优先以应用内状态和实际请求结果为依据。

iCloud：核对同步范围，不把同步当作完整备份

是什么、在哪里：iCloud 相关功能用于在满足条件时同步应用支持的内容。进入 Settings 查看同步选项，同时确认系统 iCloud 设置允许 Shadowrocket 使用对应服务。

怎么设、注意什么：先核对设备使用的 iCloud 账号和网络状态，再按界面列出的范围启用。换设备后逐项检查配置、服务器与选择状态，不要假定所有数据和系统授权都会随之恢复。同步可能需要时间，多台设备同时编辑前先保留可恢复的配置副本；包含订阅或认证信息的内容仍应按敏感资料管理。

Diagnostics：围绕一个故障收集信息

是什么、在哪里：Diagnostics 为排查提供诊断入口，可在 Settings 中查找。诊断信息的用途是缩小问题范围，并不自动替代服务器参数核对或真实访问测试。

怎么设、注意什么：先记下发生问题时的网络类型、Global Routing 与所选 SERVER，再按界面提示运行相关检查。需要日志时，只在复现问题所需的范围内记录，保存必要结果后恢复日常设置。导出或分享前检查是否包含订阅地址、认证字段、私人请求目标和其他敏感内容。缺少故障发生时间与操作过程的长日志，通常不如一次清晰、可重复的测试有效。

CHECK ORDER

设置验证：按固定顺序定位问题

完成设置后，先验证最短路径，再扩大检查范围。连接开关已开启，只说明已经发起连接；Connectivity Test 有结果，只说明所选测试得到反馈；目标页面正常访问，才是该次实际请求的结果。这些观察各有用途，不应互相替代。

确认输入：在 Home 检查已有服务器或订阅是否导入完整，核对地址、端口、协议与认证信息，并确认当前 SERVER。
确认处理方式：查看 Global Routing。使用 Config 时，进入 Config 核对启用文件、规则顺序和 FINAL；临时使用 Proxy 或 Direct 测试后，记录并恢复原设置。
确认连接与自动触发：查看连接开关和系统授权状态。若连接自行恢复，检查 On Demand；若网络切换后才出错，分别复现 Wi-Fi 与蜂窝网络场景。
确认目标请求：重新打开同一目标，结合 Data、连接记录与 Diagnostics 判断失败发生在解析、服务器连接还是具体请求环节。
回退并复测：每次只调整一项，保留修改前的值。没有改善时恢复原值，再检查下一项，避免把多个独立问题混在一起。

如果尚未完成首次连接，先按入门指南顺序操作；遇到购买、恢复或商店可见性问题，阅读获取指南；需要核对设置词含义时，使用术语表。Shadowrocket 只在 Apple 平台通过 App Store 发行，系统要求以 App Store 页面标注为准。