官方手册 · 术语索引

Shadowrocket 概念速查界面、协议与规则

先确认术语属于哪一层:界面决定操作入口,协议决定连接方式,规则决定流量去向。相似的英文词不一定指同一个设置。

  • 五类概念
  • 30 个常用术语
  • 界面词保留英文原文
操作层

界面与开关

界面入口、连接状态与分流姿态各司其职。先区分“在哪里设置”“是否已连接”和“流量如何处理”,再修改参数。

界面与开关

Home

Home 是查看服务器列表、选择当前服务器和操作连接开关的主要页面。选中圆点表示当前选择,不等于连接已经建立;仍需打开开关并查看连接结果。切换服务器后,应重新验证实际可达性,而不是只看名称是否变化。

界面与开关

Global Routing

Global Routing 决定整体流量处理方式,常用姿态为 Config、Proxy、Direct。检查规则是否生效前,应先确认这里采用 Config。若采用统一代理或直连姿态,不能仅依据规则文件中的某一行推断当前流量去向。

界面与开关

Config / Proxy / Direct

三种姿态分别对应配置、代理、直连:Config 按当前配置判断,Proxy 采用代理处理,Direct 采用直接连接。Config 也可能指管理配置文件的页面,要结合所在位置辨认。切换姿态适合隔离故障,但测试完成后应恢复所需设置。

界面与开关

On Demand

On Demand 是根据网络等条件触发连接的按需机制,不是某一种代理协议。若连接在手动关闭后再次建立,先检查是否有符合条件的按需设置。排查时可暂时停用相关条件,确认手动连接正常后再逐项恢复。

界面与开关

Add Server

Add Server 用于手动填写服务器资料,先选协议类型,再填写对应的地址、端口与认证字段。不同协议的表单字段不完全相同,不能只复制地址和端口就认为配置完整。资料应从你的服务商处获取,保存前核对空格、大小写与附加传输参数。

界面与开关

VPN 配置授权

首次建立连接时,系统可能要求允许添加 VPN 配置,这是客户端使用系统网络扩展的授权步骤。允许添加只表示系统许可,不表示远端服务器认证成功。若已授权仍无法访问,应继续检查服务器、分流姿态与 DNS,而不是反复重复授权。

连接层

连接协议

协议类型由已有服务器的配置决定,不能通过在客户端随意改选另一名称完成转换。速度与电量表现取决于传输方式、网络条件、加密开销和服务器负载,不能只按协议名称排序。

连接协议

Shadowsocks

Shadowsocks 通过指定加密方法与共享密码连接服务端,配置通常涉及地址、端口、密码和加密方法。方法名称必须与服务端要求一致,密码正确但方法不同仍可能失败。是否可转发 UDP 还取决于服务端配置及链路条件。

连接协议

VMess

VMess 带有身份认证与数据保护机制,用户标识是连接资料的重要组成部分。实际连接还可能依赖 WebSocket 等传输方式以及 TLS 参数,因此不能把用户标识当成全部配置。认证异常时,也应确认设备系统时间准确。

连接协议

VLESS

VLESS 将代理协议与传输安全配置分开组织,不能仅凭协议名称认定连接已经加密。填写用户标识之外,还需按资料核对传输方式、安全选项及相关名称字段。导入后若缺少附加参数,应补全资料,而不是尝试任意组合。

连接协议

Trojan

Trojan 通常结合 TLS 与密码认证建立连接,证书验证也是连接过程的一部分。地址可达不代表证书名称一定匹配,因此需要同时核对密码、端口与服务器名称。出现证书错误时,应检查名称、设备时间及服务端证书状态。

连接协议

HTTP / SOCKS5

HTTP 与 SOCKS5 是两类不同的代理协议,不能因为地址和端口相同就互换类型。HTTP 可通过 CONNECT 承载隧道连接,SOCKS5 定义了不同的请求与认证流程。两者是否具有加密保护或 UDP 能力,需结合具体传输配置与服务端实现判断。

连接协议

WireGuard

WireGuard 基于 UDP 与密钥对建立加密隧道,配置涉及接口地址、对端公钥和路由范围等信息。它不是填写普通账号密码的连接方式,公钥与私钥也不能混用。私钥属于个人凭据,分享诊断资料时应移除,并确认当前网络允许所需 UDP 通信。

连接协议

Hysteria2

Hysteria2 基于 QUIC,其底层连接依赖 UDP 可达性,认证与 TLS 参数也需匹配服务端。弱网下的表现还受拥塞、丢包和带宽设置影响,并不保证在每种网络中更快。若其他连接可用而它失败,可先检查 UDP 路径与参数,再讨论性能调节。

判断层

规则关键字

规则通常按顺序判断,先命中的规则决定处理策略。以下示例中的 example.com 仅用于说明语法;理解单条规则时,还要同时检查它前面的规则与当前 Global Routing。

规则关键字

DOMAIN

DOMAIN 按完整域名匹配,例如 DOMAIN,example.com,DIRECT 针对 example.com 本身。它不是按完整网页 URL 匹配,路径与查询参数不属于这里的域名。若希望同时覆盖子域名,应理解 DOMAIN-SUFFIX 的范围,而不是随意添加通配符。

规则关键字

DOMAIN-SUFFIX

DOMAIN-SUFFIX 按域名后缀匹配,DOMAIN-SUFFIX,example.com,PROXY 可覆盖 example.com 及其子域名。它适合按一个域名体系组织策略,但不会自动覆盖使用其他域名的关联资源。修改后应同时观察主页面与外部资源的实际命中。

规则关键字

DOMAIN-KEYWORD

DOMAIN-KEYWORD 按域名中出现的字符串判断,匹配范围通常比 DOMAIN 或 DOMAIN-SUFFIX 更宽。相同字符串可能出现在并不相关的域名中,因此容易产生超出预期的命中。已经知道准确域名时,应先评估更精确的匹配方式。

规则关键字

IP-CIDR / IP-CIDR6

IP-CIDR 与 IP-CIDR6 分别用于匹配 IPv4 和 IPv6 地址段,例如 IP-CIDR,192.168.0.0/16,DIRECT。斜杠后的数字是网络前缀长度,不是端口号。目标只有域名时,地址匹配还可能涉及解析过程,因此不能只看域名规则就断定最终结果。

规则关键字

GEOIP

GEOIP 按 IP 地址数据库中的地区归类进行匹配,而不是识别网页语言、访问者位置或网站经营主体。内容分发与地址变更可能使归类结果和直觉不同。需要精确处理某个站点时,应结合实际目标地址及域名规则核对。

规则关键字

FINAL

FINAL 是前面规则均未匹配时使用的兜底项,应放在规则列表最后。例如 FINAL,DIRECT 表示其余流量采用 DIRECT。若把 FINAL 放在需要判断的具体规则前面,后面的规则就无法承担预期作用。

规则策略

PROXY / DIRECT / REJECT

这些大写词是规则的处理策略:PROXY 交给代理处理,DIRECT 直接连接,REJECT 拒绝请求。它们与 Global Routing 中的 Proxy、Direct 姿态不属于同一层。排查时先确认整体姿态,再看具体命中的规则策略,避免只改其中一处。

资料层

订阅与配置

服务器资料回答“连接到哪里”,配置文件回答“按什么设置处理”。导入、更新、启用和选中是不同操作,完成一个步骤不代表其余步骤也已完成。

订阅与配置

订阅 / Subscribe

订阅用于获取和更新一组服务器或配置资料,订阅链接从你的服务商处获取。链接可能带有个人凭据,不应公开发布,也不宜完整出现在求助截图中。更新成功表示资料获取完成,并不直接证明其中每条服务器记录都能连接。

订阅与配置

服务器

服务器记录保存端点地址、协议类型、端口及认证信息,是客户端发起连接的依据。显示名称只是辨认标签,不决定实际所在地、带宽或可用性。连接异常时应核对记录内容及有效状态,不要只凭名称或单次测试结果判断。

订阅与配置

配置文件 / Config

配置文件把 General、Rule 等设置组织在一起,用于控制解析与规则处理等行为。文件已导入不一定表示已启用,规则处理还需结合 Global Routing 的 Config 姿态。替换整个文件可能同时改变多项设置,修改前应保留可恢复的副本。

订阅与配置

Scan QR Code

Scan QR Code 从二维码读取连接资料,二维码本身只是文本的编码形式,不是独立协议。扫码后仍需确认识别出的类型、地址与认证字段是否完整。二维码可能携带密码或订阅凭据,应按敏感资料管理,避免上传到公开讨论区。

订阅与配置

已购项目

已购项目是 App Store 中查找购买记录与重新获取应用的入口,需要核对当前用于购买的 Apple 账户。Shadowrocket 是闭源商业应用,唯一获取入口是 App Store,系统要求与是否通用购买以 App Store 页面标注为准。客户端一次性买断 ≠ 线路套餐,重新获取应用也不等于恢复已有服务器资料。

验证层

DNS 与诊断

“开关已打开”“服务器测试成功”和“目标网站可用”是不同层次的结果。按服务器、姿态、DNS、规则的顺序排查,每次只调整一项,才容易确认原因。

DNS 与诊断

DNS

DNS 将域名解析为 IP 地址,解析失败会使后续连接缺少可用的目标地址。解析走哪条路径与网页连接走哪条路径有关联,但不是同一项设置。排查时先区分“没有解析结果”与“已有地址但连接失败”,不要同时替换所有 DNS 和规则设置。

DNS 与诊断

Connectivity Test

Connectivity Test 用于检查所选服务器在指定测试条件下的连通性,适合在首次连接或更换服务器后使用。成功只说明测试路径得到预期响应,不代表全部网站、UDP 通信或所有规则都正常。测试通过后,还应访问实际目标并检查相关请求的处理结果。

DNS 与诊断

延迟

延迟表示特定测试条件下等待响应的时间,不是文件下载速度,也不等同于连接稳定性。不同测试目标、方法和时刻产生的数值不宜直接比较。选择已有服务器时,可在相同条件下多次测试,并结合实际访问、丢包及持续传输表现判断。

DNS 与诊断

TLS / SNI

TLS 用于保护传输并验证证书,SNI 用于在握手中指明所请求的服务器名称。连接地址与证书验证名称可能不同,应严格按已有资料填写,不能把所有字段都替换成同一个 IP 地址。证书错误应从名称匹配、系统时间和证书有效状态着手核对。

DNS 与诊断

规则命中

规则命中是请求经过判断后选中某条规则,并采用其处理策略的结果。一个页面可能请求多个域名,因此主页面命中正确不代表图片、接口和视频也采用同一策略。查看诊断记录时应把目标地址、命中规则和最终策略一起核对,并在分享前移除个人资料。

返回术语表顶部 ↑