[Glossary]官方手册 · 术语参考

Shadowrocket 术语表

按界面位置与配置用途查找术语。先辨认当前看到的是开关、协议还是规则关键字,再核对参数;同一个英文词在不同位置,含义可能不同。

界面词保留英文 规则关键字区分大小写 示例域名不代表可用服务

[Interface]

界面与开关

先区分界面名称与路由姿态。Global Routing 的配置、代理、直连分别对应 Config、Proxy、Direct;其中 Config 也可能指管理配置文件的界面。

Home
查看服务器条目、选择连接目标与控制连接的界面。列表中出现条目只说明信息已经保存,不代表认证、解析或连接已经成功。首次使用时,先核对所选条目,再检查连接开关及系统显示的连接状态。
Global Routing
决定请求采用何种整体路由方式的设置。Config 按配置处理请求,Proxy 使用代理姿态,Direct 使用直连姿态;它不是服务器协议的选择器。排查某条规则似乎没有生效时,应先确认当前是否选择 Config,再检查规则顺序。
Config
作为 Global Routing 的选项时,表示根据当前配置中的规则与设置处理请求。作为界面名称时,指管理、选择和编辑配置文件的位置,因此“已导入 Config”和“正在以 Config 路由”不是同一件事。修改文件后,应确认当前使用的是该文件,而非名称相近的另一份副本。
Proxy
Global Routing 中的代理姿态,适用请求交由当前代理处理,仍需考虑系统及配置中的绕过范围。它不会替用户补齐服务器地址、密码或传输参数,也不保证所选服务器可达。界面中的 Proxy 与规则里的大写 PROXY 应按各自所在位置理解。
Direct
Global Routing 中的直连姿态,让适用请求通过当前网络直接访问目标。它可以帮助比较问题是否只出现在代理路径上,但切换后能够打开某个目标,不足以证明原有服务器参数全部正确。直连仍依赖当前网络、DNS 与目标服务本身的可用性。
Add Server
手动添加服务器信息的入口,使用前应准备好用户已有的服务器参数。先选择正确协议,再逐项填写 SERVER、端口、认证及传输相关字段;不同协议的同名字段不一定可以互换。保存成功只代表条目建立,后续仍需做连通性测试。
Connectivity Test
用于检查条目连通性的测试功能,结果会受到测试方法、目标地址及当前网络条件影响。显示耗时不等于实际下载速度,测试通过也不代表所有网站、UDP 请求或长连接都能正常工作。排查时应记录测试方式,并结合实际访问结果和 Log 一起判断。

[Settings]

Settings 设置项

设置用于改变解析、触发连接、测试与记录等行为。此处解释概念,不假定所有平台具有相同菜单位置或默认值;具体取值应对照当前界面与所用配置。

DNS
把域名解析为 IP 地址的机制,是发起许多连接前的必要环节。解析失败与代理认证失败属于不同问题,修改代理密码通常不能解决域名解析错误。核对时应分别查看解析服务器、解析请求所走路径,以及解析出的地址是否符合预期,避免同时更换多个设置而失去对照。
On Demand
按设定条件触发连接的机制,不是“任何情况下始终保持连接”的同义词。触发条件、系统状态和网络变化共同影响实际行为,手动关闭后是否再次连接也应结合当前设置理解。修改后分别在相关 Wi-Fi、蜂窝网络或网络切换场景中测试,不要只看开关是否已经开启。
Ping
在设置或测试说明中常用来指与连通性探测相关的项目,具体含义取决于当前采用的测试方式。不要把所有以毫秒显示的结果都当作相同的 ICMP 往返时间,更不能直接换算成带宽。比较两个条目时,应保持测试方式、测试目标与网络条件尽量一致。
Log
排查连接过程时使用的记录,可帮助区分解析、建立连接、认证或协议协商等阶段的问题。应先复现一次故障,再查看相近时间的相关记录,避免把旧错误当作当前原因。分享记录前,移除订阅地址、认证信息、服务器私有信息和能够识别个人访问行为的内容。
iCloud 同步
在支持的 Apple 设备间借助 iCloud 同步应用所支持数据的方式,具体范围以当前应用设置为准。同步不是实时连接状态迁移,也不能替代一份经过确认可恢复的独立备份。换机后应逐项检查服务器条目、配置选择和同步状态,避免在尚未核对完成时删除原设备上的资料。

[Protocol]

协议

协议名用于辨认连接方式,不代表服务质量或默认参数。以下说明以用户已有服务器信息为前提;导入后仍需核对协议、认证、安全层与传输方式是否匹配。

Shadowsocks
一种代理协议,常见配置包括服务器地址、端口、密码与加密方法。加密方法与密码都需要和服务端一致,仅修改名称不会改变协议行为。如果已有配置包含额外传输参数,也应按原始资料核对,不能只复制地址和端口就认为配置完整。
VMess
使用用户标识等参数进行认证的代理协议,常见配置还会包含传输方式与 TLS 设置。服务器地址、用户标识以及传输层参数分别承担不同作用,不能用一个字段替代另一个字段。遇到连接失败时,还应检查设备时间是否准确,再对照原始参数逐项排查。
VLESS
一种代理协议,其用户标识、传输方式与安全层设置需要分别核对。不能仅凭 VLESS 这个名称推断是否启用 TLS,也不能把另一种传输方式的路径或 Host 原样套用。遇到导入后条目存在但连接失败的情况,应优先比对原始配置中的认证及传输相关字段。
Trojan
通常借助 TLS 保护传输的代理协议,需核对密码、服务器地址、端口与 SNI 等信息。SNI 用于 TLS 握手中的服务器名称指示,并不总与连接地址相同,应按已有服务参数填写。出现证书错误时先检查名称、系统时间与证书配置,不应把 Allow Insecure 当作常规修复办法。
HTTP / SOCKS5
两类不同的代理协议,对认证、目标连接与传输能力的处理并不相同。HTTP 代理可以使用 CONNECT 建立隧道,但协议名称本身不能证明客户端到代理服务器之间已经加密。添加时应明确服务器提供的是哪一种协议,并核对认证方式及是否另行要求 TLS。
WireGuard
基于密钥认证、使用 UDP 传输的隧道协议,配置涉及密钥、端点、地址与路由等信息。它的密钥字段不能按普通用户名或密码来理解,私钥也不应出现在公开截图与日志中。排查时需同时考虑 UDP 可达性、密钥配对以及隧道内地址和路由,而不只是端点域名。
Hysteria2
基于 QUIC 的代理协议,连接建立与传输依赖当前网络中的 UDP 可用性。导入时需匹配服务端认证、端口及 TLS 等相关设置,协议名不能替代这些具体参数。若某个网络下失败而另一个网络正常,应结合网络条件分析,不宜只靠反复修改密码判断原因。

[Rule]

规则关键字

规则通常按从上到下的顺序匹配,先命中者决定所用策略。阅读一行规则时,依次识别匹配类型、匹配条件与策略;域名规则和 IP 规则依赖的信息不同。

DOMAIN
精确匹配指定域名的规则关键字,例如 DOMAIN,example.com,DIRECT。这条规则不会自动覆盖 www.example.com,后者是另一个域名。只想针对单个完整域名调整策略时,可先考虑这种边界明确的匹配方式。
DOMAIN-SUFFIX
按域名后缀边界匹配指定域名及其子域名,例如 DOMAIN-SUFFIX,example.com,PROXY。它可以覆盖 example.com 与 api.example.com,但不是任意字符串包含匹配。若某个子域名需要例外处理,应把更具体的规则放在这条宽范围规则之前。
DOMAIN-KEYWORD
按域名中是否包含指定字符串进行匹配,例如 DOMAIN-KEYWORD,example,PROXY。它的范围通常比精确域名和后缀规则更宽,可能同时命中没有直接关系的域名。使用前应明确需要的是字符串匹配,还是某个域名及其子域名的范围匹配。
IP-CIDR
按 IPv4 网段匹配目标地址,CIDR 中的斜杠后数字表示网络前缀长度。例如 IP-CIDR,192.168.0.0/16,DIRECT 可用于指定这一私有地址范围的策略。它判断的是地址而非网站名称;请求是否具有可供匹配的地址信息,也会影响规则判断。
IP-CIDR6
按 IPv6 网段匹配目标地址,使用与 IPv6 地址对应的前缀表示法。IPv4 的 IP-CIDR 条目不会自动覆盖 IPv6,因此同一目标通过不同地址族连接时,可能命中不同规则。排查“相同域名偶尔走不同策略”时,应把解析结果中的 IPv4 与 IPv6 都纳入检查。
GEOIP
依据 IP 地理数据库中的归属信息匹配目标地址,例如 GEOIP,CN,DIRECT。数据库记录不等于用户所在地、内容所用语种或网站经营者所在地,也可能与实际部署变化存在时间差。需要稳定处理特定域名时,不宜只靠 GEOIP 推断该域名的全部连接行为。
FINAL
为没有命中前序规则的请求指定最终策略,通常放在规则列表末尾。例如 FINAL,PROXY 表示其余请求交由 PROXY 处理,而不是再次从第一条开始匹配。若大量请求都落到 FINAL,应先检查前序规则的范围、顺序以及当前是否使用了预期配置。
PROXY / DIRECT / REJECT
规则中常见的策略标识,分别表示交由代理策略处理、直接连接与拒绝请求。它们是规则命中后的处理结果,不是 Shadowsocks 或 VLESS 一类协议;PROXY 最终使用哪个目标,还需结合当前代理选择及配置。REJECT 是主动拒绝,不能把由此产生的失败误判为服务器不可达。

[Profile]

订阅与配置

服务器条目用于描述连接目标,配置文件用于描述处理规则,两者不能混为一谈。本站仅说明如何管理用户已有的订阅或服务器信息,不提供、不销售、不推荐节点或订阅。

Subscribe
通过用户已有的订阅地址获取并更新服务器条目的功能,地址应从自己的服务商处取得。链接中可能含有识别账号或授权访问的参数,应按敏感信息保管,不要公开粘贴。更新订阅通常用于刷新其管理的条目,不应因此推断整个规则配置或手动编辑内容也已同步更新。
SERVER
服务器地址字段,通常填写域名或 IP 地址,并与独立的端口及认证字段共同使用。除非该字段明确要求完整链接,否则不要把订阅地址、网页地址或带路径的 URL 直接当作服务器域名填写。界面中的一条服务器记录通常还包含协议等参数,因此仅有 SERVER 内容并不足以建立连接。
配置文件
承载 [General]、[Rule] 等设置与规则的文稿,用于描述请求如何被处理。导入文件不代表文件已经被选用,也不代表 Global Routing 已经处于 Config。编辑前应保留可恢复的副本,修改后用明确的目标请求验证命中行为,而不是只检查文件能否保存。
URL Rewrite
按条件改写请求 URL 或执行相应处理的机制,与决定请求走哪条连接路径的路由规则分属不同层面。它不会因为某条 DOMAIN-SUFFIX 命中就自动生效;HTTPS 内容能否被处理还涉及适用条件与证书信任等因素。只有理解规则来源和作用范围后才应启用,不要为解决普通连接问题盲目添加改写条目。
已购项目
App Store 中查找账号购买记录的入口,可用于核对 Shadowrocket 的购买记录与重新下载资格。iPhone / iPad 版在 App Store $2.99 一次性付费,两种设备可使用同一购买账号的购买记录;Mac、Windows、安卓、Linux 版免费。重新下载时应确认当前用于商店的账号与原购买账号一致,并以商店页面显示的可用状态为准。

已能辨认术语但仍无法连接时,可按常见问题区分解析、认证与规则匹配问题;需要修改具体设置时,转到Settings 设置参考逐项核对。