官方手册 · 术语索引

Shadowrocket 术语手册

按界面、协议与配置查阅术语。界面里的 Proxy 是一种分流模式,规则末尾的 PROXY 则是单条规则的处理策略。

界面与开关

先区分服务器选择、连接状态和分流模式。三者分别决定用哪个连接、连接是否启用,以及哪些请求交给代理。

Home
用于查看服务器列表、当前选择和连接开关。服务器旁的选中标记只说明选了哪个条目,并不表示连接已建立。遇到网页打不开时,先确认所选条目没有弄错,再检查开关和测试结果。
Global Routing
用于选择流量处理方式:Config(配置)按当前配置处理,Proxy(代理)采用代理模式,Direct(直连)采用直连模式。要判断一条规则是否生效,先确认处于 Config 模式。切换模式不会把已有服务器改成另一种协议。
Config
出现在导航中时,指管理配置文件的页面;出现在 Global Routing 中时,指按当前配置处理流量的模式。如果改了规则却看不到预期结果,应分别核对选中的文件和正在使用的模式。
On Demand
用于在满足设定条件时触发连接,例如设备切换网络后。它决定何时尝试连接,不决定建立连接后某个域名走代理还是直连。若关闭连接后又自动开启,先核对 On Demand 的状态和触发条件。
Add Server
用于手动添加服务器,适用于已经掌握服务器资料的情况。先按资料选择协议类型,再核对地址、端口和该类型要求的认证参数。保存条目只代表录入完成,仍需选择该条目并验证连接。

协议

协议决定客户端怎样与服务器通信。选择类型时以已有服务器资料为准;地址和端口相同,也不代表不同协议可以互换。

Shadowsocks
以加密转发为主要用途的代理协议。手动录入时,地址、端口、加密方法和密码都要与服务端配置一致。只核对地址和端口,无法排除加密方法或认证信息填错的问题。
VMess
使用 UUID 标识用户的代理协议。UUID 用于识别连接所用的用户身份,不是服务器地址。若资料还指定传输方式、路径或 TLS 参数,也要对应核对,不能只凭地址和端口补齐。
VLESS
将代理协议与传输安全分开处理,连接保护取决于实际配置的安全层。它与 VMess 都可能使用 UUID,但相似的字段不能证明两者兼容。复制已有条目时,不应只换协议名就沿用其余参数。
Trojan
通过 TLS 承载的代理协议,通常用密码进行认证。服务器地址用于定位连接端点,TLS 服务器名称用于标识证书应对应的主机,两者不一定相同。出现证书名称不匹配时,先与已有资料核对相关字段。
HTTP / SOCKS5
两种不同的代理接口:HTTP 代理可以用 CONNECT 建立隧道,SOCKS5 有独立的连接和认证协商过程。是否需要用户名和密码,要看服务器端设置。接口名称本身不能说明到代理服务器的连接是否加密。
WireGuard
通过 UDP 传输的加密隧道协议,以密钥识别对端。除端点地址和端口外,隧道地址及允许通过隧道的地址段也会影响连通性。公钥与私钥用途不同,排查时不要把私钥贴到日志或截图里。
Hysteria2
基于 QUIC 的代理协议,依赖到服务器的 UDP 路径。如果同一配置在一个网络可用、换到另一个网络后超时,网络条件是排查项之一。不能仅凭一次测试推断协议在所有设备上的速度或耗电情况。

规则关键字

规则关键字负责匹配请求,策略负责处理匹配结果。检查规则时,先确认要匹配的是完整域名、域名后缀还是目标 IP,再核对规则顺序。

DOMAIN
按完整域名精确匹配。以 example.com 为条件时,它不会顺带匹配 www.example.com。只想处理一个明确的主机名时,用精确匹配可避免影响同站点的其他子域名。
DOMAIN-SUFFIX
匹配指定域名及其子域名,例如同一条件可以覆盖 example.com 和 docs.example.com。它按域名层级匹配,不是任意字符串包含匹配。规则条件中写域名,不写网址的协议前缀或路径。
GEOIP
根据地理 IP 数据库对目标地址的归类结果匹配,不按页面使用的语言或域名后缀判断。一项服务可能解析到多个地址,归类也可能随地址改变。排查命中结果时,应核对该次连接使用的目标地址。
IP-CIDR / IP-CIDR6
分别按 IPv4 和 IPv6 地址段匹配,斜线后的数字表示前缀长度。只写 IPv4 地址段并不会覆盖同一服务的 IPv6 地址。检查某条规则为何未命中时,先确认实际连接用的是哪一种地址。
FINAL
为没有匹配到前序规则的请求指定兜底策略,通常放在规则段末尾。若某项访问走了兜底策略,应先确认前面的条件是否覆盖真实请求目标。直接修改兜底策略会同时影响其他未命中的请求。

订阅与配置

服务器条目用于建立连接,配置文件用于保存规则等设置。导入已有订阅、启用某份配置、在设备之间同步应用数据,是三种不同的操作。

Subscribe
用于通过用户已有的订阅链接导入服务器列表。刷新时,列表可能因来源内容变化而增减条目,但刷新并不等同于切换分流规则。订阅地址可能含访问凭据,提交排查信息前应将其遮盖。
SERVER
用于组织或显示服务器条目的界面标签。条目名称只是辨认用的文字,实际连接取决于地址、端口、协议和认证信息等参数。两个条目即使显示同名,也不要仅凭名称判断它们使用相同的服务器。
配置文件
保存规则等设置的文件,例如在 [Rule] 段中描述请求的匹配条件与处理策略。导入文件并不等于已选中它,也不等于 Global Routing 已切到 Config。修改已有文件前保留原件,便于核对和恢复。
iCloud 同步
在满足账号和系统设置条件时,通过 iCloud 在设备间同步应用数据。换机后,商店已购项目对应的是应用购买记录,不是配置备份。同步后仍应在新设备核对实际可见的配置和服务器条目。

策略与诊断

命中策略表示请求按哪种方式处理,测试结果表示一次检查是否完成。开关已开启或延迟有读数,都不能单独证明某个网站可访问。

PROXY
把匹配到的请求交给代理处理的规则策略。规则命中并不说明对应服务器一定可用,也不能证明目标服务已返回响应。排查时应把策略命中、服务器连通性和目标服务响应分开检查。
DIRECT
让匹配到的请求不经代理,由设备当前网络直接发送。它与 Global Routing 中的 Direct 模式拼写相近,但一条 DIRECT 规则只影响命中它的请求。直连也仍受当前网络和域名解析条件影响。
REJECT
拒绝符合条件的请求,不会替该请求尝试另一种策略。若网站的图片、登录或其他功能使用了被拒绝的域名,即使主页面能打开,相关功能也可能失败。排查时先缩小匹配范围,再复测受影响的功能。
DNS
负责把域名解析成地址等记录,解析结果会影响依赖目标 IP 的规则。解析成功只表示获得了结果,与能否成功连接目标服务是两回事。如果仅部分域名失败,先观察是否存在解析错误,再核对命中的规则。
Connectivity Test
用于检查当前网络条件下能否完成指定测试。一次测试成功不能证明所有网站可访问,也不能验证某条业务规则是否命中。对比两次结果时,尽量保持服务器、测试目标和网络条件一致。
延迟
指一次测量记录的耗时,可能受到网络、测试目标和测量方式影响。适合在同一条件下用于对照,但低延迟不等于高带宽,也不代表长时间连接稳定。遇到超时时,先确认测试是否拿到了响应,再比较耗时。
下载 Shadowrocket