Shadowrocket 术语表 - 界面、协议与规则关键字

01 / Interface

界面与开关

同一个连接问题可能涉及不同入口。先确认所在页面与当前状态，再修改设置，避免把测试结果、路由姿态和 VPN 开关混为一谈。

Home

Home 是查看服务器列表、当前选择与连接开关的主要入口。导入内容后，先检查列表中是否出现预期条目，再确认当前选中的条目。列表存在只说明信息已经保存，不代表认证成功或目标服务已经可访问。

Add Server

Add Server 用于添加已有服务器信息，Type 决定需要填写哪些字段。先按服务端资料选择协议，再核对地址、端口、认证信息以及 TLS 等附加选项。不要把不同协议的密码、用户标识或传输参数互相套用。

Global Routing

Global Routing 控制整体路由姿态：配置、代理、直连分别对应 Config、Proxy、Direct。Config 按当前启用配置判断规则，Proxy 采用代理路径，Direct 采用直接连接路径。排查规则未生效时先看这里，因为在非 Config 姿态下，不能按配置规则的预期解释所有连接。

On Demand

On Demand 是按设定条件触发 VPN 连接的机制，不是服务器可用性的保证。设置后应分别核对切换 Wi-Fi、使用蜂窝网络、锁屏与重新联网时的状态。如果手动关闭后连接再次触发，先检查这里的条件，再判断是否属于异常重连。

Connectivity Test

Connectivity Test 用于检查条目在指定测试条件下的连通情况。结果中的延迟受测试目标、测试方式与当时网络影响，不能直接当作实际下载速度。测试成功但应用访问失败时，还要核对 DNS、规则命中和目标服务本身。

DNS

DNS 把域名解析为 IP 地址，是建立许多连接之前的一步。域名规则与 IP 规则观察的对象不同，因此解析结果和解析时机可能影响后续匹配。遇到域名打不开而直接访问地址正常的情况，应记录解析错误，避免只反复切换服务器。

URL Rewrite

URL Rewrite 按匹配条件处理请求 URL，与决定连接走向的路由规则属于不同层面。它是否能作用于某个请求，取决于请求形式及相关配置条件。排查时先确认请求是否符合匹配表达式，不要把修改 URL 等同于选择 PROXY 或 DIRECT。

Data

Data 用于查看客户端记录的流量与相关统计，适合观察一段时间内的使用变化。读取数值前应确认统计范围、计数周期以及是否曾重置。这里的计数口径可能与服务商侧不同，不能据此推断账号剩余额度或计费结果。

02 / Protocols

协议

Type 必须与服务端一致。协议名只说明通信机制的一部分，实际速度与电量还受网络质量、传输方式、连接持续时间和服务端配置影响。

Shadowsocks

Shadowsocks 使用指定加密方法与密码建立代理通信。配置时需要同时核对服务器地址、端口、加密方法和密码，不能只确认密码正确。不同方法的兼容条件可能不同，具体字段应按已有服务端资料填写。

VMess

VMess 使用用户标识等参数完成认证，并可搭配不同传输方式。协议类型、传输方式与 TLS 是不同维度，导入后仍应逐项核对。若出现认证或握手错误，也应检查设备时间是否准确，再定位传输参数。

VLESS

VLESS 将用户认证与具体传输保护方式分开处理，不能仅凭名称判断连接是否使用加密传输。用户标识、传输参数以及服务端要求的安全设置必须配套。它与 VMess 是不同协议，不能只更换 Type 就假定其余字段仍然适用。

Trojan

Trojan 通常结合 TLS，并使用密码进行认证。除地址和密码外，还需核对证书校验涉及的名称及服务端要求的相关参数。握手失败不一定是密码错误，不应通过随意关闭证书校验来替代问题定位。

HTTP

HTTP 代理在应用层转发请求，也可通过 CONNECT 建立通往目标的隧道。代理是否要求账号密码、是否保护客户端到代理服务器的传输，需要分别看具体配置。目标使用 HTTPS 不等于所有代理连接环节都采用同一种保护方式。

SOCKS5

SOCKS5 用于协商目标地址与端口，协议本身不提供传输加密。认证方式和 UDP 转发能力需要客户端与服务端共同支持。遇到部分应用能访问、部分实时通信失败时，应区分 TCP 与 UDP 的实际可用性。

WireGuard

WireGuard 是基于 UDP、使用公钥身份的隧道协议，配置结构与普通密码型代理不同。需要配套核对密钥、对端地址、隧道地址和路由范围。私钥属于敏感信息，排查时应隐藏，不能把完整配置直接放进公开截图。

Hysteria2

Hysteria2 基于 QUIC，连接表现与 UDP 可用性、链路丢包和拥塞情况有关。核对时关注认证、TLS 与服务端要求的带宽等参数，不要把带宽字段当成实测速率。协议机制不构成速度保证，仍应以相同网络条件下的实际任务判断。

查看协议字段与选型说明 →

03 / Rule keywords

规则关键字

规则先描述匹配对象，再指定处理策略。规则自上而下判断，首个命中项决定处理方式；更具体的规则通常应放在覆盖范围更宽的规则之前。

语法读法示例，不是可直接替换的完整配置

DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

这里 api.example.com 会先命中第一行，不会再由第二行决定策略。示例域名仅用于说明匹配范围。

DOMAIN

DOMAIN 精确匹配指定域名，例如 DOMAIN,example.com,PROXY。这条规则不会自动包含 www.example.com 等子域名。一个服务使用多个域名时，需要根据实际连接记录补全匹配范围。

DOMAIN-SUFFIX

DOMAIN-SUFFIX 按域名后缀匹配，覆盖指定根域名及其子域名。例如 example.com 可覆盖它自身及 api.example.com，不是任意包含同样文字的域名。若某个子域名需要不同策略，应将其更具体的规则放在前面。

DOMAIN-KEYWORD

DOMAIN-KEYWORD 检查域名中是否包含指定字符串，覆盖范围通常比 DOMAIN 更宽。字符串可能出现在并非预期的域名中，因此便利性与误匹配风险需要一起考虑。修改后应查看实际命中，而不是只测试一个目标。

IP-CIDR

IP-CIDR 使用 CIDR 表示法描述 IPv4 地址范围，例如 192.168.0.0/16。斜杠后的前缀长度决定网络范围，不能按单个地址理解。域名请求是否会进入这条规则判断，还与解析结果及相关规则选项有关。

IP-CIDR6

IP-CIDR6 用于 IPv6 地址范围匹配，与 IP-CIDR 的 IPv4 范围分开处理。目标同时提供两类地址时，只设置 IPv4 规则可能无法覆盖全部连接。排查同一域名走向不一致时，应查看实际连接使用的是哪类地址。

GEOIP

GEOIP 根据 IP 地理数据库的分类结果进行匹配，判断对象是地址而非网页使用的文字。数据库可能存在更新时差，也不能直接代表服务运营主体所在地。对必须精确处理的服务，宜根据实际目标补充更明确的域名或地址规则。

FINAL

FINAL 是前面规则均未命中时采用的兜底规则，通常放在末尾。FINAL,PROXY 表示把未命中的连接交给 PROXY，不表示前面已经命中的连接会被重新处理。兜底策略影响范围较大，修改前应先明确哪些连接会落到这里。

04 / Policies

策略与分组

规则关键字回答“匹配什么”，策略回答“如何处理”。注意区分 Global Routing 中的 Proxy / Direct 与规则文本中的 PROXY / DIRECT。

PROXY

PROXY 表示将匹配连接交给代理路径处理，实际出口还取决于当前选择和配置中的策略引用。命中 PROXY 不等于已经验证服务器可用。若策略命中正确而请求仍失败，应继续检查认证、传输和目标可达性。

DIRECT

DIRECT 表示直接连接目标，不经过所选代理服务器。它只影响命中这条策略的连接，不等同于关闭整个 VPN 连接。直接连接仍依赖当前网络和 DNS 正常工作，不能将失败一概归因于规则。

REJECT

REJECT 表示阻止匹配连接，适合配合边界清楚的匹配条件使用。过宽的域名关键字规则可能阻止正常功能所依赖的请求。某项功能突然不可用时，应先检查是否命中 REJECT，再决定是否调整规则范围。

策略与分组

策略分组用于组织规则可引用的处理目标，具体行为取决于分组类型和成员设置。Home 列表中用于整理服务器的分组，不必然等同于配置中参与路由的策略分组。规则引用分组名称时，应核对名称与目标是否存在，避免把整理标签误当成出口策略。

05 / Subscription & configuration

订阅与配置

服务器条目、订阅来源、路由配置和商店购买记录解决的是不同问题。恢复或更新时分别核对，不能用其中一项成功推断其余内容已经完整恢复。

SERVER

服务器条目保存地址、端口、协议与认证等连接信息，列表名称只是便于辨认的标签。两个条目名称不同，不代表它们一定使用不同的服务器；名称相同也不代表全部参数相同。排查重复条目或连接差异时，应比较实际字段。

Config

Config 既是配置文件入口，也是 Global Routing 中按配置处理连接的姿态名称。文件可包含规则、DNS 等设置，导入文件与选中启用文件是两个操作。修改前保留备份，修改后同时核对当前文件和 Global Routing，才能判断规则测试是否有意义。

iCloud 同步

iCloud 同步用于在设备之间同步受支持的应用数据，实际覆盖范围应按应用内选项核对。换机前检查账号、同步状态，并另行保留必要的配置备份。同步不等于所有内容都已恢复，新设备上仍要逐项验证服务器条目、Config 与当前选择。

已购项目

已购项目是 App Store 中查找购买记录与重新获取应用的入口，应使用原购买账号核对。恢复应用购买与恢复应用内配置是两件事，重新安装后仍需检查数据。购买适用范围、设备兼容性与系统要求以 App Store 页面标注为准。

Next / 按问题继续

操作与核对说明

术语用于定位概念；实际操作按教程执行，遇到异常再按连接状态和命中结果逐层排查。