OFFICIAL MANUAL / GLOSSARY

Shadowrocket 名词解释

按界面原文查含义，再核对当前设置。区分连接模式、协议参数和规则策略，避免把名称相近的选项当成同一项配置。

五类术语
英文原文对照
每条均可通过锚点定位

01 / INTERFACE

界面与开关

先确认所在页面与当前模式，再判断某个开关是否影响了连接。完整操作顺序见入门指南。

Home: 查看服务器条目、当前选择与连接开关的主要页面。导入成功只表示条目已经写入，不表示已经选中该条目或建立连接；验证前先核对实际选择，再查看开关状态。若页面存在多个分组，应确认选中的是准备测试的那一项。

Global Routing: 决定请求按哪种整体方式处理的全局选项，对应配置、代理、直连三种姿态，界面词分别为 Config、Proxy、Direct。排查规则似乎没有生效时，应先核对这里，而不是立即修改规则。改变模式会改变诊断前提，测试时需要记录当前选择。

Config / Proxy / Direct: 在 Global Routing 中，Config 表示按当前配置中的规则处理，Proxy 表示采用代理模式，Direct 表示采用直连模式。这里的 Config 是一种姿态，不是配置文件管理页本身；Proxy、Direct 也不能与规则中的大写策略词混为一谈。恢复日常使用前，应检查是否仍停留在临时测试模式。

On Demand: 根据系统条件触发 VPN 连接的按需机制，不是服务器测速或自动修复功能。手动断开后又出现连接时，先检查是否有仍在生效的按需条件，以及系统中的 VPN 配置状态。进行连接故障测试时，可先记录条件，暂时停用后比较结果。

Add Server: 手动填写已有服务器信息的入口，先选择协议类型，再填写相应字段。地址、端口、身份或密码、传输方式与 TLS 参数应逐项对应服务器资料，不能仅凭名称猜测。保存后还需返回 Home 核对选择，并实际验证连接。

Connectivity Test: 用于检查目标条目在当前网络下的连通情况，结果受测试目标、网络路径和测试方式影响。测试显示的延迟不是文件下载速度，也不能保证所有网站均可访问。出现异常时，先在相同网络与相同测试条件下复测，再结合实际访问与日志判断。

02 / PROTOCOLS

协议

协议名决定参数的解释方式。导入后应按用户已有的服务器资料核对，不把某个协议名称当作速度或稳定性的保证。

Shadowsocks: 使用约定的加密方法与认证参数传输代理流量的协议，客户端与服务器需要使用一致的配置。核对时至少检查地址、端口、密码与加密方法，不能只确认密码正确。若资料包含额外传输参数，也应按原值保留，避免导入后遗漏。

VMess / VLESS: 这是两种不同的代理协议，即使条目中都出现 UUID，也不能互换协议类型。需要同时核对身份字段、传输方式、Host、路径及 TLS 设置，具体字段取决于服务器的部署方式。VLESS 的名称本身不代表已启用传输加密，应另行确认 TLS 等设置。

Trojan: 借助 TLS 传输并使用密码认证的代理协议，认证与证书校验是两项不同检查。连接失败时，应分别核对密码、连接地址、端口及 SNI，而不是直接关闭证书校验。证书不匹配也可能由服务器名称填写错误或设备时间异常引起。

Hysteria2: 基于 QUIC 的代理协议，连接依赖当前网络的 UDP 可达性，也需要正确的认证与 TLS 参数。某个网络下持续超时时，应先比较另一种网络的结果，再判断是否为参数错误。协议类型相同并不表示不同服务器的认证、混淆或带宽相关设置可以通用。

WireGuard: 使用公钥体系建立加密隧道的协议，需要配套核对本端私钥、对端公钥、Endpoint 与地址及路由范围。仅有服务器地址通常不足以组成完整配置，路由范围错误也可能表现为部分请求不可达。私钥属于敏感信息，排查记录和截图中应遮盖。

HTTP / SOCKS5: 两类代理协议，地址、端口和可选的账户认证需要与服务器一致。协议名称本身不等于连接已经通过 TLS 加密，是否加密应核对具体传输设置。SOCKS5 的 UDP 使用还取决于服务器能力与客户端配置，不能用一次网页访问结果替代检查。

TLS / SNI: TLS 用于建立加密连接并验证对端身份，SNI 用于在握手时指明服务器名称。连接地址可能是 IP，而证书对应域名，此时应按服务器资料填写名称，不能机械复制地址。遇到校验错误时，先查名称、证书有效期与系统时间，再定位服务器端问题。

03 / RULE KEYWORDS

规则关键字

先读匹配条件，再读末尾策略。以下语法用于解释规则，不代表应直接替换用户的整份配置。

Rule: 规则依据域名、地址或其他请求特征选择处理策略，通常自上而下匹配，命中后按该条规则执行。前面的宽泛规则可能覆盖后面的具体规则，因此顺序与条件同样重要。开始修改前，先确认 Global Routing 为 Config，并保留当前文件副本。

DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD: DOMAIN 匹配完整域名，DOMAIN-SUFFIX 匹配域名本身及其子域名，DOMAIN-KEYWORD 匹配域名中包含的关键词。三者范围不同，关键词过短可能影响原本不打算处理的域名。需要处理单一主机时优先核对完整域名，需要覆盖一组子域名时再考虑后缀条件。

IP-CIDR / IP-CIDR6: 分别用于匹配 IPv4 与 IPv6 地址网段，斜杠后的前缀长度决定覆盖范围。前缀长度越小，覆盖的地址范围通常越大，填写错误可能把无关请求交给同一策略。域名解析结果变化时，地址规则的命中也可能变化，需要结合实际目标地址检查。

GEOIP: 依据 IP 地理数据库中的归类结果进行匹配，不是按用户当前所在位置判断。数据库记录、服务部署地点与域名用途不一定一致，因此不能把归类当成访问行为的绝对依据。遇到个别站点策略不符合预期时，可先核对目标 IP，再考虑更具体的域名规则。

FINAL: 前面的规则都未命中时使用的兜底规则，通常放在规则末尾。FINAL,PROXY 表示将这些未命中的请求交给 PROXY，不表示之前的请求都会经过代理。若大量请求意外落到 FINAL，应先检查上方规则是否覆盖了实际请求域名或地址。

PROXY / DIRECT / REJECT: 规则末尾常见的处理策略，分别表示交给代理策略、直接连接与拒绝连接。PROXY 的实际出口仍需结合当前服务器选择及配置核对，DIRECT 也不保证目标一定可达。这里的大写策略词属于规则语法，不是 Global Routing 中的 Proxy、Direct 界面选项。

URL Rewrite: 按匹配条件处理请求 URL 的配置能力，与更换服务器、修改 DNS 或普通域名分流不是同一件事。效果取决于请求是否可见、协议类型及相关设置，不能认为写入规则后所有 HTTPS 请求都会被处理。排查页面跳转异常时，应记录原规则，每次只停用一项比较结果。

读法示例：第一条按域名后缀匹配并使用 PROXY；第二条是其他请求的兜底策略。example.com 仅为示例域名，不是服务入口。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

04 / CONFIGURATION

订阅与配置

区分服务器条目与规则文件：更新了其中一项，不代表另一项也已经更新。订阅与二维码均只处理用户已有资料。

SERVER: 用于标识服务器信息的界面词，一个可用条目通常由协议、地址、端口与认证参数共同组成。条目显示的名称只是辨认标签，名称相同不表示参数或实际出口相同。发现连接异常时，应核对具体字段，而不是只更改显示名称。

Config: 在配置文件管理语境中，Config 指用于查看、导入和选择配置的页面；文件可包含 General、Rule 等内容。导入文件后要确认当前实际使用的文件，不能仅凭列表中出现文件名就认定已经生效。它与 Global Routing 中同名的 Config 模式有关联，但不是同一个操作入口。

Scan QR Code: 通过二维码读取已有服务器或配置资料的入口，二维码只是数据载体，不代表内容完整或来源可信。识别成功后应核对协议类型、地址和认证字段，确认内容是否符合预期再保存。包含凭据的二维码与原始链接一样需要妥善保存，不能公开展示。

05 / SYSTEM & STORE

系统与商店

系统授权、数据同步和购买记录各自独立。重新下载应用，不等于配置和服务器信息已恢复。

DNS: 将域名解析为 IP 地址的机制，是域名访问链路中的一环。若连通性测试有结果但网页域名无法访问，应核对解析设置与实际返回地址，同时比较当前网络的表现。dns-server = system 表示使用系统 DNS 设置，不代表每种网络下都会得到相同结果。

VPN 配置: Apple 系统允许 Shadowrocket 建立网络隧道的配置与授权，首次启用连接时可能出现系统确认提示。授权成功只解决系统允许建立连接的问题，并不证明服务器认证、DNS 或规则正确。开关无法启用时先检查系统 VPN 设置，再按排查手册定位后续环节。

iCloud 同步: 在账户及应用设置允许的范围内同步相关数据，具体可同步项目应以当前应用内说明为准。iCloud 数据与 App Store 的应用购买记录属于不同范围，不能用已购记录判断配置是否存在。换机前应核对同步状态并保留必要备份，恢复后再确认文件与服务器条目。

已购项目: App Store 中核对历史购买记录、重新下载应用的入口，账户页面的具体名称可能随系统界面变化。找不到 Shadowrocket 时，应先核对“媒体与购买项目”是否使用原购买账户，再检查商店地区与历史记录。完整核对顺序见已购恢复说明，重新下载后仍需确认配置数据。

一次性买断: 指购买 Shadowrocket 客户端的付费方式，应用为闭源商业应用，唯一获取入口是 App Store。客户端一次性买断 ≠ 线路套餐，实际连接仍需用户已有自己的订阅或服务器信息。价格、通用购买与家人共享的适用范围，以 App Store 页面标注为准。

App Store 兼容性: 商店产品页中用于核对支持设备与系统要求的栏目，购买前应展开阅读。Shadowrocket 以 iPhone 与 iPad 使用为主，Mac、Apple TV、Apple Vision 也在同一商店页的兼容性栏中，系统要求一律以 App Store 页面标注为准。核对正版时，同时确认官方图标、开发者 Shadow Launch Technology Limited 与应用 ID 932747118。

需要操作步骤时，按任务继续阅读；遇到故障时，先记录当前模式与报错原文。

导入与首次连接 → 按症状排查 → App Store 正版核对 →