官方手册 / 功能与设置

Shadowrocket 功能介绍
分流、连接与诊断设置

先确认流量怎么处理,再设置何时连接,最后用测试与记录核对结果。以下说明适用于 iPhone 与 iPad 上的常用操作。

需要按规则分流时选择 Config;Proxy 与 Direct 适合明确的全局需求或临时对照测试。Global Routing 是整体处理方式,不是服务器列表,也不表示当前是否已建立连接。切换姿态后仍要检查 Home 中选择的服务器、连接开关及目标访问结果。

界面选项 处理逻辑 适用条件 检查重点
Config(配置) 根据当前生效配置中的规则决定策略。 不同域名或地址需要分别走 PROXY、DIRECT 或 REJECT。 Config 中选中的文件、规则顺序与 FINAL。
Proxy(代理) 以代理方式处理接管的流量,不按 Config 的普通分流规则逐项选择。 临时验证所选服务器能否访问目标。 服务器是否可用,以及目标是否允许该连接。
Direct(直连) 以直连方式处理接管的流量。 对照当前网络的直连表现,区分代理链路与本地网络问题。 本地网络、DNS 与目标本身的可用性。

设置与验证

在 Home 打开 Global Routing,选择所需姿态后返回。使用 Config 前,先在 Config 中确认目标配置已被选中,再连接并测试一个已知目标。若同一目标在 Proxy 下可访问、在 Config 下失败,优先检查命中的规则、策略指向与 DNS;这只是缩小范围,不能单凭一次对照认定规则一定有误。

Proxy 不应被理解为“修复配置”的按钮。临时测试后应恢复原先所需姿态,否则局域网访问和其他流量的处理方式可能改变。Direct 也不等于关闭连接开关:它改变的是处理方式,是否保持连接仍由开关与 On Demand 等条件决定。

继续阅读:Config、Proxy、Direct 的区别与日常用法 →

规则由“匹配什么”和“命中后怎么处理”组成。DOMAIN 精确匹配完整域名;DOMAIN-SUFFIX 匹配指定域名及其子域名;DOMAIN-KEYWORD 按域名中的关键词匹配;IP-CIDR 与 IP-CIDR6 分别匹配 IPv4、IPv6 地址范围;GEOIP 按地址归属数据库匹配。不同类型依据的信息不同,域名规则不能直接替代地址规则。

PROXY、DIRECT、REJECT 是策略,不是规则类型:它们分别表示交给代理处理、直接连接与拒绝连接。规则通常自上而下检查,首条命中即生效,因此具体规则应放在宽泛规则之前。FINAL 为前面均未命中的流量提供兜底处理,应放在规则末尾。

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

示例中,ads.example.com 先命中 REJECT,而不是落入后面的 example.com 范围。其余该域名范围走 PROXY,指定私有地址范围走 DIRECT,剩余流量由 FINAL,DIRECT 处理。示例仅解释语法,不代表这些域名对应可用的连接服务,也不应直接代替完整配置。

修改时只改变一个判断条件

先保留原配置,在 Config 中编辑副本的 [Rule] 段,保存并确认选中该文件,再回到 Home 使用 Config 测试。修改后重新发起目标请求,避免把旧连接的表现当作新规则的结果。若实际策略与预期不同,应结合请求记录确认应用使用的真实域名与目标地址;一个页面可能同时访问多个域名,不能只给地址栏中的域名写一条规则就认为所有请求都会走同一策略。

以下操作以用户已有自己的订阅或服务器信息为前提。服务器条目保存连接地址、端口、协议与认证等参数;Subscribe 用于按已有订阅地址获取和更新一组条目。Config 则负责全局参数与分流等配置,导入服务器资料不等于同时获得了适合当前需求的规则文件。

手动添加与订阅导入

只有单个服务器资料时,在 Home 进入 Add Server,按原始资料选择协议并逐项填写。Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2 等协议的字段并不相同;应以应用实际显示的协议选项与已有资料为准,不能把不同协议的密码、标识或传输参数互换。

使用订阅时,在 Add Server 中选择 Subscribe,填入自己的完整订阅地址并保存,再更新该订阅。导入后检查分组与条目是否出现,选择一个条目运行 Connectivity Test,最后访问实际目标。订阅更新成功只说明资料已被取得并解析,并不保证每个服务器当前都可用。

更新之前区分条目来源

订阅中的条目可能在更新时被重新生成,直接改写其中的字段不一定会长期保留。需要持续使用的本地调整,应先保存必要信息并区分手动条目与订阅条目。删除分组、清理重复项或替换订阅前,确认当前连接依赖哪一项,避免把正在使用的资料一起移除。

On Demand 根据设定条件请求系统建立连接,适合需要在特定网络环境下自动连接的情况。它与规则分流分工不同:On Demand 处理连接的触发条件,Global Routing 与 Config 决定连接后的流量处理。开启 On Demand 并不会自动补齐订阅、选择可用服务器或纠正规则。

初次设置前,先关闭自动触发,手动完成服务器选择、VPN 配置授权和访问验证。确认基础连接正常后,再进入 Settings 的 On Demand,依据页面实际提供的网络条件设置行为。不同设备与应用状态下的可用选项可能有差异,按当前界面逐项确认,不应直接照搬不对应的操作路径。

设置后分别在需要触发和不需要触发的网络环境中验证,观察是否按预期建立连接,再检查一次目标访问。若手动断开后又自动连接,先检查 On Demand 条件与系统中的相关 VPN 设置;若切换网络后连接失败,先在新网络手动测试服务器,不要立即增加更多触发条件。

自动连接不等于服务器始终可用。网络切换、认证失效、订阅资料变化均可能影响结果。排查期间暂时关闭 On Demand,可以避免自动重连干扰对照测试;测试结束后再恢复原先需要的条件。

Data 用于查看客户端记录的流量情况。它适合观察连接期间是否发生数据传输、比较某次操作前后的变化,但不应当作连接服务的结算账单。客户端记录范围、统计时间以及服务端计量口径可能不同,数值不一致时应先确认各自统计的是哪些连接与哪段时间。

进入 Data 后,先看页面当前提供的时间范围与统计对象。需要做小范围验证时,记录测试前的读数,暂停其他会持续传输的任务,只访问一个目标,再观察增量。如果界面提供重置或清理操作,执行前先保存需要的记录;清理本地统计不会改变服务端记录的用量。

有流量变化不等于目标已经成功打开,后台请求、连接重试与其他应用也可能产生传输。反过来,页面加载失败但统计增加也不矛盾。应结合当前姿态、目标请求结果和 Diagnostics 判断,不能仅凭 Data 增长就认定规则正确或服务器正常。

Settings 中的选项不需要一次全部修改。先保留默认行为并建立可用基线,再根据明确的问题调整。部分功能还会受当前 Config、系统权限或设备环境影响;找不到选项时,应先核对应用内界面,不要把其他设备的菜单位置当作固定路径。

DNS:域名解析与规则判断的基础

DNS 将域名解析为地址,相关行为可能同时受到 Settings 与当前配置 [General] 段的影响。排查时先确认实际生效配置中的 DNS 参数,再检查网络是否能访问所设解析服务。不要把多个来源的参数叠加后只修改其中一处,否则很难判断是哪项设置改变了结果。

若只有部分域名失败,先比较其他域名与不同网络下的表现,再检查 DNS 结果和规则命中。一次只调整一项,重新建立连接并发起新请求。某个地址可访问并不能证明域名解析整体正常,盲目更换 DNS 也不能修复认证或服务器不可达的问题。

Test Method:理解 Connectivity Test 的测试范围

Test Method 决定 Connectivity Test 使用的测试方式。在 Settings 中找到该项,阅读当前可选方式,再使用统一的方法比较条目。如果界面允许设置测试目标,应使用已知可访问且符合测试要求的目标,并在比较期间保持相同条件。

不同方法测量的阶段不同,结果不宜直接横向比较。测试成功不代表所有网站可用,超时也可能由测试目标或当前网络引起。先确认方法与目标,再检查服务器地址、端口和认证资料;不要只按单次测试结果反复切换条目。

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

Today Widget 用于系统支持的小组件场景。先在应用中确认相关设置,再按系统提供的编辑入口添加。它的可用位置与操作方式受系统支持情况影响,应以设备实际显示为准;系统要求以 App Store 页面标注为准。

首次配置、服务器编辑和规则检查仍应回到应用内完成。小组件上的状态适合快速查看,但遇到显示未及时变化或连接结果不符时,应打开 Home 核对当前服务器与开关,而不是连续点击快捷操作。

iCloud 同步:先确认资料范围再跨设备使用

iCloud 相关功能用于在支持的范围内同步应用资料。进入 Settings 检查同步开关,并在系统设置中确认相应 iCloud 权限与可用空间。具体同步对象以应用界面说明为准,不应把应用购买记录、服务器资料、连接状态和历史统计都理解为同一种同步内容。

首次启用前保留重要配置;在另一台设备上逐项确认资料是否到齐,再做本地修改。云端资料已经出现不代表系统 VPN 授权也已完成,目标设备仍需自行验证。服务器和订阅可能包含认证信息,启用同步前应确认所用账户与设备均由本人妥善管理。

Diagnostics:围绕一次失败收集线索

Diagnostics 用于查看或生成排查所需的诊断信息。遇到问题时,从 Settings 中对应入口进入,按当前界面提供的方式记录一次复现过程。先记下网络环境、Global Routing 姿态、所选服务器与目标,再执行一次操作,这样比混合多次切换后的记录更容易判断。

重点区分连接建立失败、域名解析失败与目标请求失败。分享记录前隐藏订阅地址、服务器认证信息及个人请求内容,仅保留定位问题所需的片段。Diagnostics 是辅助证据,不会替代正确的服务器资料,也不能仅凭一条提示推断全部原因。

  1. 确认资料。在 Home 检查所选条目的来源、协议和必要字段;订阅需要更新时先完成更新,再确认条目仍被正确选中。
  2. 确认姿态。日常规则分流使用 Config,并在 Config 中确认当前文件。需要对照时临时使用 Proxy 或 Direct,完成后恢复。
  3. 确认目标。先运行 Connectivity Test,再访问实际需要使用的目标。把测试方法、测试目标与实际访问结果分开记录。
  4. 确认自动连接。手动连接稳定后再启用 On Demand,并分别验证触发与不触发的环境。
  5. 确认记录。结合 Data 观察变化,必要时用 Diagnostics 记录一次复现;无法定位时恢复最近修改,而不是同时重写所有设置。

功能设置完成后,若仍出现开关无法启用、订阅更新失败或特定目标无法访问,可按症状进入故障排查继续检查。需要重新获取应用时,使用App Store 正版核验与购买说明;开发者为 Shadow Launch Technology Limited,应用 ID 为 932747118,兼容性与购买范围以 App Store 页面标注为准。