官方手册 · 名词解释

Shadowrocket
界面、协议与规则术语

按术语所在位置查阅：界面词说明入口与操作，协议名说明连接方式，规则关键字说明匹配条件。同一个词出现在不同位置时，含义可能不同；例如 Config 既是配置相关页面名称，也是 Global Routing 的一种模式。

本表以用户已有自己的订阅或服务器信息为前提。先理解名词，再按实际参数操作；协议名称、字段名称与规则关键字保留英文原文，便于与 Shadowrocket 内的显示逐项核对。

界面与开关

入口、模式与连接检查

先确认正在查看哪个页面，再判断某项设置改变的是连接对象、路由方式，还是客户端行为。

Home
查看已有服务器条目、选择连接对象及操作连接开关的主要页面。添加条目后，应先核对所选对象，再尝试连接；条目存在只表示信息已保存，不代表服务器当前可用。首次建立连接时出现的系统 VPN 配置授权，也应结合当前操作确认。
Global Routing
决定受 Shadowrocket 处理的流量采用何种整体路由方式，常见选项为 Config、Proxy 与 Direct。它与服务器选择是两个层次：选中服务器，并不自动决定所有请求如何处理。调整模式后，应使用同一目标重新验证，避免同时修改多个变量。
Config / Proxy / Direct
Config（配置）依据当前配置中的规则处理；Proxy（代理）让受客户端处理的流量使用代理策略；Direct（直连）使用直接连接。需要保留分流规则时使用 Config，并确认当前配置已生效。Proxy 与 Direct 可用于对照排查，但一次成功测试不能说明所有网络条件下都会得到相同结果。
On Demand
按已设置的条件触发连接，适合需要根据网络条件调整连接行为的情况。它不是服务器自动修复功能，也不能替代有效的配置和系统授权。启用前先验证手动连接，再逐项检查触发条件；排查反复连接时，也应把这项设置纳入核对范围。
Add Server
使用已有服务器信息添加条目的入口，通常需要选择协议并填写地址、端口及认证参数。不同协议展示的字段不同，不能把一组字段直接套用到另一种协议。保存后重新打开条目核对，尤其注意传输方式、TLS 和服务器名称等容易遗漏的部分。
Connectivity Test
用于辅助检查连接可达性与响应情况，具体测试选项以当前应用内显示为准。测试结果受目标、测试方式和当时网络影响，不能直接换算成下载速度。若测试可达但实际请求失败，应继续核对 DNS、Global Routing 和命中的规则，而不是只重复测试。
Settings
查看和调整客户端相关设置的页面，具体选项以当前应用内显示为准。修改前记录原值，遇到问题时一次只改一项，并用相同请求验证差异。设置项名称相似并不表示作用相同，连接触发、解析和数据管理等选项应分别理解。
Data
用于查看客户端的上传、下载及相关流量统计，读数应结合页面显示的统计范围和累计时间理解。累计流量不是当前速度，也不等同于服务端记录的用量。清零前先记录需要保留的读数；具体统计视角与分组方式可查阅Data 功能说明。
查看 Global Routing 操作步骤 →
协议

协议名称与参数边界

协议决定客户端与服务器如何通信。添加时按已有信息填写，不凭名称推断速度，也不凭端口猜测协议。

Shadowsocks
一种代理协议，常见配置项包括服务器地址、端口、加密方法和密码。加密方法必须与服务器端一致，密码也需要保留原有大小写与字符。导入后若无法建立连接，先核对这些基础字段，再检查是否还需要额外的传输参数。
VMess
使用 UUID 等信息进行身份校验的代理协议，传输层设置是配置的一部分。地址、端口和 UUID 正确，并不意味着连接一定成立，仍需核对传输方式、路径及 TLS 等适用字段。UUID 是认证信息，应按原值保存，公开排查记录时不要展示真实值。
VLESS
使用 UUID 等信息识别用户的代理协议，不能把名称中的差异简单理解为速度高低。连接的安全性需要结合实际传输层与认证设置判断，不能只看协议名。导入已有条目后，应继续检查传输方式和相关安全参数，不把 VMess 的字段组合直接照搬过来。
Trojan
通常结合 TLS 使用的代理协议，配置时需要核对服务器地址、端口、密码与服务器名称。连接地址和用于 TLS 验证的名称可能不同，应以已有配置说明为准。证书验证失败时优先检查名称、证书及设备时间，不把跳过验证当作常规解决办法。
Hysteria2
基于 QUIC 的代理协议，依赖相应的 UDP 通信条件。高延迟或丢包环境中的实际表现，还取决于带宽、拥塞和服务器配置，不能仅由协议名称保证。添加时按已有信息核对认证、TLS 及适用的带宽参数；UDP 不可达时，应先定位网络条件。
WireGuard
使用公私钥建立加密隧道的协议，配置通常涉及密钥、端点、接口地址与路由范围。私钥属于敏感信息，不能用于公开截图或分享排查记录。只有端点地址正确仍不足以建立完整通信，应把对端公钥和允许的地址范围一起核对。
HTTP / SOCKS5
两种不同的代理协议名称，各自的握手与认证方式不同。填写时使用用户已有服务器信息所指定的类型，不能因为端口相同就互换。是否使用加密传输、是否支持特定请求，还要结合服务器能力与客户端对应设置确认。
规则关键字

匹配条件与处理策略

规则通常由匹配类型、匹配内容和处理策略组成。阅读时先看匹配对象，再看命中后如何处理。

Rules
配置中用于判断连接如何处理的规则集合，通常按顺序匹配并使用首次命中的适用规则。具体规则放前面，宽泛条件放后面，有助于减少意外覆盖。只有在对应的配置处理路径中，规则才会参与决策，因此排查时要同时检查 Global Routing 与当前配置。
DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD
DOMAIN 匹配完整域名，DOMAIN-SUFFIX 匹配域名后缀及其子域，DOMAIN-KEYWORD 按域名中的关键词匹配。后两者覆盖范围可能更广，不能只凭一条测试请求判断影响范围。域名规则填写域名本身，不把 URL 中的路径、查询参数或协议前缀混入匹配值。
GEOIP
依据 IP 地理数据库判断地址所属地区，再执行对应策略。它判断的是地址数据，不是网站使用的语言、域名后缀或访问者的位置。数据库内容及域名解析结果都可能影响匹配，排查时需要核对实际连接地址，避免从页面语言反推规则结果。
IP-CIDR / IP-CIDR6
分别用于匹配 IPv4 与 IPv6 地址段，斜杠后的前缀长度表示地址范围。相较于单个地址，较宽的网段可能影响更多目标，填写前应确认预期范围。一个域名可能解析出多个地址，只有部分地址命中时，请求表现也可能出现差异。
FINAL
前面的规则都未匹配时使用的最终规则，通常位于规则列表末尾。它决定剩余流量的去向，并不是覆盖所有已命中规则的总开关。检查配置时应确认 FINAL 的策略存在且符合预期，因为遗漏匹配条件的请求会落到这里。
PROXY / DIRECT / REJECT
规则中的处理策略：PROXY 指向代理策略，DIRECT 表示直接连接，REJECT 表示拒绝处理。示例中的 PROXY 必须对应当前配置内可用的策略或策略组，不应假定任意配置都能直接使用。它们与 Global Routing 中的 Proxy、Direct 处于不同层级。
USER-AGENT
根据可见 HTTP 请求中的 User-Agent 信息进行匹配，不是通过设备上应用名称识别全部流量。加密请求中的相关信息并非天然可见，因此适用范围取决于实际请求与配置条件。判断是否命中时应查看可用的请求记录，而不是把它当作通用的按应用分流规则。
查看 Rules 功能说明 →
订阅与配置

条目、解析与配置数据

服务器条目提供连接参数，配置文件规定处理方式。导入成功后，仍需分别确认连接对象与配置选择。

Subscribe
通过用户已有的订阅 URL 导入并更新服务器条目的功能，更新结果取决于该地址返回的内容。订阅通常包含访问凭据，分享截图或日志时应遮住完整 URL。条目更新不等于整份规则配置同时更新，导入后需要分别检查服务器列表与配置选择。
SERVER
服务器相关字段或区域的界面标识，填写时使用用户已有的地址信息。服务器条目还可能包括端口、协议、认证与传输参数，只有地址通常不足以连接。条目显示名称可以方便辨认，但改名称不会改变真实连接目标或认证信息。
Config
在页面名称中指配置文件相关管理入口，在 Global Routing 中则指按当前配置规则处理的模式。配置文件可包含规则、策略及其他适用设置，服务器订阅并不天然等于配置文件。导入之后应确认实际选用的文件，避免把“已保存”误当作“已生效”。
DNS
把域名解析为 IP 地址的机制，是域名请求建立连接前的重要环节。解析失败可能表现为网站打不开，即使服务器连接本身正常也会发生。修改 DNS 设置时，需要同时考虑解析请求的处理路径和规则条件，并在同一网络下重新验证目标域名。
URL Rewrite
依据条件改写可处理的请求 URL，常见理解方式是改变请求目标或请求中的部分内容。它不同于 Rules：规则主要决定流量交给哪个策略，改写则涉及请求本身。只有满足相应处理条件的请求才会受到影响，应明确匹配范围后再使用已有配置。
延迟
测试条件下的响应时间，可能包含连接建立或指定目标响应所需的时间，具体含义取决于测试方式。延迟低不等于持续传输速度高，也不表示所有目标都可达。比较时保持测试方式、目标和网络一致，多次观察比单次读数更有参考意义。
iCloud 同步
指通过应用提供的 iCloud 相关功能同步其支持的数据，具体范围以当前应用设置为准。它与 App Store 购买记录是两套机制，恢复应用不代表配置会自动出现。换机前应核对同步开关、账号与实际同步结果，并妥善保管包含认证信息的数据。
App Store 与账号

正版核对、店面与购买记录

Shadowrocket 是 Apple 平台的闭源商业应用，唯一获取入口为 App Store。iPhone 与 iPad 为主要使用设备，系统要求与购买适用性以 App Store 页面标注为准。

App Store 正版核对
在产品页核对开发者 Shadow Launch Technology Limited、官方图标与应用 ID 932747118。官方图标为白底蓝紫描边火箭，应用 ID 可从产品页 URL 中辨认。不要仅依赖搜索名称判断，三处信息应与官方产品一致，再确认价格与兼容性。
商店地区
指购买账号所对应的 App Store 店面，可能影响应用可见性、显示货币与支付条件。设备语言或当前位置并不能单独证明当前店面，应查看账号的国家或地区设置。准备调整地区时，先了解账号余额、现有订阅及支付方式等条件，详见商店地区指南。
已购项目
用于在 App Store 中查找原购买记录，并在符合条件的设备上恢复获取应用。换机或重新安装时，先确认使用的是原购买账号，再查找 Shadowrocket。已购记录恢复的是应用获取资格，不会自动恢复服务器信息、订阅 URL 或配置文件。
一次性买断
指购买客户端使用资格的付费方式，美区价格约 2.99 美元，实际金额以商店页面为准。客户端一次性买断 ≠ 线路套餐；购买后仍需导入用户已有的订阅或服务器信息。后续应用更新通过 App Store 获取，购买适用设备与家人共享条件以产品页标注为准。
查看 App Store 正版核对与购买说明 →