Home
Home 是查看服务器条目和操作连接开关的入口。列表中出现条目，只说明参数已被保存，不表示认证已经成功或连接正在运行。导入后应先检查选中的条目，再确认 Global Routing，最后开启连接并验证实际请求。
OFFICIAL GUIDE · TERMS
Shadowrocket 术语手册
按界面名称查含义，按规则关键字查匹配边界。本页保留英文原文，说明各术语之间的区别；具体按钮位置与可用字段以当前设备上的 Shadowrocket 为准。
30 个术语
5 类查阅路径
规则与参数说明
设备获取分两档：iPhone / iPad 版 App Store $2.99 一次性付费，Mac / Windows / 安卓 / Linux 版免费。Mac 包含 Apple 芯片版与 Intel 版；获取入口及安装说明见全平台下载，电脑与安卓安装包使用本站 /dl/ 路径。
INTERFACE / 01
界面与开关
先区分“选择了哪条服务器”“采用哪种路由模式”和“是否建立连接”。这三件事分别影响连接目标、请求去向与当前状态，不能相互替代。
Global Routing
Global Routing 决定请求采用哪种总体处理方式：配置对应 Config，代理对应 Proxy，直连对应 Direct。Config 依据当前配置分流，Proxy 将请求交给代理路径，Direct 使用直接连接。排查规则不生效时，应先确认当前是否处于 Config，而不是立即改写规则。
Config
Config 既是配置管理入口，也会作为 Global Routing 的一种模式名称出现。配置文件可包含规则、DNS 等设置，但服务器列表和配置文件并不是同一份数据。导入了一份配置，不代表它已经成为当前使用的配置；修改前应记录当前选项并保留备份。
On Demand
On Demand 用于让系统在满足设定条件时触发 VPN 连接。它控制连接何时发生，不负责修正密码、服务器地址或规则内容。启用前先验证手动连接可用；若手动关闭后又出现连接，应检查已有的 On Demand 条件，而不是仅重复操作总开关。
Add Server
Add Server 是手动录入已有服务器信息的入口。先选协议类型，再填写地址、端口与对应认证字段；TLS、传输方式等附加选项必须与服务器端一致。不同协议需要的字段不同，不应把其他类型条目的整套参数直接照填。
Connectivity Test
Connectivity Test 检查指定测试条件下的可达性，结果受测试目标、本地网络和服务器状态共同影响。测试成功不等于所有网站或应用都能访问，数值较小也不等于下载速度一定更高。比较结果时应保持测试方式与网络环境一致。
PROTOCOLS / 02
协议
协议名称说明双方如何通信，不是速度排名。实际可用性取决于服务器端配置、本地网络与传输条件；填写时应以已有服务器参数为准。
Shadowsocks
Shadowsocks 是一种加密代理协议，常见参数包括服务器地址、端口、加密方法和密码。加密方法必须与服务器端一致，密码正确但方法不一致仍可能连接失败。若已有条目还有其他传输选项，应一并核对，不能仅保留地址与密码。
VMess
VMess 是一种代理协议，认证标识与传输设置共同决定连接是否成立。UUID、传输方式、路径以及 TLS 等字段属于不同层次，某一项相同不代表整个条目相同。导入后应逐项对照已有信息，认证异常时也可检查设备时间是否准确。
VLESS
VLESS 是一种代理协议，其认证机制与底层传输安全需要分别理解。不能因为选择了 VLESS，就假定 TLS 或其他安全设置已经自动匹配。UUID、服务器名称和传输相关字段应按服务器实际配置填写，不应从其他条目中拼接参数。
Trojan
Trojan 通常结合 TLS 使用，密码认证和 TLS 握手是不同的检查环节。地址、端口、密码以及服务器名称都应与已有配置相符。出现证书或名称相关错误时，先核对域名和设备时间，不应把跳过证书验证当作常规修复方式。
Hysteria2
Hysteria2 基于 QUIC，依赖底层 UDP 通信条件。它在部分高丢包链路上有适用性，但当网络限制 UDP 或路径不稳定时，也可能无法建立连接。协议名称本身不构成速度保证，测试时应同时观察网络切换前后的可达性与实际业务表现。
WireGuard
WireGuard 是基于密钥认证的隧道协议，端点、接口地址、对端公钥及路由范围需要配套设置。私钥属于敏感信息，不应出现在公开截图、日志或分享内容中。隧道成功建立也不代表所有目标都能到达，还需检查路由范围和 DNS 设置。
HTTP / SOCKS5
HTTP 与 SOCKS5 是两种不同的代理协议类型，所需认证方式和可用能力取决于服务器实现。协议名称本身不意味着连接具有相同的加密保护，HTTP 代理也不能仅凭名称当作 HTTPS 连接。应准确选择服务器实际提供的类型，并单独核对安全设置。
需要了解传输条件时，可继续阅读Hysteria2 与 QUIC 的适用场景。
RULE KEYWORDS / 03
规则关键字
一条规则通常包含匹配类型、匹配内容与处理策略。规则先后顺序会影响结果；以下解释帮助阅读语法，不代表需要把所有示例加入当前配置。
Rule
Rule 描述“满足什么条件时，采用什么处理方式”。在按顺序检查的规则列表中，前面的有效匹配通常先决定去向，因此更具体的规则应注意放置位置。新增规则后应验证实际命中结果，不能仅凭文件中存在该行就认定它已经生效。
DOMAIN-SUFFIX
DOMAIN-SUFFIX 按域名后缀匹配，例如 example.com 可覆盖该域名及其子域名。它匹配的是域名，不是 URL 的路径或查询参数。使用时应确认覆盖范围，避免一条宽泛的后缀规则抢先匹配本来需要单独处理的子域名。
DOMAIN / DOMAIN-KEYWORD
DOMAIN 用于完整域名匹配，DOMAIN-KEYWORD 则检查域名中是否包含指定关键词。后者覆盖范围更宽，可能命中名称相似但用途不同的域名。只需要处理单个主机时，优先理解完整匹配的边界，不要把关键词规则当作后缀规则使用。
GEOIP
GEOIP 根据 IP 地理数据库判断地址归属，例如 GEOIP,CN,DIRECT 表示将匹配的地址交给 DIRECT。数据库结果不等同于公司注册地或当前用户的实际位置。域名解析结果与数据库内容都会影响判断，出现偏差时应检查实际目标 IP。
IP-CIDR / IP-CIDR6
IP-CIDR 用于 IPv4 地址段，IP-CIDR6 用于 IPv6 地址段，斜杠后的数字表示网络前缀长度。它们依据 IP 范围匹配，不依据域名文字匹配。同一服务可能返回多个地址，或同时使用 IPv4 与 IPv6，因此单一地址段未必覆盖全部连接。
FINAL
FINAL 为前面规则均未命中的请求提供兜底处理，通常放在规则末尾。它决定剩余请求的去向，而不是对某个特定域名进行匹配。修改 FINAL 前应检查已有策略是否可用，并理解未覆盖请求的范围，避免只验证少数网站后就结束检查。
PROXY / DIRECT / REJECT
这些大写词是规则中的处理策略：PROXY 交给代理路径，DIRECT 直接连接，REJECT 拒绝请求。它们与 Global Routing 中的界面词 Proxy、Direct 处于不同层次。DIRECT 也不等于请求完全不经过客户端处理，仍需结合当前配置理解解析和路由行为。
USER-AGENT
USER-AGENT 按可识别请求中的 User-Agent 信息匹配。该信息并不在所有连接中可见，也不能可靠地代替应用身份；同一应用还可能产生多种请求。加密请求的可见范围会受到处理条件影响，不应假定添加该规则后就能识别全部应用流量。
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXYSUBSCRIPTION & CONFIGURATION / 04
订阅与配置
订阅用于管理已有服务器条目，配置用于组织规则与相关行为。两者可能一同使用，但导入、更新与备份时应分别确认对象。
Subscribe
Subscribe 通过用户已有的订阅地址批量导入或更新服务器条目。更新可能改变名称、参数或条目数量，不应把本地手动改动视为始终保留。订阅地址可能包含访问凭据，应按敏感信息保存；更新失败时先检查地址完整性与当前网络。
SERVER
SERVER 通常指服务器地址字段或相关条目标识，可能填写域名或 IP 地址。一个可用服务器条目还需要协议、端口与认证等信息，单有地址并不足以连接。显示名称只是方便辨认的标签，不能依据名称判断服务器真实位置或连接质量。
Scan QR Code
Scan QR Code 读取二维码中编码的导入内容，二维码本身不是一种代理协议。识别后应核对内容究竟是单个服务器参数、订阅地址还是其他文本，再确认保存。包含密码或订阅凭据的二维码不适合公开展示，导入成功也仍需进行连接验证。
DNS
DNS 将域名解析为 IP 地址，是连接建立前的重要环节。解析请求采用的路径与后续业务连接采用的路径需要分别理解，改变 DNS 不会自动修正全部分流问题。遇到域名无法访问时，应区分解析失败、地址不可达和服务器认证失败。
URL Rewrite
URL Rewrite 按指定条件处理 URL 请求，与把请求分配到 PROXY 或 DIRECT 的路由规则不同。是否能够处理某个请求取决于规则、请求类型和相关前提。修改前应保留原配置，并仅在明确理解匹配范围时启用，避免影响正常业务请求。
延迟
延迟描述特定测试条件下的等待时间，不等同于带宽或持续下载速度。测试目标、网络拥塞与协议握手都会影响结果，因此不同测试方式的数值不适合直接横向比较。选择条目时应结合稳定性、实际应用表现和多次测试，而不是只看一次排序。
IPAD & APP STORE / 05
iPad 与 App Store 账号
购买记录、应用安装和配置数据属于不同对象。在 iPad 上重新获取应用后，仍应单独确认原有服务器信息与配置是否已经恢复。
Apple ID
Apple ID 是 App Store 购买记录关联的账号，查看已购记录时应核对“媒体与购买项目”所使用的账号。该账号与设备上的 iCloud 登录状态应分别检查，不能仅凭 iCloud 已登录就判断购买归属。商店地区也会影响条目是否可以搜索和获取。
已购项目
已购项目用于查找原购买账号取得的应用；在同一购买账号下，可在 iPhone 和 iPad 上查找 Shadowrocket 并重新下载。应用的购买记录不等于服务器数据备份，重新下载后应检查配置是否还在。若出现再次购买提示，应先核对账号与具体应用条目。
iCloud 同步
iCloud 同步涉及应用实际支持的同步项目、账号和系统开关，不应理解为所有本地设置都会自动复制。它与 App Store 的购买记录恢复不是同一过程，恢复应用并不证明配置已同步完成。换机前应核对可同步内容，并额外保存需要保留的配置备份。
需要核对条目时，可查看Shadowrocket App Store 产品页；账号地区、已购恢复与各平台获取方式统一见下载页说明。
本页是 Shadowrocket 官方手册的术语索引。遇到实际连接问题时，建议记录当前模式、选中条目与错误信息，再到疑难解答逐项排查；分享排查材料前先移除密码、私钥和完整订阅地址。