官方手册 · 概念速查

Shadowrocket 概念速查

先辨认术语所在的位置，再判断它控制什么。这里将界面选项、协议名称、规则语法与网络概念分开解释；同样的词出现在不同位置，作用范围可能不同。

30 个常用术语
界面词保留英文
每条均可通过锚点定位

01 · 界面与开关

路由方式与连接状态

Global Routing 决定整体处理方式，连接开关决定是否建立连接。不要把路由模式、单条规则的动作和测试结果当作同一件事。

Global Routing: Home 页中选择整体路由方式的界面项，配置、代理、直连分别对应 Config、Proxy、Direct。排查规则不生效时，应先确认这里是否选择了 Config，再查看当前配置。改变模式不等于修改服务器的协议参数。

Config: 在 Global Routing 中，Config 表示依据当前配置处理请求，让规则决定各请求的路径。作为页面名称时，Config 又是管理配置文件的入口。看到这个词时，先确认是在选择路由模式，还是在查看文件列表。

Proxy: Global Routing 中的代理模式，主要按当前代理选择处理流量，而不是逐条依据分流规则作出同样的选择。它与规则里大写的 PROXY 分属不同层级。选中 Proxy 也不能补齐缺失的认证信息或修正错误端口。

Direct: Global Routing 中的直连模式，用于让请求通过直接连接路径访问目标，可辅助比较本地网络与代理路径的表现。直连仍依赖 DNS、目标服务及当前网络条件。Direct 不是“所有网站都可访问”的状态说明。

On Demand: 按条件触发连接的功能，具体行为需要结合应用内条件和系统状态核对。它关心的是何时连接，而分流规则关心的是请求怎样处理。排查自动连接时，应同时检查相关条件，不能只观察 Home 页开关。

Connectivity Test: 用于辅助判断服务器在指定测试条件下的响应情况，结果受测试方法、目标及网络状态影响。测试成功不代表每个网站都能访问，测试耗时也不是下载速度。出现异常时，应继续核对真实请求和错误记录。

02 · 协议

连接类型与参数约束

协议类型必须与已有服务器信息相符。不能只改 Add Server 中的类型，就把同一组凭据变成另一种协议；更完整的设计取舍见协议详解 →

Shadowsocks: 使用指定加密方法与凭据建立代理连接的协议，常见参数包括服务器地址、端口、密码与加密方法。上述信息需要和服务器端一致，尤其不能根据名称猜测加密方法。连接表现还受服务器负载及本地网络影响。

VMess: 包含身份认证机制的代理协议，通常使用 UUID 标识用户，并可搭配不同传输方式。UUID 正确只是必要条件之一，传输路径、服务器名称和 TLS 等设置也要对应。排查时应按字段核对，而不是反复更换条目名称。

VLESS: 以精简认证与转发为设计方向的代理协议，通常也使用 UUID，但不能因此与 VMess 混用配置。连接保护取决于所搭配的安全层与传输设置。导入后应确认类型、认证字段及传输参数都与原始信息相符。

Trojan: 通常结合 TLS 与密码认证使用的代理协议，除服务器地址和密码外，还要关注服务器名称及证书验证。地址能够解析，不代表 TLS 握手能够完成。遇到证书错误时，先核对名称、设备时间与服务器配置。

HTTP / SOCKS5: 这是两类不同的代理协议，支持的请求形式、认证方式与承载能力并不完全相同。协议名称本身不代表传输已经加密，也不能据此推断是否支持某类流量。添加时应按已有服务器说明选择对应类型及安全选项。

WireGuard: 基于密钥身份与 UDP 传输的隧道协议，配置涉及 PrivateKey、PublicKey、接口地址、Endpoint 和 AllowedIPs。密钥、地址与路由范围各有职责，不能互换填写。PrivateKey 属于敏感信息，分享排查材料时应移除。

Hysteria2: 基于 QUIC 的代理协议，依赖可用的 UDP 网络路径，配置还涉及认证与服务器名称等参数。协议名称中的数字是名称的一部分，不是本站给出的应用版本号。其速度和电量表现取决于网络丢包、传输负载与设备状态，不能仅凭类型判断。

03 · 规则关键字

匹配条件与处理策略

先理解“匹配什么”，再理解“命中后做什么”。下列域名与地址仅用于说明语法，不是可用服务器信息；规则顺序也会影响最终结果。

DOMAIN: 用于完整域名匹配，例如 DOMAIN,example.com,DIRECT 针对 example.com 本身。它不会自动覆盖该域名下的所有子域名，也不是按网页完整 URL 匹配。若请求使用了另一个域名，应检查实际请求记录。

DOMAIN-SUFFIX: 用于域名后缀匹配，例如 DOMAIN-SUFFIX,example.com,PROXY 可覆盖 example.com 及其子域名。它比 DOMAIN 覆盖范围更广，但不是任意字符串包含匹配。添加前应确认是否确实希望整组子域名使用同一策略。

GEOIP: 依据 IP 地理归属数据库进行匹配，结果受数据库内容及目标解析地址影响。IP 归属不等于用户所在地或实际服务位置。一个域名可能解析到多个地址，因此不能只看网站名称推断命中结果。

IP-CIDR: 用于 IPv4 网段匹配，例如 IP-CIDR,192.168.0.0/16,DIRECT 描述一个私有地址范围。斜杠后的数字是网络前缀长度，不是端口或连接数量。配置范围过宽时，可能把原本需要区别处理的地址一并匹配。

IP-CIDR6: 用于 IPv6 网段匹配，与 IP-CIDR 面向的地址族不同。目标同时具有 IPv4 与 IPv6 地址时，仅设置 IPv4 规则并不等于已经检查全部请求路径。排查结果不一致时，应核对实际使用的地址族。

FINAL: 用于处理此前没有命中其他规则的请求，通常作为规则末尾的兜底项。FINAL,DIRECT 表示剩余请求交给直接连接路径，不表示前面的规则失效。检查意外分流时，应先找实际命中的规则，再看是否落到了 FINAL。

PROXY / DIRECT / REJECT: 三者是规则中的处理策略：PROXY 交给代理路径，DIRECT 使用直接连接，REJECT 拒绝请求。它们描述命中后的动作，不是协议类型或匹配条件。大写策略与 Global Routing 中的 Proxy、Direct 应按位置区分。

04 · 订阅与配置

条目、文件与购买记录

订阅更新、配置切换和应用更新是三件不同的事。以下说明以用户已有自己的订阅或服务器信息为前提，购买客户端不会自动生成这些信息。

服务器条目: 一条保存服务器地址、端口、认证与协议参数的连接记录，也常被称为节点。SERVER 区块中的显示名称只是标签，不能证明服务器位置、速度或可用性。使用 Add Server 手动填写时，应逐项对应已有信息。

配置文件: 用于组织规则、DNS 等设置的文本配置，与单个服务器条目承担不同职责。文件导入后，还要确认当前启用的是哪一份，并结合 Global Routing 判断其作用。替换文件前保留原有可用配置，便于比较与恢复。

规则: 由匹配条件与处理策略组成的配置项，例如按域名匹配后选择 DIRECT。规则通常按顺序检查，较宽泛的条件可能在前面先命中，使后面的精确条件没有机会生效。判断问题应查看实际命中项，而不只搜索文件中是否存在目标域名。

已购项目: App Store 中查找既有购买记录的入口，换设备或重装时应先确认使用购买时的 Apple ID。Shadowrocket 为一次性买断，价格及通用购买适用性以 App Store 页面标注为准。客户端一次性买断 ≠ 线路套餐，恢复应用也不等于恢复服务器信息。

05 · DNS 与网络

解析、握手与响应耗时

一次访问可能依次经历解析、建立连接、安全握手与传输。某一步成功不能证明后续步骤也成功，应按照错误出现的阶段定位问题。

DNS: 用于将域名解析为 IP 地址等记录的系统，解析结果是后续连接的重要输入。解析成功只说明获得了回答，不代表地址可达或目标服务工作正常。DNS 查询路径与业务请求路径也不必然相同，需要分别核对。

DNS over HTTPS: 通过 HTTPS 承载 DNS 查询的方式，常简称 DoH，用于保护客户端与解析服务之间的查询传输。解析服务自身仍需可达，其域名也可能涉及初始解析。启用 DoH 不等于所有业务请求都会使用代理路径。

TLS: 用于保护传输连接并验证对端身份的安全协议，与代理协议类型并非同一概念。证书验证失败可能涉及服务器名称、证书有效期、信任链或设备时间。排查时应核实这些信息，而不是直接把错误归因于密码。

SNI: TLS 握手中用于声明目标服务器名称的扩展信息，帮助同一地址上的服务选择对应站点与证书。它不一定等于实际连接的 IP 地址，但必须符合服务器部署要求。名称不匹配时，即使端口可达，也可能无法完成握手。

延迟: 在指定测试方法下测得的响应耗时，需要连同测试类型、目标与本地网络条件一起解释。低延迟不等于高吞吐量，更不能保证大文件传输稳定。比较结果时尽量保持测试条件一致，并结合真实访问及错误记录判断。