官方手册 · 概念查阅

Shadowrocket 术语表

界面词、协议与规则关键字

先分清“在哪个界面操作”“用什么协议连接”和“请求命中什么策略”,再修改参数。本页按五类概念解释术语;英文名称保留原文,可通过分类或条目锚点定位。

界面名称 ≠ 规则关键字 服务器信息 ≠ 配置文件 连接测试 ≠ 速度测试
操作入口

界面与开关

界面词说明操作位置或整体状态。特别注意 Global Routing 里的 Config、Proxy、Direct,与配置文件名称、规则行中的策略不是同一层级。

Home

Home 用于查看服务器列表、当前选择与连接状态,也是日常检查连接的起点。列表中出现一条记录只表示参数已保存,不表示该服务器已经可用,更不表示当前已建立连接;排查时应分别核对选中项与连接开关。

Global Routing

Global Routing 决定整体路由方式,三种姿态为配置(Config)、代理(Proxy)、直连(Direct)。需要规则分流时应先检查是否选择 Config;若整体模式与预期不符,仅调整某一条规则可能看不到预期变化。

Config 路由模式

作为 Global Routing 的选项,Config 表示按当前配置文件中的规则和相关设置处理请求。它不意味着所有请求都经过代理:命中 DIRECT 的请求可以直连,命中 REJECT 的请求会被拒绝;还需确认实际启用的是哪份配置文件。

Proxy

Proxy 是 Global Routing 中的代理模式,用于整体采用代理路径,而不是依照普通规则逐项分流。它与规则中的大写 PROXY 属于不同层级;检查连接时,仍要核对当前服务器及其认证、传输参数是否正确。

Direct

Direct 是 Global Routing 中的直连模式,连接不经选定的代理服务器转发。直连不代表忽略 DNS、系统路由或当前网络条件;切换到 Direct 后能否访问某个目标,仍取决于设备所在网络与目标服务的实际状态。

Add Server

Add Server 是手动添加服务器的入口,应依据已有信息选择类型,再填写地址、端口和相应认证字段。不同协议所需字段不同,不能把 Password、UUID 或密钥互相替代;填写完成后还需选择记录并测试连接。

按步骤查看首次配置 →
连接方式

协议

协议决定客户端与服务器如何交换数据。类型、认证、传输方式与 TLS 等参数需成套匹配;不能仅凭协议名称推断速度、延迟或实际可用性。

Shadowsocks

Shadowsocks 是一种加密代理协议,常见参数包括服务器地址、端口、加密方法与密码。加密方法必须与服务端一致;即使地址和密码正确,方法不匹配仍可能无法通信,附加传输参数也应按已有信息原样核对。

VMess

VMess 是使用 UUID 等参数识别用户的代理协议,连接还可能搭配不同传输方式与 TLS。UUID 填对并不代表整组参数已经正确;应继续核对传输类型、Host、Path 和证书相关设置中实际需要的字段。

VLESS

VLESS 是一种轻量代理协议,常以 UUID 标识用户,协议本身不提供应用数据加密。实际传输保护需结合采用的 TLS 等机制判断;填写时不要把 VMess 的字段习惯直接套用到 VLESS,应以对应服务器参数为准。

Trojan

Trojan 通常在 TLS 通道中承载代理数据,并使用 Password 认证。服务器地址与用于证书校验的名称可能承担不同作用;连接失败时应核对 Password、SNI 与证书是否对应,不宜把跳过证书校验当作常规修复方式。

Hysteria2

Hysteria2 是基于 QUIC 的代理协议,使用 UDP 承载通信。认证、TLS 与其他连接参数需要与服务器一致,所在网络也需允许相关 UDP 通信;某种 TCP 连接测试有结果,并不能据此证明这条连接一定可用。

WireGuard

WireGuard 是使用密钥认证的隧道协议,配置通常涉及本地私钥、对端公钥、Endpoint 以及地址或路由参数。公钥与私钥用途不同,不能交换填写;私钥属于敏感凭据,分享配置或提交排查信息前应先移除。

HTTP

在服务器类型中,HTTP 指 HTTP 代理,不是说目标网页只能使用 HTTP。访问 HTTPS 目标时通常借助 CONNECT 建立隧道;代理连接自身是否受 TLS 保护,要看所选类型与参数,不能仅凭目标地址带有 HTTPS 判断。

SOCKS5

SOCKS5 是代理转发协议,可按服务器要求配置用户名和密码,但协议本身不提供传输加密。UDP 转发需要客户端设置、服务端能力与网络条件共同支持;TCP 访问正常并不代表 UDP 请求也会采用相同结果。

查看协议概览与填写关注点 →
匹配条件 → 处理策略

规则关键字与策略

规则通常按从上到下的顺序检查,命中后采用相应策略。DOMAIN-SUFFIX 一类关键字回答“匹配什么”,PROXY、DIRECT、REJECT 回答“怎样处理”,两者不能混用。

一行规则的三个部分

DOMAIN-SUFFIX,example.com,PROXY

DOMAIN-SUFFIX 是类型,example.com 是匹配值,PROXY 是策略。示例用于解释语法,不表示应当把该规则直接加入当前配置。

DOMAIN

DOMAIN 精确匹配指定域名,例如 example.com,不会自动覆盖 www.example.com。适合只处理单个主机名的情况;若目标服务使用多个子域名,需要分别列出,或在明确范围后考虑其他匹配类型。

DOMAIN-SUFFIX

DOMAIN-SUFFIX 匹配指定域名本身及其子域名,例如 example.com 与 api.example.com。它按域名边界识别后缀,不是任意文本包含判断;适合将同一域名体系交给统一策略,但仍需留意前面是否已有规则先行命中。

DOMAIN-KEYWORD

DOMAIN-KEYWORD 按域名中是否包含指定关键词进行匹配,范围通常比后缀匹配更宽。短关键词可能同时命中彼此无关的域名;添加前应先确认影响范围,不宜用过短片段代替一个明确的完整域名。

GEOIP

GEOIP 根据 IP 地理数据库记录的国家或地区归属匹配目标 IP,并非按用户所在地或网页内容进行判断。数据库结果可能与网站品牌所属地区不同,CDN 也可能返回不同地址;需要结合实际解析结果理解命中原因。

IP-CIDR

IP-CIDR 用 CIDR 表示法匹配 IPv4 地址段,例如 192.0.2.0/24。斜杠后的数字表示网络前缀长度,并非端口;前缀越长,覆盖范围通常越小,修改前应先确认目标地址确实落在该网段内。

IP-CIDR6

IP-CIDR6 用于匹配 IPv6 地址段,例如 2001:db8::/32,与 IPv4 地址段规则分别处理。一个域名可能同时返回两类地址;仅添加 IPv4 规则不代表 IPv6 连接也会获得相同策略,需要结合实际连接地址检查。

FINAL

FINAL 为前面规则未命中的请求指定最终策略,通常放在规则列表末尾。它不填写域名或地址匹配值,例如 FINAL,DIRECT;若把它放到具体规则之前,后面的规则可能无法参与预期的匹配。

PROXY

PROXY 是规则中的代理策略,表示把命中的请求交给代理路径处理。它不是服务器地址,也不是协议名;实际使用哪个出口,需要结合当前选择与配置判断,填写 PROXY 本身不会生成可用的服务器信息。

DIRECT

DIRECT 是规则中的直连策略,命中后不经代理服务器转发该连接。它不等于关闭所有网络处理,也不能保证目标一定可达;DNS 解析、系统网络状态和目标服务仍会影响连接结果。

REJECT

REJECT 表示拒绝命中的连接,而不是从页面中精确删除某个元素。若同一域名同时承载多种内容,按域名拒绝可能连带影响正常功能;配置后应检查实际请求,不能把拒绝连接等同于内容级筛选。

继续阅读匹配范围与排列顺序 →
数据与文件

订阅与配置文件

先确认导入内容的用途,再决定导入位置。服务器记录解决连接参数问题,配置文件组织规则与设置;订阅更新也不等于当前配置已经切换。

Subscribe

Subscribe 用于导入或更新已有订阅内容,具体包含哪些记录取决于订阅格式及返回数据。订阅地址应从你的服务商处获取,并按敏感信息保管;更新失败时先检查地址、网络和返回格式,不要将完整地址公开用于排查。

Server

Server 是一组服务器参数记录,通常包含协议、地址、端口及认证信息,也常被称为节点。显示名称只是便于辨认的标签,不参与认证;两条记录即使名称相同,实际地址、协议或证书参数也可能不同。

Config 配置文件

Config 也指管理规则、DNS 等内容的配置文件及相关界面,与 Global Routing 中同名模式需要按语境区分。保存或导入文件后还应检查当前启用项;更新主要承载服务器信息的订阅,不代表规则文件也已随之更新。

查看 Config 管理说明 →
解析、连接与同步

设置项

设置项可能影响解析路径、连接触发条件或数据同步。排查时一次只改变一类设置,并记录原值;实际选项名称与可用范围以应用内显示为准。

DNS

DNS 把域名解析为 IP 地址,是建立许多网络连接的前置步骤。更换解析设置可能改变返回地址与后续规则判断,但并不直接改变服务器认证参数;遇到问题时应区分解析失败、连接失败和证书校验失败。

查阅 DNS 设置 →

On Demand

On Demand 是根据所设条件由系统触发连接的按需连接机制,可减少反复手动操作连接开关的需要。它不意味着服务器始终可用;出现自动重连时,应同时检查触发条件和当前网络,而不是仅观察开关状态。

查阅 On Demand 设置 →

Connectivity Test

Connectivity Test 用于检查连接可用性,结果受测试方式、测试目标和当时网络状态影响。延迟值不是下载速度,某个探测成功也不能证明所有目标或 UDP 请求均可用;比较结果时应保持测试方法一致。

查阅测试与 Ping →

URL Rewrite

URL Rewrite 按匹配条件改写请求 URL,例如调整请求地址或执行相关重写动作。它与决定连接出口的路由规则不同,生效范围受请求可见性和配置条件限制;不能仅添加域名规则就推断加密请求内容也能被改写。

iCloud

iCloud 是用于应用数据同步的系统服务,实际同步项目需在应用中确认,并受账户、系统权限及同步状态影响。它与 App Store 购买记录用途不同;换机前应检查同步是否完成,不应把开启同步视作所有数据已经备份。

查阅 iCloud 同步 →