官方手册 · 功能与设置

Shadowrocket 功能介绍与常用设置

先确定流量如何处理,再调整连接与诊断选项。本页以 iPhone / iPad 上的操作为主,按“是什么、在哪里、怎么设、注意什么”解释常用功能;具体入口与可用选项以应用内实际显示为准。

  • Global Routing
  • 规则与服务器
  • 连接与诊断

首次使用请先完成 App Store 正版核验,再按 使用说明导入已有配置。客户端一次性买断 ≠ 线路套餐。订阅链接或服务器信息从你的服务商处获取。

Global Routing:先选流量处理方式

是什么:Global Routing 决定连接经过 Shadowrocket 处理时采用哪一种整体路由方式。Config、Proxy、Direct 是三种不同选择,不是连接质量等级,也不是三种协议。日常需要按规则处理不同目标时使用 Config;需要隔离规则影响时,可临时用 Proxy 或 Direct 对照。

在哪里与怎么设:在 Home 找到 Global Routing,进入后选择 Config、Proxy 或 Direct。使用 Config 前,先在 Config 确认当前启用的配置;使用 Proxy 前,先在 Home 选定可用服务器。修改后用同一目标重新建立连接,不要只观察已经打开的页面。

界面值 处理方式 适用场景 先核对什么
Config 按照当前配置中的规则与策略决定连接去向。 日常分流,需要区分不同域名或地址的处理方式。 当前配置、规则顺序和规则引用的策略。
Proxy 整体采用代理路由,仍需考虑本地网络与系统保留路径。 临时检查某个目标是否因分流规则而走了不同路径。 当前服务器及其协议、认证与传输参数。
Direct 采用直接连接方式,不通过所选代理服务器转发。 建立本地网络对照,检查目标能否直接访问。 当前网络是否能够直接到达目标。

注意什么:Proxy 不能修复服务器认证失败,Direct 也不代表所有网络功能都已关闭。Global Routing 的选择与 Home 的连接开关是两件事。测试完成后恢复原来的模式,避免把临时排查设置当作长期设置。进一步操作见 Global Routing 使用步骤。

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

是什么与在哪里:规则分流在 Config 模式下,根据当前配置的匹配条件选择处理策略。打开 Config,先确认启用的是哪份配置,再查看其中的规则内容。规则关键字负责判断“匹配什么”,行末策略负责决定“如何处理”;两者不能混为一谈。

规则类型匹配对象使用时核对
DOMAIN完整域名。是否只希望匹配一个确定的主机名。
DOMAIN-SUFFIX域名本身及其子域名。后缀范围是否比预期更大。
DOMAIN-KEYWORD域名中包含的关键字。是否会匹配到名称相近但用途不同的域名。
IP-CIDR / IP-CIDR6IPv4 / IPv6 地址范围。地址段、掩码以及是否涉及域名解析。
GEOIP地址数据库中的地区分类。数据库分类不等于服务的实际用途或归属。
FINAL前面规则未命中时的最终处理。兜底策略是否符合预期。

怎么设:把范围明确的规则放在范围较宽的规则之前,并将 FINAL 作为最终兜底。下方仅演示规则语法,example.com 是说明用域名,不是一份供日常直接启用的完整配置。PROXY 表示使用代理策略,DIRECT 表示直接连接,REJECT 表示拒绝匹配的连接;若配置引用了自定义策略名称,还需确认对应策略确实存在。

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

注意什么:同一个目标可能涉及多个域名和地址,仅修改首页域名不一定涵盖全部连接。检查规则时,要结合连接记录确认实际请求与命中的策略。Config 文件还可能包含 DNS、策略组等其他内容;更新远程配置后应再次核对本地修改是否保留,重要改动先备份。

订阅与服务器:把入口参数和规则配置分开

是什么与在哪里:Home 中的服务器条目用于保存连接地址、端口、认证和协议参数;Subscribe 用于管理已有订阅的地址及更新。Config 则负责规则与相关配置。导入服务器列表不等于已经配置好分流,启用规则文件也不等于已经有可连接的服务器。

怎么设:已有订阅时,从你的服务商处获取链接,在添加入口中选择 Subscribe,填写后保存并执行更新。手动添加时进入 Add Server,先选择与原始信息一致的协议,再核对地址、端口和认证字段。Shadowsocks、VMess、VLESS、Trojan、WireGuard、Hysteria2 等协议所需参数不同,不应把某种协议的字段机械套用到另一种协议。

如果信息通过二维码或剪贴板提供,可使用对应导入入口;导入后仍要打开条目检查协议与服务器地址。多份订阅可按用途命名,保留清晰分组,再使用 Connectivity Test 比较同一测试条件下的结果。排序是整理列表的方法,不应只凭一次测试就删除其他条目。

注意什么:订阅更新可能新增、移除或替换服务器,手动编辑的订阅条目也可能在后续更新时变化。删除前先确认删除的是单个条目还是整组订阅。订阅地址通常包含访问凭据,分享日志或截图前应遮蔽。完整操作见 Subscribe 管理与 扫码与剪贴板导入。

On Demand:按条件触发连接

是什么:On Demand 用于按设定条件触发连接行为。它解决的是“什么时候尝试连接”,Global Routing 解决的是“连接后如何处理流量”,两者作用不同。On Demand 不会替用户补全服务器参数,也不能保证服务器在每个网络环境下都可达。

在哪里与怎么设:在 Settings 中找到 On Demand 相关选项,按应用实际提供的条件设置。先确认手动连接能够正常使用,再启用按需行为;需要按网络条件区分时,逐项核对相应条目,不要一开始就同时更改多个条件。设置后分别在预期触发与不应触发的网络环境中验证。

注意什么:切换 Wi-Fi 与蜂窝网络时,系统需要重新建立网络路径,短暂重连并不一定意味着配置错误。如果手动关闭连接后又出现连接行为,先检查 On Demand 是否仍然启用。排查连接问题时可暂时停用按需条件,以便建立可重复的手动测试过程;结束后再恢复需要的设置。

Data:观察流量与连接记录

是什么与在哪里:Data 用于查看应用提供的流量统计及相关连接信息。进入 Data 后,应先辨认界面所标示的统计范围、连接方向和记录内容,再据此判断哪一类请求正在发生。统计反映的是客户端观察到的网络活动,不是服务商账单。

怎么用:排查某个应用或页面时,先记下当前统计状态,再只进行一个目标操作,然后回到 Data 对照变化。如果当前界面提供连接明细,可进一步查看目标地址与处理策略,检查请求是否符合预期。需要清空记录或重置计数时,先保存必要信息,并确认按钮实际影响的范围。

注意什么:网页缓存、后台刷新、连接复用和其他应用的流量都可能影响观察结果。流量增加只能说明有数据经过相应统计路径,不能单独证明目标内容加载成功。客户端统计与服务商计费可能采用不同口径,剩余用量应以服务商给出的记录为准。连接记录还可能包含访问域名,导出时应按隐私信息处理。

Settings:按用途调整常用项

Settings 集中管理测试、系统集成与部分网络行为。先保持能正常工作的设置,再根据明确的问题调整对应项目。某些参数也可能由当前 Config 提供,因此“在 Settings 修改过”不代表当前连接一定采用该值;需要同时核对配置文件与实际连接记录。

DNS:检查域名解析路径

是什么与在哪里:DNS 负责把域名解析为地址。相关入口可在 Settings 及当前 Config 的 DNS 内容中核对。它与代理服务器地址、TLS 的名称验证有关,但不是同一个参数;不要因为名称相近就把这些字段填写成相同内容。

怎么设与注意什么:先记录现有 DNS 配置,确认解析请求采用的路径以及配置是否指定了相应规则。遇到域名访问失败而地址连接表现不同时,再检查解析结果。每次只改一项并重新测试;随意叠加多个解析选项会让故障难以定位,也不代表解析一定更快。TLS 验证失败还应核对服务器名称、证书与设备时间,不能全部归因于 DNS。

Test Method:统一 Connectivity Test 的比较条件

是什么与在哪里:Settings 中的 Test Method 决定连接测试采用的方法。Home 中执行 Connectivity Test 时,要结合所选方法理解结果;不同测试方法测量的阶段不同,结果不宜直接混排比较。

怎么设与注意什么:先选定测试方法,若对应方法提供测试目标或超时选项,也一并记录。保持本地网络和测试条件一致,再比较服务器。测试成功不等于所有目标都能访问,延迟较低也不代表持续传输吞吐量更高;超时则应继续检查本地网络、服务器参数和测试目标。更多说明见 延迟测试与排序。

Today Widget:提供系统中的快捷入口

是什么与在哪里:Today Widget 是与系统组件相关的入口,先在 Settings 核对应用提供的选项,再在设备支持的系统组件区域检查可添加项目。是否可添加、显示位置和交互方式,以当前系统及应用内实际呈现为准。

怎么设与注意什么:先在应用内确认连接和服务器选择正确,再添加可用组件并测试操作结果。快捷入口适合减少进入应用的步骤,不代替 Config 与服务器管理。组件显示与应用状态不一致时,先打开应用确认实际连接情况,再检查系统组件是否需要刷新。

iCloud:区分同步、恢复与应用购买

是什么与在哪里:iCloud 相关功能用于同步或恢复应用支持的数据,入口按 Settings 实际显示核对。它与 App Store 的已购记录承担不同任务:重新取得应用,不代表服务器条目和配置文件已经一并恢复。

怎么设与注意什么:启用前确认设备已登录所需的 iCloud 账户,并允许相应服务使用 iCloud。多设备操作时,先在原设备确认数据已保存,再到另一台设备核对同步范围与结果;不要在两台设备上同时大量删除或改名。重要配置应另留可恢复的备份,同步不等同于保留每次修改的历史副本。订阅凭据属于敏感数据,也应纳入账户与备份管理。

Diagnostics:用单次复现缩小故障范围

是什么与在哪里:Diagnostics 用于收集或查看排查所需的诊断信息,在 Settings 中查找对应入口。它应与 Home 的 Connectivity Test、Data 的连接记录配合使用:前者帮助检查连接条件,后者帮助确认实际请求发生了什么。

怎么用:先写清故障现象,例如“某个域名失败,其他目标正常”,而不是只记录“不能用”。记下当时的 Global Routing、所选服务器和本地网络类型,再开启当前界面提供的必要诊断功能,只复现一次问题。将出现问题前后的记录与操作时间对应起来,优先寻找解析、连接、认证或规则选择中的异常。

注意什么:诊断记录可能包含服务器地址、订阅链接、访问域名和认证相关内容,发送给他人前先检查并遮蔽。完成排查后,恢复临时调整的日志设置,避免持续积累不必要的记录。不要为了排错同时更换服务器、DNS、规则与测试方法,否则即使恢复正常,也无法判断哪一项起了作用。

常用设置核对顺序

对刚导入的配置,先建立一条可重复的验证流程,再考虑自动化和同步。以下顺序能把“服务器是否可用”“规则是否正确”“系统是否按需连接”分开检查,减少相互影响。

  1. 核对服务器。在 Home 选择条目,检查协议、地址、端口与认证字段,保持 Test Method 不变后执行 Connectivity Test。
  2. 核对模式。确认 Global Routing。使用 Config 时,检查当前配置与目标规则;临时改变模式后,记录并恢复原值。
  3. 核对实际请求。连接后打开一个明确的目标,在 Data 或可用连接记录中观察相应变化,区分目标失败与整体连接失败。
  4. 再启用按需功能。手动连接验证通过后设置 On Demand,分别测试网络切换及预期触发条件。
  5. 最后整理与备份。确认订阅命名、配置备份和 iCloud 同步结果,再添加 Today Widget 等快捷入口。

Shadowrocket 是 Apple 平台的闭源商业应用,唯一获取入口是 App Store;系统要求与购买适用性以 App Store 页面标注为准。本页解释功能边界,不提供连接服务。需要连续操作步骤时,继续阅读 使用说明;需要管理多份订阅与服务器时,查看 节点管理官方手册。