Global Routing
决定整体流量处理方式的界面入口，常见三种姿态是配置、代理、直连，对应界面原文 Config、Proxy、Direct。它与单条规则里的策略处于不同层级，切换后可能改变当前配置规则是否参与处理。排查分流不符合预期时，先核对这里，再检查规则内容。
官方手册 · 术语参考
Shadowrocket 名词解释
先区分界面选项、匹配条件与执行策略，再查具体参数。本页保留英文原文，按使用位置解释常见术语；每个词条均可通过锚点单独定位。
Shadowrocket 是 Apple 平台付费客户端，唯一获取入口是 App Store。客户端一次性买断 ≠ 线路套餐；以下连接说明均以用户已有自己的订阅或服务器信息为前提。
01 / INTERFACE
界面与开关
这些名称描述操作入口或整体工作方式，不是可以直接粘贴进配置文件的语法。
Config
在 Global Routing 中，表示按当前启用的配置处理流量；在其他位置，也可能指配置文件相关入口。选择 Config 不代表所有请求都走代理，实际结果取决于命中的规则及其策略。核对时应一起检查当前配置、规则顺序和末尾的 FINAL。
Proxy
Global Routing 中用于整体采用代理路径的选项，具体适用范围还需结合应用设置核对。它可以辅助比较同一请求在不同处理方式下的表现，但不能修正服务器参数错误。不要将这个选项与规则中大写的 PROXY 混写。
Direct
Global Routing 中用于整体采用直接连接路径的选项。它与仅对命中请求生效的 DIRECT 规则策略不同，也不等同于关闭所有网络相关设置。比较连接结果时，应保持目标地址和本地网络一致，避免同时改变多个条件。
On Demand
根据配置的网络或访问条件触发连接行为，用于减少反复手动切换。Wi-Fi、Cellular 等是需要核对的界面条件名，不是独立的配置段落语法。设置后应分别切换到对应网络验证，并检查是否与预期的手动操作发生冲突。
Add Server
录入用户已有服务器信息的入口，通常需要选择类型并填写地址、端口与认证参数。选择协议后出现的字段可能不同，应逐项对照自己的服务器说明，而不是只填写地址。保存条目只是完成录入，仍需选择它并验证连接。
Connectivity Test
用于检查指定测试条件下的连通情况，结果会受到测试目标、当前网络和服务器状态影响。一次测试成功不代表所有应用都能正常访问，测试时间也不等于持续下载速度。排查时应把测试结果与实际请求、匹配规则及连接记录一起核对。
02 / PROTOCOLS
代理协议
协议决定两端如何通信；选择依据是已有服务器的真实配置，而不是协议名称本身。
Shadowsocks
一种代理协议，常见连接参数包括服务器地址、端口、密码和加密方法。加密方法必须与服务器端一致，不能在客户端随意更换后期待仍能连接。若已有信息还包含其他参数，应按原始说明核对，避免在复制时遗漏。
VMess
一种使用用户标识等参数进行认证的代理协议，连接还可能涉及传输方式与 TLS 设置。相同用户标识并不意味着传输参数可以通用，路径、服务器名称等字段也可能影响握手。导入后应对照原始信息检查，而不是仅确认协议类型。
VLESS
一种使用用户标识认证的代理协议，不应仅凭名称推断其传输层保护方式。实际连接需要同时核对传输设置、TLS 及服务器端要求，相关字段应来自用户已有的配置信息。不要把其他协议的参数直接套用到 VLESS 条目。
Trojan
一种通常结合 TLS 使用的代理协议，密码只是连接参数的一部分。端口、服务器名称与证书验证设置同样可能影响连接建立。遇到证书错误时，应先核对域名、证书和设备时间，不应把跳过验证作为默认处理方法。
Hysteria2
一种基于 QUIC 的代理协议，连接依赖相应的 UDP 通信条件。排查时除了地址与认证信息，还应检查 TLS 和本地网络的 UDP 可达性。同一条目在 Wi-Fi 与蜂窝网络下表现不同，可能与网络路径有关，不能单凭协议名称判断原因。
WireGuard
一种基于密钥对认证的隧道协议，配置涉及本端密钥、对端公钥、Endpoint 和地址等信息。公钥与私钥用途不同，不能互换填写，私钥应按敏感凭据保管。连接建立后还需核对路由与 DNS，握手成功并不代表所有目标都可达。
HTTP / SOCKS5
两类常见代理协议，虽然都可能使用地址、端口和账号密码，但通信方式不同。不能因为服务器地址相同就互换类型，UDP 支持和认证方式也需按具体设置核对。协议名称本身不构成对加密传输的保证，应确认连接是否另有相应保护。
03 / MATCH & POLICY
规则关键字与策略
规则前半部分描述匹配条件，后半部分指定执行策略；通常自上而下，先命中的条目生效。
DOMAIN
按完整域名匹配，例如 DOMAIN,example.com,PROXY。这条规则不会自动表示匹配所有子域名，www.example.com 需要另行考虑。只想处理一个明确主机名时，可优先使用这种范围较窄的条件。
DOMAIN-SUFFIX
按域名后缀匹配，例如 DOMAIN-SUFFIX,example.com,PROXY，通常覆盖该域名及其子域名。这里是域名层级意义上的后缀匹配，不是任意文字包含关系。若某个子域名需要单独处理，应将更具体的规则放在这条规则之前。
DOMAIN-KEYWORD
按域名中包含的关键字匹配，例如 DOMAIN-KEYWORD,example,PROXY。它的覆盖范围可能比预期宽，不同域名只要包含相应文字就可能命中。使用前应列出需要处理的目标，并检查能否改用更明确的 DOMAIN 或 DOMAIN-SUFFIX。
GEOIP
根据目标 IP 在地理数据库中的归属匹配，例如 GEOIP,CN,DIRECT。它不按页面显示的语种、账号地区或用户当前位置判断，结果还可能受到解析地址与数据库内容影响。需要精确处理某个域名时，不宜只依赖地理归属规则。
IP-CIDR / IP-CIDR6
分别用于匹配 IPv4 与 IPv6 地址范围，斜杠后的前缀长度决定范围大小。例如 IP-CIDR,192.168.0.0/16,DIRECT 描述一段 IPv4 私有地址范围。添加规则前应确认实际目标地址类型，IPv4 规则不能替代对应的 IPv6 判断。
USER-AGENT
根据请求中可识别的 User-Agent 信息进行匹配，而不是读取设备上所有应用的身份。它受流量类型、请求信息可见性以及实际处理方式限制，不能视为通用的应用识别功能。使用时应确认当前请求确实提供了可用于匹配的信息。
FINAL
前面的规则均未命中时使用的兜底规则，通常位于规则列表末尾。例如 FINAL,PROXY 表示把剩余请求交给 PROXY，而不是强制覆盖前面已经命中的条目。请求去向不符预期时，应先查前序规则，再修改 FINAL。
PROXY
规则中表示采用代理路径的策略关键字，实际连接还依赖当前选择的服务器或相关策略设置。规则命中 PROXY 只说明处理方向，并不能证明服务器认证、传输和目标访问都已成功。它与 Global Routing 中的 Proxy 选项应按所在位置区分。
DIRECT
规则中表示直接连接目标地址的策略关键字，例如 DOMAIN-SUFFIX,apple.com,DIRECT。直连请求仍依赖本地网络、DNS 与目标服务的正常工作，并不等于请求一定成功。它只描述匹配请求的处理方式，不代表整体 Global Routing 已切到 Direct。
REJECT
规则中表示拒绝匹配请求的策略关键字。条件过宽时，页面依赖的图片、登录接口或其他资源也可能被拒绝，表现为局部内容缺失。添加时应从明确的域名条件开始，出现异常后优先检查命中记录与规则顺序。
04 / CONFIGURATION
配置文件段落
段名界定参数用途；相同域名出现在不同段落里，影响的环节可能完全不同。
[General]
配置文件中集中放置通用参数的段落，例如 dns-server = system。通用参数的影响可能覆盖多类请求，不能将其当成只针对一个域名的规则。修改前应保存当前配置副本，并逐项验证，避免同时更改多个参数后难以回退。
DNS
将域名解析为 IP 地址的机制，与后续建立业务连接是不同环节。能解析出地址，不代表该地址可达；能建立代理连接，也不代表 DNS 设置必然正确。排查时应分别核对解析结果、DNS 查询路径和最终连接路径。
[Rule]
放置匹配规则及执行策略的段落，常见写法为 DOMAIN-SUFFIX,example.com,PROXY。规则通常自上而下处理，因此较具体的例外规则要放在较宽泛条件之前。修改后既要检查语法，也要确认启用的是包含这些规则的配置。
[Host]
声明域名与指定地址映射的段落，例如 localhost = 127.0.0.1。这种映射作用于地址解析，不等同于为该域名选择 PROXY 或 DIRECT。目标服务的地址可能发生变化，因此固定映射应有明确用途，并在不再需要时重新核对。
[URL Rewrite]
按匹配表达式处理请求 URL 的段落，匹配模式与替换目标需要成对核对。它与 [Rule] 里选择连接策略的域名规则不同，也不能仅凭存在这一段就认为任意加密请求都能被改写。编写时要检查转义、匹配范围和适用请求，避免产生重复跳转。
05 / SUBSCRIPTION & ACCOUNT
订阅与账号
应用购买记录、服务器访问凭据与订阅集合是不同对象，恢复和更新也应分别处理。
Subscribe
用于导入或更新用户已有服务器集合的订阅相关类型或入口，链接应从自己的服务商处获取。更新订阅是重新获取集合内容，可能改变条目的地址、名称或数量，不等同于更新 Shadowrocket 应用。订阅链接可能包含认证信息，不应公开展示或随意转发。
服务器信息
建立连接所需的地址、端口、协议及认证参数等信息，单个条目也常被称为节点。它与包含多个条目的订阅集合不同，单条录入成功也不代表已建立订阅更新关系。分享排查信息时应隐藏密码、私钥和其他认证内容，仅保留必要的错误说明。
延迟
特定测试条件下等待响应所需的时间，含义取决于测试方式和目标。延迟不等于带宽，较低数值也不能单独证明持续传输更快或更稳定。比较多个条目时，应尽量使用相同网络和测试方法，并结合真实使用结果判断。
Apple ID
用于核对 App Store 购买记录与重新获取应用的账号身份，购买时应确认当前商店登录账号。它与用户已有连接服务的账号属于不同体系，应用购买成功不会自动填入服务器信息。系统要求、兼容范围及通用购买适用性均以 App Store 页面标注为准。
已购项目
App Store 中查找原账号购买记录与重新获取应用的入口，具体入口名称以当前系统显示为准。换机或重装时应先核对原购买账号和商店状态，而不是直接重复购买。恢复应用与恢复订阅、服务器条目及 Config 是不同操作，后者还需从自己的备份或原始信息恢复。