官方手册 · 术语参考

Shadowrocket 术语表

按界面所在位置查词,再区分协议、匹配条件与执行策略。英文名称保留原样;每个条目都可通过标题旁的链接直接定位。

Global Routing DOMAIN-SUFFIX FINAL

界面与开关

先看词语出现在哪里。Global Routing 中的姿态、Config 页面与配置文件中的策略,不是同一层设置。

Home
主页面,用来查看服务器列表、当前选择及连接开关。列表里已经出现条目,只说明信息已添加,并不表示连接成功。首次使用时,应依次确认选择的服务器、Global Routing 姿态与连接状态,避免把导入成功当作访问验证完成。
Global Routing
全局路由设置,决定流量按哪种总体方式处理。三种姿态为 Config(配置)、Proxy(代理)、Direct(直连);要让配置文件中的分流规则参与处理,应选择 Config。排查时先记录当前姿态,避免在 Proxy 下修改规则却误以为规则没有保存。
Config
在 Global Routing 中,Config 表示按当前配置文件处理流量。在页面入口中,Config 指向配置管理,用于查看和选择配置文件。判断文档中的含义要结合位置:打开 Config 页面与把路由姿态设为 Config,是两个相关但不同的操作。
Proxy
Global Routing 中的代理姿态,用于让可处理的流量走所选代理路径。它适合临时判断代理路径是否可用,但不能代替对规则顺序的检查。这里的 Proxy 是整体姿态,与规则行末尾大写的 PROXY 策略作用层级不同。
Direct
Global Routing 中的直连姿态,用于让流量直接访问目标。它可以作为排查时的对照条件,但直连结果正常并不能证明代理服务器的地址、认证或传输设置正确。完成对照后,应恢复原先需要的姿态,再验证配置规则。
On Demand
按需连接设置,根据应用与系统提供的条件触发连接行为。它回答的是何时建立连接,而不是某个域名应该采用 PROXY 还是 DIRECT。配置后需要在实际网络条件变化时验证;手动断开后的表现也应结合当前按需条件判断。
Connectivity Test
连通性测试,用于观察服务器在当前网络与测试方式下是否响应,结果可能以延迟或失败状态呈现。延迟反映一次测试的响应时间,不等于文件传输速度,也不能保证所有目标都可访问。连续异常时,应核对测试范围、服务器参数与系统时间。

协议

协议决定客户端与服务器如何通信。按已有服务器资料选择类型,不根据名称、端口或延迟猜测参数。

Shadowsocks
一种代理协议,常见配置包括服务器地址、端口、密码与加密方法。加密方法必须与服务器端一致,不能因为列表里有相近名称就随意替换。如果资料还包含插件或其他附加选项,也应逐项核对,不能仅填写地址与密码后便认定配置完整。
VMess
一种代理协议,配置通常涉及用户标识、服务器地址与端口。实际连接还可能依赖传输方式、路径、Host 与 TLS 等设置,具体以已有服务器资料为准。导入后可以核对这些字段是否保留,但不要把公开示例中的值覆盖到自己的配置中。
VLESS
一种代理协议,名称与 VMess 相近,但不是可以互换选择的同一类型。应按服务器资料核对认证信息、传输方式与安全设置,不能只复制地址和端口。某种传输选项是否可用,还需以当前应用内实际提供的设置为准。
Trojan
一种使用 TLS 的代理协议,除地址、端口与密码外,还要留意用于证书验证的主机名。连接地址与证书主机名可能承担不同作用,不能仅因二者不相同就擅自改成一致。遇到证书错误时,先核对主机名、证书有效性和设备时间。
Hysteria2
一种基于 QUIC 的代理协议,连接依赖当前网络对 UDP 的实际支持情况。填写正确的地址和认证信息后,仍可能因网络条件而超时。排查时应把当前网络、服务器端状态与协议参数分开检查,不把一次超时直接归因于密码错误。
WireGuard
一种基于密钥的隧道协议,配置涉及本地密钥、对端公钥、对端地址与隧道地址等信息。这些字段各有用途,只有服务器地址不能还原完整配置。私钥属于敏感信息,分享截图或提交排查资料前应遮盖,不应放进公开配置片段。
HTTP / SOCKS5
两类不同的代理协议,应按服务器实际提供的类型选择。端口相同不代表协议相同,是否需要用户名、密码以及支持何种流量,也需要分别核对。HTTP 代理名称本身不表示客户端到代理服务器之间一定采用 TLS 加密。

规则关键字与策略

一条规则通常由匹配类型、匹配内容和策略组成。先判断是否命中,再看命中后如何处理;不要把协议名当作规则类型。

规则阅读示例

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

第一行匹配指定域名后缀,第二行匹配一个 IPv4 私有网段,最后一行接住前序未命中的流量。这是语法示例,不是适用于所有设备的完整配置。

[Rule]
配置文件中放置分流规则的段落,方括号表示段名,不是域名匹配条件。规则通常自上而下检查,命中后使用该条指定的策略,所以具体规则应放在可能覆盖它的宽泛规则之前。规则生效还以当前采用 Config 姿态并选中对应配置为前提。
DOMAIN
按完整域名匹配的规则类型,例如 DOMAIN,example.com,PROXY。它针对指定域名,不自动把所有子域名包含进来。若目标是覆盖 www.example.com 等子域名,应按需要增加完整域名规则,或使用 DOMAIN-SUFFIX。
DOMAIN-SUFFIX
按域名后缀匹配的规则类型,DOMAIN-SUFFIX,example.com,PROXY 可覆盖该域名及其子域名。这里填写域名,不填写完整网页地址、协议前缀或页面路径。它按域名边界匹配,不等同于在任意位置查找一段文字。
DOMAIN-KEYWORD
按域名中出现的关键词匹配,例如 DOMAIN-KEYWORD,example,PROXY。关键词越短,可能覆盖的无关域名越多,因此不能只因为写法简短就替代精确规则。出现误分流时,应检查关键词范围以及它在列表中是否排得过早。
GEOIP
依据 IP 地理归属数据库进行匹配,例如 GEOIP,CN,DIRECT。判断依据是地址归属数据,不是网页语言、运营方名称或域名后缀。目标使用分布式服务时,解析出的地址和数据库记录都可能影响匹配结果,应结合连接记录判断。
IP-CIDR / IP-CIDR6
分别用于 IPv4 与 IPv6 网段匹配,斜杠后的数字是前缀长度,不是端口号。例如 192.168.0.0/16 表示一个网段,而非单个服务器。只配置 IPv4 网段不能覆盖 IPv6 目标,排查时需确认连接实际使用的地址类型。
FINAL
前序规则均未命中时使用的兜底规则,通常放在规则列表末尾。FINAL,PROXY 表示剩余流量交给代理路径,并不表示代理连接失败后自动直连。如果 FINAL 放得过早,后面的规则可能没有被检查的机会。
PROXY
规则中的代理策略,表示命中的流量交给代理路径处理。它只说明处理方向,不会替用户补全服务器地址、密码或协议参数。注意大写 PROXY 是规则策略,首字母大写的 Proxy 则可指 Global Routing 中的整体代理姿态。
DIRECT
规则中的直连策略,表示命中流量直接访问目标,不经该代理服务器转发。它不保证目标必然可达,结果仍取决于当前网络、DNS 和目标服务状态。需要让特定本地地址直连时,应先确定正确网段,再把具体规则放在合适位置。
REJECT
规则中的拒绝策略,用于阻止命中的请求。它不是代理不可用时的修复选项,误用会让原本能够访问的目标直接失败。排查某个应用局部内容缺失时,应查看是否有范围过宽或顺序过早的 REJECT 规则命中相关域名。

订阅与配置文件

服务器列表解决连接到哪里,配置文件解决流量怎样处理。二者可以相关,但更新其中一个不代表另一个也会更新。

Subscribe
订阅导入与更新相关术语,用于从用户已有的订阅地址读取服务器条目。订阅更新可能改变条目数量、名称与参数,但不等于更新了规则配置文件。订阅地址可能包含身份凭据,不应公开展示;更新失败时应先核对地址完整性及其当前有效性。
Server / Add Server
Server 指一条服务器配置,日常也称节点;Add Server 是添加服务器的入口。服务器名称只是便于辨认的标签,真正影响连接的是协议、地址、端口和认证等字段。手动添加时应以已有服务器资料为准,保存条目后仍需测试并实际验证访问。
Configuration File
配置文件,用段落组织通用设置、分流规则、主机映射与重写内容,常见段名包括 [General]、[Rule]、[Host] 与 [URL Rewrite]。它与服务器列表不是同一份数据。编辑前应保留原配置,修改后确认当前选用的文件,避免只改了未启用的副本。
[Host]
配置文件中指定主机名映射的段落,可用于为特定域名指定解析结果。手动映射可能让该域名继续使用旧地址,因此域名访问异常时不能只检查 DNS 服务器。不要把他人环境里的映射整段复制进自己的配置,确有需要时应记录用途与恢复方法。
[URL Rewrite]
配置文件中组织 URL 重写规则的段落,用于按规则改变或处理匹配到的请求地址。它与 [Rule] 中选择 PROXY、DIRECT 或 REJECT 的分流机制不同,不能相互替代。加密请求的可见范围还受连接方式与相关设置限制,不应假定任意地址都能直接改写。

系统与安装

区分域名解析、系统授权与应用获取。系统显示已建立隧道,并不等于所有服务器和目标服务都已验证可用。

DNS
域名系统,把 example.com 这样的域名解析为 IP 地址。解析失败与代理服务器连接失败不是同一个问题,排查时应分开验证。配置里的 dns-server = system 表示使用系统 DNS;更换 DNS 后还应留意缓存与 [Host] 映射的影响。
VPN Configuration
系统用于建立网络隧道的配置授权,首次连接时可能需要用户在系统提示中确认。允许添加配置,只表示应用获得相应权限,并不证明远端服务器认证成功。若授权后仍不能访问,应回到服务器参数、Global Routing 与连接记录逐项判断。
Purchased
App Store 中的已购项目,用于查找原账号购买过的应用并按商店规则重新下载。iPhone / iPad 换机或重装时,应先确认使用的是原购买账号,并检查应用是否仍可下载。找不到条目时,先核对购买记录与账号地区,不要仅凭搜索结果判断需要再次购买。
安装放行
首次运行安装包时,对系统拦截提示进行确认的操作,前提是已核对包来自本站 /dl/ 路径。Windows 可按提示进入“更多信息 → 仍要运行”,Mac 可在“隐私与安全性”中查看“仍要打开”,安卓需允许所用浏览器安装未知应用。其他提示与 Linux 的运行权限处理见安装放行说明,不要把关闭整套系统防护当作常规步骤。