官方手册 / 术语参考
Shadowrocket 术语表
保留英文原文，按使用位置理解含义。先区分界面模式、协议与规则动作，再核对已有订阅或服务器信息中的参数。
30 个术语条目
界面词与规则关键字
按类别查阅
01 / 界面与开关
模式名称与操作入口
Global Routing（全局路由）的三种姿态为 Config（配置）、Proxy（代理）、Direct（直连）。模式决定处理方式，不代表服务器是否可用。
- 界面与开关Home（首页）
- 查看服务器条目、订阅分组并选择连接对象的主要入口。列表里出现条目只表示连接信息已经保存，不表示认证成功或已经建立连接。排查时先核对当前选择的条目，再检查连接开关和实际访问结果。
- 界面与开关Global Routing（全局路由）
- 决定连接如何处理的模式选择，包含 Config（配置）、Proxy（代理）和 Direct（直连）。Config 按当前配置规则分流，Proxy 按代理路径处理，Direct 按直连路径处理。切换模式与更换服务器是两项不同操作，测试前应记录两者的当前状态。
- 界面与开关Config（配置）
- 这个词既可表示配置管理入口，也可表示 Global Routing 中的配置模式，需要结合所在位置判断。在配置模式下，连接由当前启用的规则决定去向。仅导入服务器订阅不代表已经选好配置，也不代表所有目标都会经过代理。
- 界面与开关Proxy（代理）
- 作为 Global Routing 的选项时，表示按代理模式处理连接，适合在排查中与配置模式作受控对照。它不会修复错误的密码、失效的地址或不匹配的协议参数。注意界面词 Proxy 与规则动作 PROXY 的大小写及作用层级不同。
- 界面与开关Direct（直连）
- 作为 Global Routing 的选项时，表示连接不经所选代理服务器转发。直连仍依赖当前网络、DNS 解析和目标服务自身的可用性，并不等于关闭设备网络。切换至 Direct 后访问成功，只能说明该直连路径可用，不能据此确认代理参数正确。
- 界面与开关Add Server（添加服务器）
- 手动填写已有服务器信息的入口，字段随所选协议变化。应先选对协议，再逐项核对地址、端口、身份认证和传输相关参数。不要为了让表单看起来完整而填写未知字段，也不要把订阅地址直接当作服务器主机地址。
02 / Settings 设置项
解析、按需连接与诊断
设置项用于调整连接行为或观察状态。遇到问题时一次只修改一项，保留修改前的取值，避免同时改变多个条件而无法判断原因。
- Settings 设置项DNS（域名解析）
- 负责把域名转换为可连接的 IP 地址，解析结果还可能参与地址类规则匹配。解析路径和业务连接路径不应简单视为同一件事。修改 DNS 后若结果未立即变化，应考虑缓存、当前配置及系统网络状态，而不是反复叠加新的设置。
- Settings 设置项On Demand（按需连接）
- 通过已配置的条件触发系统连接行为，用于减少重复的手动操作。它决定何时尝试连接，不代替服务器选择、协议参数或分流规则。测试手动断开行为时应同时检查按需条件，避免把条件触发的重新连接误判为开关没有生效。
- Settings 设置项Ping（响应探测）
- 与响应时间探测有关的设置或测试概念，结果取决于探测方法、目标和当时网络。较短的响应时间不等于更高的下载速度，单次超时也不能证明所有业务连接都会失败。比较结果时应使用相同方法，并结合实际访问和日志判断。
- Settings 设置项Log（日志）
- 用于观察连接过程，辅助区分域名解析、服务器连接、身份认证及规则匹配等环节。查看时应围绕一次明确的测试操作定位对应记录，不宜只根据最后一行推断原因。日志可能包含访问目标或服务器信息，对外分享前应移除敏感内容。
- Settings 设置项Widget（小组件）
- 指与系统小组件有关的功能，便于查看状态或进入相关操作。可用的小组件形式和内容以设备系统及应用内界面为准。小组件显示的状态可作为入口提示，但验证连接是否满足预期仍应回到应用和实际访问结果。
- Settings 设置项iCloud Sync（iCloud 同步）
- 利用 iCloud 在符合条件的设备间同步应用支持的数据，实际同步范围应按应用内说明核对。它不等同于完整设备备份，也不等同于恢复 App Store 购买记录。更换设备前应确认同步已完成，并单独妥善保存仍需使用的订阅与服务器信息。
03 / 协议
协议名称与参数边界
协议定义客户端和服务器如何建立通信。名称不是性能排序；应使用已有服务器实际支持的协议，传输方式与安全参数也必须对应。
- 协议Shadowsocks
- 一种代理协议，连接时需要匹配服务器地址、端口、加密方法和密码等信息。加密方法是协议参数，不能仅凭名称相近就相互替换。已有记录若包含额外参数，也应按原始服务器说明核对，而不是只复制地址和端口。
- 协议VMess
- 具有身份验证与加密机制的代理协议，通常还需配合具体传输设置。身份标识、传输类型及相关字段需要与服务器一致，仅地址正确不足以建立连接。排查时应将协议认证与传输层分开检查，同时确认设备时间设置正常。
- 协议VLESS
- 一种轻量代理协议，协议身份验证与承载连接的传输安全设置需要分别理解。导入记录后，应同时检查身份标识和服务器要求的传输、安全选项。不能因为它与 VMess 使用了相似形式的标识，就把两者的连接类型直接互换。
- 协议Trojan
- 通常使用 TLS 承载连接并通过密码完成认证的代理协议。除地址、端口和密码外，还应核对服务器名称及证书验证相关要求。遇到证书错误时先检查名称、设备时间与服务器配置，不应把关闭验证当作常规解决办法。
- 协议Hysteria2
- 基于 QUIC 的代理协议，其底层通信依赖相应的 UDP 路径。服务器认证参数正确，也仍可能因当前网络限制 UDP 通信而无法建立连接。协议名称本身不保证速度，任何带宽相关字段都应按实际服务器说明填写。
- 协议WireGuard
- 使用公私钥进行身份认证的隧道协议，需要正确配置端点、密钥、地址及路由相关参数。公钥与私钥用途不同，不能互换，私钥应按敏感凭据保管。成功导入一份记录不代表地址和路由已经适合当前环境，仍需验证实际连接。
- 协议HTTP / SOCKS5
- 这是两种不同的代理协议，并非同一类型的不同名称，认证与传输能力也由服务器实际设置决定。仅凭端口数字不能可靠判断应选哪一种协议。普通 HTTP 代理和 SOCKS5 本身不等同于加密隧道，应另行核对链路的安全条件。
04 / 规则关键字
匹配条件与处理动作
规则通常由匹配类型、匹配内容和处理动作组成。阅读时先看条件是否命中，再看动作指向哪里；规则顺序也会影响最终结果。
- 规则关键字DOMAIN / DOMAIN-SUFFIX
- DOMAIN 用于匹配指定的完整域名，DOMAIN-SUFFIX 用于匹配域名后缀及其子域名。例如
DOMAIN-SUFFIX,example.com,PROXY可覆盖该域名及其子域名。匹配内容应写域名而不是包含路径的完整网址，两类写法的覆盖范围也不同。
- 规则关键字DOMAIN-KEYWORD
- 根据域名中是否包含指定关键字来匹配，范围通常比完整域名或域名后缀更宽。较短或常见的字符串可能命中原本没有打算处理的域名。希望只覆盖确定目标时，优先判断能否使用 DOMAIN 或 DOMAIN-SUFFIX 明确边界。
- 规则关键字GEOIP
- 根据 IP 地理归属数据库匹配地址，例如
GEOIP,CN,DIRECT。它判断的是地址在数据库中的归属，不是网页语言、内容来源或网站经营主体所在地。数据库变化、域名解析结果和缓存都可能影响实际命中情况。
- 规则关键字IP-CIDR / IP-CIDR6
- 分别用于匹配 IPv4 与 IPv6 地址段，斜杠后的前缀长度决定范围。前缀长度写错可能扩大匹配范围，使无关连接落入同一策略。只处理 IPv4 规则不能自动覆盖 IPv6，应结合目标实际使用的地址族检查。
- 规则关键字FINAL
- 用于处理前面规则未匹配的连接，通常放在规则列表末尾作为兜底。
FINAL,PROXY表示把剩余连接交给 PROXY 所指向的处理策略。它不是测试服务器可用性的指令；前面已命中的连接不会再由末尾兜底规则重新决定。
- 规则关键字PROXY / DIRECT / REJECT
- 这些大写关键字表示规则动作，而不是域名或协议：PROXY 交给代理策略处理，DIRECT 使用直连，REJECT 拒绝连接。PROXY 最终使用的对象还应结合当前配置与选择检查。它们与 Global Routing 中的 Proxy、Direct 不是同一层级的开关。
05 / 订阅与配置
数据来源、导入与购买记录
服务器订阅更新连接条目，配置文件组织处理逻辑，App Store 记录应用购买。三者分开保存、分开恢复，避免把应用恢复误认为连接信息恢复。
- 订阅与配置Subscribe（订阅）
- 通过用户已有订阅地址获取并更新服务器条目的机制，地址应从你的服务商处获取。订阅地址可能携带访问凭据，不应贴入公开页面、截图或日志。更新会按订阅内容刷新相关条目，不代表自动修复过期认证，也不等同于修改全部分流规则。
- 订阅与配置Server（服务器条目）
- 保存协议、主机地址、端口及认证等信息的一条连接记录，列表中的备注名主要用于辨认。两个条目名称相同不一定参数相同，名称不同也可能指向同一服务器。排查和去重时应对照实际字段，而不是只看备注或分组名称。
- 订阅与配置配置文件
- 用于组织规则、DNS 及其他处理选项，决定连接在配置模式下如何分流。服务器订阅主要更新连接对象，配置文件主要描述处理逻辑，两者不能简单互相替代。启用新配置前应保留可回退的副本，并确认其中引用的策略能够对应实际连接对象。
- 订阅与配置Scan QR Code（扫描二维码）
- 读取二维码所携带连接信息的导入入口，二维码只是数据载体，不是单独的协议。应仅扫描来源明确且属于你已有服务的内容，并在保存后核对识别出的协议和必要字段。二维码也可能包含敏感认证信息，不宜作为普通图片公开分享。
- 订阅与配置已购项目
- App Store 中与购买账号关联的应用购买记录，可用于符合条件的重新下载。购买恢复不代表订阅、服务器记录或本地配置会同时恢复，这些数据需要另行确认。iPhone 与 iPad 的购买适用范围及其他设备兼容性以 App Store 页面标注为准。