Shadowrocket术语手册
按界面名称、协议与规则语法查词。英文保留应用中的原样写法，中文解释说明用途与边界；操作步骤请结合教程阅读，遇到连接问题再转到排查手册。
INTERFACE & SWITCHES
界面与开关
先看设置所在的位置。相似的英文词可能分别表示一个页面、一个运行姿态或一条规则的处理结果。
- Home
- 查看服务器条目与订阅分组、选择连接对象并操作连接开关的界面。导入后应先确认条目确实出现在这里，再核对当前选中项；导入成功只是保存了参数，不代表服务器已经可以连接。连接开关开启后，还要使用实际请求确认网络是否按预期工作。
- Global Routing
- 控制整体流量处理姿态的设置，可选择 Config、Proxy 或 Direct。排查规则不生效时，应先核对这里，而不是立即重写规则；整体姿态不同，同一份配置可能产生不同的请求路径。它与连接开关是两个维度，选好姿态并不等于已建立连接。
- Config / Proxy / Direct
- 三种姿态分别对应按配置处理、整体使用代理路径、整体直接连接，界面名称保持为 Config、Proxy、Direct。需要规则分流时使用 Config；临时切换 Proxy 或 Direct 可以帮助比较路径，但测试后应恢复原来的选择。这里首字母大写的界面词，不要与规则中的全大写策略关键字混为一谈。
- On Demand
- 根据配置条件触发 VPN 连接行为的设置，用于控制何时建立或恢复连接。它处理的是连接触发条件，不负责判断某个域名应该使用哪条规则。若手动关闭后连接又恢复，应检查 On Demand 的条件，而不是仅反复操作连接开关。
- Add Server
- 使用已有服务器信息建立连接条目的入口，需要先选择与服务器一致的协议，再填写对应字段。地址、端口和认证信息属于不同参数，不能只凭显示名称判断填写是否正确。传输方式、TLS 与其他可选字段也应依据用户已有的服务器说明核对，不宜通过随意尝试组合来设置。
- Connectivity Test
- 用于检查条目在当前网络及所选测试方法下的连通性。结果只说明此次测试所覆盖的路径，不能证明所有网站、所有传输方式都正常。测试通过但实际请求失败时，还需检查 Global Routing、DNS 与目标规则；测试超时也不能直接断定认证信息一定错误。
PROTOCOLS
协议
协议规定客户端与服务器怎样通信。协议名相同仍不代表参数相同，添加时应逐项对照用户已有的信息。
- Shadowsocks
- 用于客户端与服务器之间传输代理流量的协议，连接需要匹配的服务器地址、端口、加密方法与密码。加密方法是协议参数，不能只因为名称相近就互换。若已有信息包含额外传输设置，也需要配套核对；修改显示名称不会修复这些参数不一致的问题。
- VMess
- 包含身份验证机制的代理协议，常见连接信息涉及用户标识、传输方式与安全设置。服务器地址可达，仅能证明网络路径的一部分成立，身份验证或传输参数不一致仍可能导致连接失败。设备时间明显不准确也可能影响认证，应先保持系统时间正确再排查其他字段。
- VLESS
- 一种轻量的代理协议，其传输保护取决于实际配置的安全层，不能仅凭协议名判断连接的保护方式。用户标识、传输方式及相关安全参数必须与服务器一致。若导入条目后仍无法连接，应回到原始服务器说明核对这些字段，而不是将其直接改成另一个协议类型。
- Trojan
- 通常结合 TLS 使用的代理协议，认证信息与证书相关设置共同影响连接是否成功。服务器地址、用于 TLS 的名称与证书所覆盖的域名可能承担不同用途，应分别核对。遇到证书错误时先检查名称、设备时间与服务器证书，不应把关闭验证当作常规修复步骤。
- Hysteria2
- 基于 QUIC 的代理协议，底层通信依赖 UDP，因此网络是否允许相应 UDP 流量很重要。它在不同链路上的实际表现还受到拥塞、丢包、服务器资源和参数设置影响，不能仅由协议名判断速度。若普通网页可打开而该条目持续超时，需要把底层 UDP 可达性列入检查范围。
- WireGuard
- 基于密钥建立加密隧道的 VPN 协议，配置通常涉及本地地址、对端公钥、端点和允许的地址范围。隧道建立不代表所有目标都自动有正确路由，还需检查路由范围和 DNS。私钥属于敏感信息，分享排查材料时应遮去私钥及其他能够用于认证的内容。
RULE KEYWORDS
规则关键字
规则通常按顺序检查，先匹配的规则决定处理结果。关键字描述匹配条件，行末策略描述匹配之后如何处理。
- DOMAIN
- 按完整域名精确匹配，适合只指定一个主机名的情况。例如
DOMAIN,example.com,DIRECT针对 example.com，不自动覆盖它的所有子域名。若目标还有单独的 API 或静态资源域名，需要分别考虑，不能因为主页面匹配成功就认定整个页面的请求路径都一致。
- DOMAIN-SUFFIX
- 按域名后缀匹配，可覆盖指定域名及其子域名。例如
DOMAIN-SUFFIX,example.com,PROXY可用于 example.com 与其子域名，而不是匹配任意包含 example.com 字符串的主机名。添加范围较大的后缀规则前，应检查前面是否已有更具体的例外规则。
- DOMAIN-KEYWORD
- 匹配域名中包含的指定字符串，范围通常比完整域名或后缀匹配更宽。它可能同时命中多个彼此无关的域名，因此不宜把短字符串直接当作精确条件使用。发现意外分流时，应检查是否存在过宽的关键词规则，以及它是否排在更具体的规则之前。
- GEOIP
- 依据 IP 地理数据库中的归属信息匹配目标地址，结果受数据库内容及解析得到的 IP 影响。它不是设备实时定位，也不能保证准确反映服务器的物理位置。目标使用分布式服务时，解析地址可能随网络变化，因此不能只靠域名印象判断某条 GEOIP 规则是否应该命中。
- IP-CIDR / IP-CIDR6
- 分别按 IPv4 与 IPv6 地址段匹配，斜杠后的前缀长度决定覆盖范围。例如
IP-CIDR,192.168.0.0/16,DIRECT描述一个 IPv4 私有地址段，并非只匹配单个地址。编写地址段规则时要同时考虑 IPv6 路径，避免只检查 IPv4 就误认为所有请求都已覆盖。
- FINAL
- 前面的规则都没有匹配时使用的兜底规则，一般放在规则列表末尾。
FINAL,DIRECT表示剩余请求直接连接，FINAL,PROXY表示剩余请求使用代理路径。修改它会影响大量未被具体规则覆盖的请求，因此应先理解已有规则，再调整兜底策略。
- PROXY / DIRECT / REJECT
- 常见规则策略关键字，分别表示使用代理路径、直接连接和拒绝请求。规则末尾的 PROXY 不表示某一台固定服务器名称，实际使用的连接对象还取决于当前选择及配置。DIRECT 也不表示退出客户端的全部处理流程；它说明的是该请求的连接路径，DNS 等行为仍需结合配置判断。
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT若示例中的目标请求先命中了其他规则，后面的同类规则不会继续决定该请求的策略。完整排查流程见规则分流与连接排查。
SUBSCRIPTION & CONFIGURATION
订阅与配置
订阅管理连接条目，配置管理处理方式。导入、更新、选用和连接是不同操作，应分别验证结果。
- Subscribe
- 用于导入与更新一组服务器条目的订阅类型，链接来自用户已有的服务提供方。链接可能包含用于识别账户的敏感参数，应作为凭据保管，不要完整放进截图或公开排查记录。订阅能够导入，仅说明客户端取得并识别了内容，之后仍需选择条目、测试并验证实际连接。
- 服务器条目
- 客户端中保存的一组连接参数，通常包含服务器地址、端口、协议和认证信息，也可能包含传输与 TLS 设置。条目的显示名称只是便于辨认的标签，不保证反映服务器位置、速度或可用状态。用户修改由订阅生成的条目前应保留记录，因为后续订阅更新可能替换相应参数。
- Config
- 作为界面名称时，用于管理规则与相关网络设置的配置文件；作为 Global Routing 选项时，表示按当前配置处理请求。配置文件与服务器订阅用途不同，更新其中一项不代表另一项也已更新。文件已经导入也不等于已经选用，排查时应确认当前实际使用的是哪一份。
- 订阅更新
- 重新请求订阅链接，并依据返回内容更新对应条目的操作；它与通过 App Store 更新 Shadowrocket 是两件事。更新失败可能发生在链接访问、服务器响应或内容识别阶段，应按阶段定位，而不是直接删除现有分组。更新后需重新核对当前选择，尤其要注意原条目已被移除或参数发生变化的情况。
DNS & NETWORK
DNS 与网络
把域名解析、服务器连接和目标访问分开检查。某一项成功，不能直接推出其余环节也正常。
- DNS
- 将域名解析为 IP 地址等记录的系统，是许多网络请求建立连接前的一步。解析失败时，请求可能尚未进入目标连接阶段；解析成功时，也仍可能遇到端口不可达、认证失败或目标服务错误。排查中应区分“没有解析结果”与“有结果但连不上”，两者需要检查的设置不同。
- 系统 DNS / 自定义 DNS
- 系统 DNS 通常来自当前网络提供的解析设置，自定义 DNS 则是用户明确配置的解析器。最终使用哪条解析路径，还可能受到配置文件、域名规则及网络环境影响，不能只看填写了哪个地址。更换解析器后应使用相同目标复测，并考虑缓存是否仍在复用之前的结果。
- DNS over HTTPS
- 通过 HTTPS 传输 DNS 查询的方式，常缩写为 DoH，它改变的是解析请求的传输方式，不是代理协议。解析端点本身也必须可达，端点域名的解析与连接路径同样需要正确。改用 DNS over HTTPS 不会自动修复服务器认证、规则选择或目标网站故障。
- 延迟 / 超时
- 延迟表示特定测试中等待响应的时间，含义取决于测试方法；超时表示在限定时间内没有取得预期响应。延迟较低不等于持续传输速度较高，也不能证明所有目标都可访问。比较结果时应保持测试方法、网络和目标一致，否则数字之间通常没有直接可比性。
- TCP / UDP
- 两种常见传输层协议：TCP 提供有序可靠的字节流，UDP 传递数据报，其可靠性机制可由上层协议实现。某个 TCP 测试成功，不代表同一网络中的 UDP 通信也可用；使用 QUIC 等传输时尤其需要区分。排查应先确认当前协议依赖哪一种底层通信，再决定测试对象。