官方手册 / 术语索引

Shadowrocket 术语表

按界面原文和配置关键字查找。先分清三件事:连接是否已建立、请求命中了哪条规则、命中后采用了什么策略。

01 / Interface

界面与开关

开关控制连接,Global Routing 决定怎样处理请求。两者需要分开核对。

Home
查看连接开关、服务器列表和 Global Routing 当前选项的界面。服务器被选中不等于连接已开启;连接开启也不等于每条请求都经过代理。
Global Routing
提供配置、代理和直连三种姿态,界面依次显示为 Config、Proxy 和 Direct。Config 按当前配置判定策略,Proxy 使用代理路径,Direct 使用直连路径。复核规则命中时,先确认选的是 Config。
On Demand
按设定条件触发连接的功能,例如根据所用网络决定是否建立连接。它管理的是连接何时触发,连接建立后如何处理请求仍由 Global Routing 和当前配置决定。
Add Server
用于录入自己已有的服务器资料。先选择与资料一致的协议,再填写地址、端口以及该协议要求的字段;保存成功仅表示条目已录入。
Connectivity Test
用于检查服务器在当前网络和测试条件下是否能取得响应。测试成功不能替代对目标应用的验证;测试失败时,先核对测试对象、服务器参数和当前网络。
延迟
测试发起到收到响应所用的时间,通常以毫秒显示。延迟不等于传输速率;比较结果时应尽量使用同一网络、同一测试目标和同一种测量方式。

02 / Protocols

协议

协议决定客户端如何与已有服务器交互。同一个地址或端口,并不表示协议与参数可以互换。

Shadowsocks
使用加密传输的代理协议,服务器资料通常包含地址、端口、密码和加密方式。两端的加密方式或密码不一致时,即使地址可达,也不能正常交换数据。
VMess
使用用户标识等参数建立代理连接的协议。录入已有资料时,还要核对传输方式和适用的安全设置,不能只凭地址和端口判断条目是否完整。
VLESS
使用用户标识的代理协议。协议名称本身不说明传输是否加密;TLS 等安全设置应以对应的服务器资料为准,不应直接沿用 VMess 条目的字段。
Trojan
通常在 TLS 连接上使用密码进行身份验证的代理协议。服务器地址和用于证书验证的名称可能不同,录入时应分别按已有资料核对,不能根据其中一个字段猜另一个。
Hysteria2
基于 QUIC 的代理协议,其传输依赖 UDP。确认服务器资料无误后,若在某个网络上连不通,可以核对该网络是否允许相关 UDP 流量。
WireGuard
用密钥标识对端的隧道协议。配置中的对端地址和允许的地址范围用途不同:前者说明连接到哪里,后者参与决定哪些目标地址使用隧道。私钥不应出现在公开笔记或问题截图中。

03 / Matching

规则关键字与策略

关键字决定用什么条件匹配,策略决定匹配后怎么处理。需要查看完整语法时,参阅配置字段。

规则
在 [Rule] 中描述匹配条件和处理策略的条目。规则通常从上到下检查,命中后即采用对应策略;两条规则都能匹配时,不能假设更具体的一条会自动优先。
DOMAIN
匹配完整主机名。例如 DOMAIN,example.com,DIRECT 可匹配 example.com,但不会因此匹配 www.example.com。匹配目标不含 URL 的路径或查询参数。
DOMAIN-SUFFIX
按域名后缀匹配,覆盖该域名及其子域名。例如条件 example.com 同时覆盖 example.com 和 www.example.com,但不覆盖 notexample.com。
GEOIP
根据请求相关 IP 地址在地理数据库中的归属进行匹配。它不是设备定位;同一个域名可能解析到不同地址,查询结果变化时,命中的规则也可能变化。
IP-CIDR / IP-CIDR6
分别按 IPv4 或 IPv6 的网络前缀匹配,例如 192.0.2.0/24 和 2001:db8::/32。斜线后的数字表示前缀位数,不是端口;两种地址族需要分别检查。
FINAL
为前面条目都未匹配到的请求指定兜底策略,通常放在规则列表末尾。例如 FINAL,DIRECT 表示未命中时直连,不会改写前面已经命中的策略。
PROXY / DIRECT / REJECT
规则中的三种策略:PROXY 经代理转发,DIRECT 直接连接,REJECT 拒绝请求。这里的大写关键字只描述命中该规则后的动作,不等于修改 Global Routing 中的 Proxy 或 Direct 选项。

04 / Configuration

订阅与配置文件

服务器资料回答「连接到哪里」,配置文件回答「如何处理请求」。本站只说明如何使用已有资料,不提供、销售或推荐节点与订阅。

服务器
客户端连接的远端服务。服务器条目保存协议、地址、端口等连接参数;列表里的显示名称只是辨认标签,不能代替实际地址,也不表示条目已经可用。
订阅
通过已有订阅地址获取或刷新服务器条目的方式。地址由你的服务商提供,可能包含访问凭据,不宜公开粘贴。刷新后若原先使用的条目被移除,需重新从当前列表选择。
Config
作为页签时用于管理配置文件;作为 Global Routing 的选项时表示按当前配置处理请求。编辑前先核对当前启用的文件,避免把修改写到未启用的副本里。
DNS
为域名查询地址等记录的机制。域名解析失败、解析后命中不同的 IP 规则、以及目标地址连接失败,是三个不同的排查阶段。DNS 字段可从General 配置说明查起。
URL Rewrite
配置文件中按 URL 条件处理匹配请求的区段,常见用途是重定向。它和 [Rule] 的路径选择不是一回事:请求目标改变与请求改走代理,应分别核对。
iCloud 同步
在满足账号、系统设置及应用支持条件时,在设备间同步受支持的应用数据。换机前应确认要保留的条目是否已经同步;这个功能与 App Store 的已购记录是两件事。

要把已有资料录入客户端,可对照快速上手中的步骤;已经录入但连不上,可查看无法连接排查。

05 / Store & Account

商店与账号

App Store 的购买记录、设备上的应用数据和服务器服务是三件不同的事。

App Store 店面
账号对应的商店地区,影响可以看到的应用、标价币种与购买条件。网页打开的是美区产品页,并不表示当前设备登录的购买账号也在该店面。
应用 ID
用于区分 App Store 产品条目的标识。核对 Shadowrocket 产品页时,检查应用 ID 932747118、开发者 Shadow Launch Technology Limited 和官方图标,不只看名称。
已购项目
查找 App Store 购买记录的入口。换机或重装时,先确认使用原购买账号,再按已购项目恢复说明找回应用。重新获取应用不等于同时恢复服务器条目或配置文件。