Home
Home 是查看服务器列表、当前选择与连接状态的主要入口。服务器已经出现在列表中，只能说明记录已保存；仍需选择合适的记录并开启连接。排查时先区分“记录存在”“已选中”和“连接已建立”这三种状态。
官方手册 · 术语查阅
Shadowrocket 名词解释
按界面入口、协议、规则与网络概念查阅。先辨认术语所在的层级，再判断需要修改的是服务器参数、配置文件，还是整体连接方式；英文名称保持与界面及规则语法一致。
- 界面词保留英文
- 规则关键字区分大小写写法
- 以已有订阅或服务器信息为前提
入口与连接方式
界面与开关
界面入口负责组织操作，连接状态负责反映运行情况。进入某个页面或选中一条记录，本身都不等于已经建立连接。
Global Routing
Global Routing 决定整体路由方式：配置、代理、直连分别对应 Config、Proxy、Direct。Config 按当前配置中的规则处理请求；Proxy 以代理方式处理流量；Direct 以直连方式处理流量。这里的模式选择与单条规则末尾的动作不是同一层级。
On Demand
On Demand 利用系统按需连接机制，在满足设定条件时触发 VPN 连接。它负责何时尝试建立连接，不负责保证服务器有效、认证正确或目标网站可达。手动断开后再次出现连接时，应连同该设置和网络条件一起检查。
Add Server
Add Server 用于手动新增服务器记录，填写内容随协议类型变化。地址、端口、认证字段和传输参数需要逐项对应已有的服务器信息，不能只凭名称猜测。保存后再回到列表选择记录，并通过实际请求验证。
Settings
Settings 是查看与调整应用设置的入口，和保存具体服务器参数的编辑页用途不同。排查问题时应先记录原值，再一次修改一项，以便确认变化来自哪项设置。具体选项及位置以设备上的实际界面为准。
Connectivity Test
Connectivity Test 用于检查指定测试目标在当前条件下是否可达。测试方法、目标地址和本地网络都会影响结果，因此不能把单次成功视为所有业务都正常。出现异常时，应将测试结果与 DNS、请求记录及实际网页访问交叉核对。
连接参数的共同语言
协议
协议规定客户端与服务器如何交换数据。协议名相同仍不代表参数相同，认证、传输和 TLS 设置需要分别核对。
Shadowsocks
Shadowsocks 是一种代理协议，常见必要信息包括服务器地址、端口、加密方法与密码。加密方法是连接参数的一部分，不能因为密码正确就忽略它。手动填写或导入后，应检查字符是否完整，并与已有服务器信息保持一致。
VMess
VMess 是一种带身份验证的代理协议，身份信息与传输方式属于不同参数层。填写身份标识后，还需要核对端口、传输路径及 TLS 等相关设置。认证失败与传输建立失败可能表现相似，应按层次检查，而不是反复更换同一个字段。
VLESS
VLESS 是一种代理协议，通常需要身份标识及与服务端相符的传输参数。身份标识用于识别连接，不等于已经完成传输加密或证书验证。配置时应使用完整的已有参数，并分别确认身份、传输与安全设置。
Trojan
Trojan 通常结合 TLS 使用，以密码等信息进行认证。服务器地址、端口、TLS 名称和证书验证都会影响连接，密码正确并不足以排除其他问题。遇到证书错误时，应核对服务器名称与证书配置，而不是直接跳过验证。
Hysteria2
Hysteria2 是基于 QUIC 的代理协议，底层通信依赖 UDP。当前网络限制 UDP 时，其他类型连接正常并不能证明它也能正常建立。认证、TLS 及其他参数应依照已有配置填写，协议名称本身不代表固定的速度或稳定性。
WireGuard
WireGuard 通过密钥对建立加密隧道，本地私钥与对端公钥承担不同职责，不能互换。Address 表示隧道接口地址，不是服务器的公网连接地址；DNS 与 MTU 也分别影响解析和数据传输。私钥应按敏感信息保存，参数含义可继续查阅WireGuard 参数说明。
HTTP / SOCKS5
HTTP 与 SOCKS5 是不同的代理协议类型，应按已有服务器信息选择，不能只因地址和端口相同就互换。是否需要用户名、密码以及是否具备传输保护，取决于服务端配置与具体连接方式。协议名称不等于加密保证，也不代表所有请求类型都受支持。
匹配条件 → 执行动作
规则关键字
先看规则在匹配什么，再看匹配后执行什么。以下语法用于理解结构，示例域名不代表应直接套用的配置。
Rule
Rule 由匹配条件与执行动作组成，用于决定请求的处理路径。配置模式下一般从前向后检查规则，先命中的规则影响最终结果，因此较具体的条件通常放在较宽泛的条件之前。修改后应检查请求实际命中的规则，而不是只看规则文本是否已经保存。
DOMAIN
DOMAIN 按完整域名匹配，例如 DOMAIN,example.com,DIRECT。它针对指定域名，不会因为名称有关联就自动覆盖所有子域名。需要同时覆盖主域名及其子域名时，应先判断是否更适合使用 DOMAIN-SUFFIX。
DOMAIN-SUFFIX
DOMAIN-SUFFIX 按域名后缀匹配，通常覆盖指定域名本身及其子域名。例如针对 example.com 的后缀规则可用于该主域名与下级域名，不表示匹配任意包含这段文字的名称。一个页面可能请求多个不同域名，主域名命中也不代表全部资源使用同一路径。
DOMAIN-KEYWORD
DOMAIN-KEYWORD 检查域名是否包含指定关键字，匹配范围通常比完整域名或后缀规则更宽。较短、较常见的关键字容易包含原本不打算处理的域名。只有确实需要这种范围时才使用，并结合请求记录确认有没有误匹配。
GEOIP
GEOIP 依据 IP 地理数据库的归属信息匹配，例如 GEOIP,CN,DIRECT。数据库归属不等于服务器精确物理位置，也不能直接代表访问速度。针对域名请求时，还应考虑解析结果和地址选择是否改变了实际参与匹配的 IP。
IP-CIDR / IP-CIDR6
IP-CIDR 与 IP-CIDR6 分别用于匹配 IPv4、IPv6 地址段。地址后斜杠标注的前缀长度决定覆盖范围，不能把它当成端口号。仅添加 IPv4 规则并不等于已经覆盖同一服务的 IPv6 地址，检查时应同时留意实际连接使用的地址类型。
FINAL
FINAL 处理没有被前面规则命中的请求，通常放在末尾作为兜底。FINAL,PROXY 与 FINAL,DIRECT 对剩余流量的处理不同，因此不能只检查前面的域名规则。若兜底规则前移，后面的细分规则可能得不到匹配机会。
PROXY / DIRECT / REJECT
PROXY 表示交给代理路径，DIRECT 表示直接连接目标，REJECT 表示拒绝请求。它们是规则中的动作，与 Global Routing 的 Proxy、Direct 整体模式应分开理解。PROXY 命中后仍需要有效的服务器和正确参数，规则匹配成功不等于后续连接成功。
记录、更新与保存
订阅与配置
服务器订阅负责维护连接记录，配置文件负责组织规则等设置。导入、同步与备份有不同用途，不宜互相替代。
Subscribe
Subscribe 用于通过用户已有的订阅链接维护服务器列表，更新时重新读取该链接返回的内容。订阅链接可能携带认证信息，应像密码一样保管；更新后记录变化应先与订阅返回内容核对。服务器列表更新不等于规则配置也随之更新。
SERVER
SERVER 表示承载服务器连接信息的记录，中文说明中也常称为服务器或节点。显示名称主要用于辨认，实际连接依赖地址、端口、协议、认证及相关传输参数。名称相同不代表参数相同，重命名也不会改变服务器本身的网络能力。
Config
Config 可指管理配置文件的界面入口，也可指 Global Routing 中的配置模式，需要结合上下文辨认。配置文件用于组织规则、DNS 等设置，服务器订阅则主要维护服务器记录。文件已导入并不等于已经选用，验证时还要确认当前配置和整体路由方式。
Scan QR Code
Scan QR Code 通过相机读取二维码中的可识别连接信息，首次使用可能需要相机权限。二维码只是信息载体，不会自动保证其中参数完整或有效。导入后应核对协议、地址和认证字段，含有连接凭据的二维码也应避免公开传播。
分享链接
分享链接以协议对应的格式编码连接参数，可能包含服务器地址、认证信息和传输设置。单条服务器分享链接与可更新整个列表的订阅链接用途不同，不能只因都是文本链接就混用入口。通过剪贴板导入后，应检查特殊字符与字段是否被完整保留。
iCloud 同步
iCloud 同步用于在设备间同步应用支持的数据，实际范围取决于应用设置与系统状态。同步不是完整备份的同义词，换机后仍应逐项检查服务器、当前配置及连接设置。手动导出的文件也可能含敏感参数，恢复前可参阅配置备份与换机迁移。
解析、握手与传输
DNS 与网络
请求需要经过多个阶段。区分域名解析、服务器连接、认证和内容传输，才能让排查顺序对应到实际故障。
DNS
DNS 将域名解析为 IP 地址等记录，是访问网站时常见的前置步骤。DNS 返回结果不等于目标已经可达，而服务器延迟正常也不能证明域名解析正常。出现网页打不开时，应先判断失败发生在解析阶段，还是解析后的连接与传输阶段。
延迟
延迟表示一次指定测试所需的时间，含义取决于测试方式与目标。较低的延迟不等于较高的下载带宽，也不保证其他网站或应用使用相同路径。比较记录时应保持测试条件一致，并结合实际请求确认结果。
TLS / SNI
TLS 用于保护传输，SNI 用于在 TLS 握手时指示所访问的服务器名称。用于建立连接的地址与该名称可能不同，填写时应分别遵循已有服务器配置。证书验证错误应检查名称、证书链与设备时间，不应仅通过忽略错误来判断连接是否正确。
UDP
UDP 是一种数据报传输协议，部分隧道协议、实时通信和解析请求会使用它。依赖 UDP 的连接需要本地网络、服务器及相关设置共同支持。网页能打开不代表 UDP 路径也正常，排查时应使用与故障业务相符的测试方式。
MTU
MTU 表示链路可承载的最大传输单元大小，隧道封装会占用额外空间。设置不合适时，可能出现连接能建立但部分内容传输异常的现象；仅凭这一现象仍不能直接认定原因。调整时应记录原值，遵循已有配置并用相同业务复测。