官方手册 / 功能与设置
Shadowrocket 功能与设置
先确定流量走向,再调整连接条件与诊断设置。按 Home、Config、Data、Settings 的操作范围查阅,界面词保留英文原文。
能力索引
六项功能的作用范围
选择功能查看摘要;具体操作与检查方法见下方对应章节。规则片段是语法示例,不是可直接替代现有配置的完整文件。
Global Routing 与规则匹配
规则分流用匹配条件为请求指定处理策略。先在 Home 查看 Global Routing,再到 Config 确认当前使用的配置文件。只有选用 Config 时,才应按该配置的规则解释流量去向。编辑前保存原配置,检查规则排列、策略名称和最终匹配项;较宽泛的规则如果放在前面,可能先于后续精确规则命中。验证时用单个目标请求对照日志,不以连接开关状态代替规则命中结果。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
On Demand 与连接触发
On Demand 用于按已保存的条件交由系统触发连接,不负责判断所选服务器是否可用。设置入口在 Settings 的相关项目中,具体选项以设备上的界面为准。启用前先手动连接并验证一次,再逐项调整触发条件。若手动断开后又出现连接,应先核对 On Demand 与系统 VPN 设置,而不是反复删除服务器。自动触发仍会受网络切换、系统调度及连接配置状态影响,不等于连接持续可用。
Settings
On Demand
Add Server 与协议参数
多协议支持用于接入不同格式的已有服务器信息。进入 Home 的 Add Server,按原始资料选择协议类型,再填写地址、端口及对应认证参数。Shadowsocks、VMess、VLESS、Trojan 等协议的字段不能相互套用;地址和端口相同,也不代表认证方式相同。优先使用用户已有资料中的完整导入信息,手动录入时逐项核对。TLS、传输方式和服务器名称等参数应与服务端一致,不用反复切换协议来代替参数检查。
Add Server
Shadowsocks / VMess / VLESS / Trojan
HTTP / SOCKS5 / WireGuard / Hysteria2
Subscribe 与批量更新
订阅用于从用户已有的链接导入并更新服务器条目。在 Home 的添加入口选择 Subscribe,按界面填写已有链接并保存,再检查导入结果。订阅更新成功只表示数据获取与解析完成,不说明其中每个服务器都能连接。更新前记录常用条目与分组,更新后重新确认当前选择;服务端条目变更可能影响原有名称或排序。订阅链接可能包含访问凭据,排查时应遮去敏感部分,不把完整链接写入公开截图或日志。
Home
Add Server
Subscribe
Config 与生效配置
Config 管理规则及相关配置内容,与 Home 中的服务器列表不是同一个概念。进入 Config 后,先确认哪份文件正在使用,再查看其中规则和引用策略。导入文件不代表已经选中生效,修改保存后还应重新确认当前状态。需要试验时保留原文件副本,每次只调整一个部分,再用同一目标复测。外部配置可能包含 DNS 或其他处理项,覆盖现有文件前应先阅读内容,避免把连接问题与配置变化混在一起。
Config
[Rule]
DOMAIN,example.com,DIRECT
FINAL,PROXY
测试、记录与故障定位
诊断工具用于区分服务器可达性、域名解析与请求处理问题。在 Home 可对已有条目执行 Connectivity Test,在 Settings 检查 Test Method 与 Diagnostics,并按需要查看 Log。测试结果必须结合测试方式解释,某项测试通过并不能证明全部网站或业务都可用。先记录当前服务器、模式和测试目标,再复现一次失败请求;保存必要记录后关闭不再需要的详细日志。分享诊断资料前检查其中的域名、地址与认证信息。
Connectivity Test
Test Method
Diagnostics
Log
Home / Global Routing
Config、Proxy、Direct 三种模式
Global Routing 决定由 Shadowrocket 接管的流量如何选择处理路径。在 Home 打开 Global Routing,先看当前选中项,再决定是否切换。配置、代理、直连分别对应界面中的 Config、Proxy、Direct,实际操作时按英文名称识别。切换模式不是更换服务器,也不会修正服务器资料中的错误。
| 界面项 | 流量处理 | 何时使用 | 先检查什么 |
|---|---|---|---|
| Config | 按当前配置文件中的规则选择策略。 | 需要按目标地址或其他条件分流时。 | 当前配置、规则顺序、策略引用与 FINAL。 |
| Proxy | 以所选代理路径处理接管的流量。 | 临时验证所选服务器的代理连接,或明确需要统一代理时。 | 当前服务器与协议参数是否正确。 |
| Direct | 以直接连接方式处理接管的流量。 | 检查当前网络直连状况,或明确需要直接连接时。 | 当前网络及 DNS 是否可用。 |
日常使用与临时排查分开处理
已经准备好分流配置时,可使用 Config,并通过请求记录确认规则效果。怀疑规则造成异常时,记录原模式,再用 Proxy 或 Direct 对同一目标做一次对照。测试结束恢复原模式,避免把临时状态当成日常配置。某个目标在一种模式下能打开,只能帮助缩小问题范围,不能单独证明 DNS、服务器或规则中的哪一项必然有错。
Direct 不等同于关闭系统 VPN 配置。要检查是否完全停止连接,应同时查看 Home 的连接开关与系统 VPN 状态。对连接路径有明确要求时,不要只凭状态栏图标判断。
Config / Rule
规则类型与处理策略
一条规则通常包括匹配类型、匹配内容和处理策略。规则类型回答“依据什么识别请求”,策略回答“匹配后怎样处理”。在 Config 中查看当前配置的规则部分,先核对较具体的条目,再核对宽泛匹配与 FINAL。规则通常按顺序匹配,不能只确认某条规则存在,还要确认它是否有机会被执行。
按目标选择匹配条件
DOMAIN 用于完整域名匹配;DOMAIN-SUFFIX 用于域名后缀匹配;DOMAIN-KEYWORD 按域名中的关键字匹配,范围可能比预期更大。使用后缀规则时填写域名本身,不附带网页路径。对单个域名做例外处理,通常应把精确条件放在可能覆盖它的宽泛条件之前。
IP-CIDR 与 IP-CIDR6 按地址范围匹配,GEOIP 依赖地址归属数据。域名规则与地址规则观察的对象不同:域名解析结果、IPv4 与 IPv6 路径都可能影响检查结果。USER-AGENT 依赖请求中能被识别的相关信息,不宜把它理解成对所有应用都有效的应用级选择器。
策略名称与 FINAL
DIRECT 表示直接连接,PROXY 表示代理处理,REJECT 表示拒绝匹配请求。配置如果使用自定义策略名称,应确认名称有对应定义且拼写一致。FINAL 负责处理前面规则未命中的请求;它的选择会决定大量未单独列出的目标走向,因此修改时必须明确预期。
[Rule]
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.org,PROXY
FINAL,DIRECT
上例仅说明从精确匹配到最终处理的顺序。替换规则前先保存原配置;更完整的设置边界见设置参考 →
Home / Add Server / Subscribe
订阅与服务器管理
Home 用于查看、选择和管理已有服务器。单条资料可通过 Add Server 按协议录入;已有订阅链接可通过 Subscribe 导入;已有二维码可使用 Scan QR Code。选择哪种入口取决于用户手中的资料格式,而不是哪种方式能改变服务端能力。导入之前确认资料来自用户自己的服务来源,并保留原始信息以便核对。
导入后先核对,再连接
- 确认服务器列表确实出现预期条目;如果列表为空,先查订阅获取与解析,不急于修改规则。
- 打开条目检查协议、地址、端口与认证字段。TLS 或传输参数应与已有资料一致,不凭名称猜测。
- 选择准备使用的条目,执行 Connectivity Test,再进行实际请求验证。测试方式不同,结果含义也不同。
- 查看 Global Routing 与当前 Config,最后开启连接;只有这几项同时明确,才便于解释流量去向。
更新订阅会重新读取远端条目,可能出现名称改变、条目增减或原选择不再存在的情况。更新后重新核对当前服务器,不要只看“更新完成”的提示。需要手动保留的特殊参数,应先记录再更新,并核实订阅更新是否会重建对应条目。
服务器名称是识别标签,不是连接质量的证明。整理时可用便于辨认的名称区分用途,但不要把凭据放入名称。订阅链接、二维码和导出内容都可能携带认证信息;提供排查资料时只保留必要字段。需要完整导入流程时,按教程逐步操作。
Settings / On Demand
On Demand 按需连接
On Demand 的作用是让系统在符合已保存条件时触发 VPN 连接。它处理的是“何时连接”,Global Routing 处理的是“连接后怎样路由”,二者不能互相替代。进入 Settings 查看 On Demand 相关选项,先阅读当前条件,再决定是否启用;具体项目与系统表现以设备当前界面为准。
先验证手动连接,再启用触发条件
先关闭自动触发因素,手动选择服务器并验证网页请求。确认服务器、DNS 和规则工作正常后,再开启需要的 On Demand 条件。每改一项,都在对应网络环境下重新测试。不要同时修改连接条件和分流规则,否则发生变化时无法判断由哪一层造成。
手动断开后又连接,通常需要先检查按需触发设置;切换网络后没有立即恢复,则应核对触发条件、系统 VPN 状态与当前网络。系统调度、网络可用性和服务器响应都会影响实际结果,On Demand 不能作为持续在线的保证。希望保持断开时,应先检查是否仍有会触发连接的条件,再确认系统状态。
Data
流量统计与连接记录
Data 用于观察应用记录的流量与连接情况。排查时先确定当前展示的统计范围、时间口径及是否曾重置,再看上传、下载或连接记录。某次连接有流量,只说明发生了数据交换;握手、解析及失败重试也可能产生数据,不能把计数增长直接当成业务访问成功。
用一次可复现请求对照记录
开始前记录所选服务器、Global Routing 和测试目标。打开一个目标页面后,返回 Data 查看新增记录,结合可见的目标、策略与时间判断请求是否经过预期路径。若需要更详细的处理原因,再按需查看 Log。测试期间减少其他应用的后台请求,避免把不同请求混在一起解释。
Data 的统计口径不应直接等同于服务端账单或设备蜂窝数据统计。不同计数范围、协议额外开销、重连和时间区间可能造成差异。需要比较时先统一观察时段,并保留重置前的数据。记录可能包含访问目标与地址,截图或导出前应检查隐私信息。
Settings
常用设置项的调整边界
以下说明设置用途与检查方法,不为所有设备指定统一取值。配置文件可能包含相关项目,调整前先确认当前配置与 Settings 的实际生效关系。
DNS:先区分解析失败与连接失败
DNS 负责把域名解析成地址。在 Settings 的 DNS 相关项目与当前 Config 中检查解析设置,先记录已有值,再确认使用目的。目标域名无法解析与已经得到地址但连接失败,是两类不同问题;应先用诊断记录区分,再调整对应环节。不要一次替换多个解析选项后仅凭网页是否打开判断原因。
DNS 请求本身也需要可用的网络路径。若设置的解析方式依赖当前代理,而代理连接又未建立,可能出现相互依赖的故障。检查时同时考虑服务器可达性、规则和 IPv4、IPv6 结果。域名解析会涉及查询信息的处理,选择设置时应理解其路径,而不是只比较一次测试耗时。
Test Method:测试方式决定结果含义
Test Method 控制连接测试采用的方式。在 Settings 查看该项目,再回到 Home 执行 Connectivity Test。比较多个条目时应保持测试方式、目标和网络环境一致。测试超时不一定表示服务器完全不可用,也可能是测试目标或测试方式不适合;测试通过同样不代表所有业务请求都能完成。
不要只依据一次结果重排全部服务器。先重复测试,再用真实目标请求验证,最后结合日志判断。若更改测试相关参数,记录修改前的状态,避免把不同条件下的结果放在一起比较。
Today Widget:快捷查看与操作
Today Widget 是与系统小组件相关的设置入口,可用于配置相应的快捷展示或操作内容。先在 Settings 查看当前可用选项,再按设备系统提供的方式添加相应小组件。可展示内容、添加方式与刷新行为以实际界面为准,不把小组件显示理解为持续实时监测。
从快捷入口操作后,重要测试仍应回到 Home 核对连接开关、当前服务器与 Global Routing。若小组件未及时更新,先打开应用查看实际状态;不要仅凭旧的展示文字连续切换连接。
iCloud:同步范围与覆盖检查
iCloud 相关设置用于应用支持的同步功能。在 Settings 检查可同步的项目,并确认系统已允许相应的 iCloud 使用。启用前保留当前重要配置,换设备后先观察同步结果,再进行编辑。不同类别的数据不一定全部同步,不能把“已开启 iCloud”视作所有连接资料都已完整恢复。
多台设备同时修改时,应先确认各设备看到的内容,再决定保留哪一份。同步存在等待过程,切换账号或关闭功能前先检查本地资料。iCloud 同步与 App Store 购买记录属于不同事项:恢复购买不会自动证明服务器资料或配置已经同步。
Diagnostics 与 Log:为一次问题收集证据
Diagnostics 用于进一步检查连接问题;Log 用于查看请求处理过程。进入 Settings 的相关入口,按实际可用项目执行检查。收集前写下失败目标、发生条件和当前模式,再复现一次问题,优先保留与这次请求有关的记录。这样比长时间连续记录后猜测原因更容易定位。
日志中可能包含域名、地址、订阅信息或其他连接细节。分享前删除或遮去敏感字段,保留解释问题所必需的时间、错误信息与策略上下文即可。详细记录完成后,恢复适合日常使用的记录设置;不要在资料不完整时根据单条错误推断全部连接都失效。
排查顺序
每次只改变一个条件
设置较多时,按固定顺序检查,比同时尝试多个选项更容易复原。先确认当前网络可用,再确认服务器资料与所选条目,随后检查 Global Routing、当前 Config、DNS,最后检查 On Demand 和快捷入口带来的状态变化。每一步记录原值,测试结束后恢复临时调整。
- Home:确认所选服务器与连接开关,区分订阅更新成功、测试通过和实际请求成功。
- Global Routing:明确当前是 Config、Proxy 还是 Direct;若做模式对照,始终使用同一个目标。
- Config:确认生效文件、命中规则、策略引用与 FINAL,不只搜索目标域名是否存在。
- Settings:按问题类型检查 DNS、Test Method 或 On Demand,不把统计展示项当作路由开关。
- Data / Diagnostics:以一次可复现请求核对记录,保存必要证据后恢复日常状态。