OFFICIAL MANUAL / GLOSSARY

Shadowrocket 术语手册

按界面位置与配置用途查词。先区分连接开关、路由姿态和规则策略，再对照用户已有的服务器信息核对参数。

31 个术语条目
界面词保留英文原文
规则示例使用 example.com

01 / INTERFACE

界面与开关

先确认正在操作哪个页面。连接是否开启、请求采用哪条路径、是否按条件自动连接，是三个不同的问题。

Home: 在 Home 查看服务器条目，选择用户已有的服务器后，再操作连接开关。开关开启说明客户端开始建立或维持连接，不等于所有目标请求都已成功。首次使用时应先检查条目参数，再进行连接与访问验证。

Global Routing: 在 Home 打开 Global Routing，选择 Config、Proxy 或 Direct，以确定整体流量处理方式。这个选项影响请求如何进入规则或代理路径，并不修改服务器的地址与密码。排查访问差异时，应记录当前姿态，避免把切换姿态后的结果误认为服务器参数发生变化。

Config / Proxy / Direct: 在 Global Routing 中，配置对应 Config，代理对应 Proxy，直连对应 Direct。Config 按当前配置中的规则处理请求；Proxy 使用所选代理路径；Direct 直接连接目标。选择 Config 前要确认已启用所需配置，选择 Proxy 也仍然需要可用的服务器信息。

On Demand: 在相关设置中配置 On Demand 后，系统可以根据指定网络条件触发连接行为。它解决的是何时连接，不是某个域名应采用哪项策略。若连接关闭后又被触发，应先核对 On Demand 条件，再判断是否存在连接异常。

Data: 在 Data 查看客户端记录的流量统计，用来观察连接后的数据活动。统计范围、起算时间和重置行为应结合当前页面显示理解。服务商侧的计费口径可能不同，因此这里的数字不应直接当作账户剩余用量。

Settings: 在 Settings 查找客户端行为相关的设置项，具体名称与可用选项以当前应用界面为准。修改前记录原值，每次只调整一个相关选项，并在同一网络下重新验证。不要仅凭名称相似就把全局设置与单个服务器的参数视为同一项。

02 / PROTOCOLS

协议

在 Add Server 选择与用户已有参数一致的协议类型。协议名决定字段含义，不能只复制 Address 与 Port 后任意切换类型。

Shadowsocks: 在 Add Server 选择 Shadowsocks，再按已有资料填写地址、端口、加密方法与密码。双方必须使用相匹配的参数，密码正确但加密方法不同也会影响连接。它是代理协议名称，不是某一个固定服务器或配置文件的名称。

VMess: 在 VMess 条目中核对服务器地址、端口、用户标识及传输相关字段。用户标识与传输设置需要和服务端一致，启用 TLS 时还要检查相应名称与证书信息。导入成功仅代表条目被识别，不能替代实际连接测试。

VLESS: 在 VLESS 条目中按已有资料填写用户标识及传输参数，不要套用其他协议的认证字段。VLESS 本身不承担完整的传输加密，连接安全还取决于所选传输与 TLS 等设置。遇到握手失败时，应将认证信息和传输信息分开核对。

Trojan: 在 Trojan 条目中填写地址、端口与密码，并核对 TLS 相关参数。Trojan 依托 TLS 传输，SNI 与证书名称不匹配可能使连接在握手阶段失败。出现证书错误时应先检查名称、设备时间和证书状态，而不是直接跳过校验。

Hysteria2: 在协议类型中选择 Hysteria2，再填写已有的认证与 TLS 参数。它基于 QUIC，底层依赖 UDP，因此当前网络能访问普通网页，并不能证明这条连接路径一定可用。排查时先核对协议类型与参数，再比较不同网络下的表现。

WireGuard: 在 WireGuard 配置中核对本地私钥、Peer 公钥、端点与地址范围等信息。私钥与对端公钥用途不同，不能互相交换填写；Allowed IPs 也不是一个域名列表。私钥属于敏感信息，分享排查材料时应移除，不能放进公开截图或笔记。

HTTP / SOCKS5: 在 Add Server 按已有服务的实际类型选择 HTTP 或 SOCKS5，再核对认证方式。两者是不同的代理接入协议，是否有加密传输、是否支持 UDP，都要看具体配置与服务能力。不能因为地址和端口相同，就推断两种类型可以互换。

03 / RULE KEYWORDS

规则关键字

先读匹配条件，再读处理策略。以下片段仅展示语法，其中 PROXY 需要与实际配置中可用的策略引用一致。

规则: 在当前配置的规则部分查看匹配条件与策略，Global Routing 选择 Config 时才按该配置分流。规则通常从前向后检查，较宽泛的条件放在前面可能提前覆盖后续条目。调整规则后，应保存并确认正在使用修改后的配置，再用同一目标验证。

DOMAIN: 在规则中使用 DOMAIN,example.com,PROXY，表示按完整域名匹配后交给指定策略。这里匹配的是域名，不包含 URL 路径，也不会自动等同于所有子域名。需要覆盖子域名时，应核对 DOMAIN-SUFFIX 是否更符合目标范围。

DOMAIN-SUFFIX: 在规则中使用 DOMAIN-SUFFIX,example.com,PROXY，可匹配 example.com 及其子域名。它按域名后缀边界判断，不是随意搜索整段 URL。配置前应确认需要覆盖的域名范围，避免把路径或协议前缀写进匹配值。

DOMAIN-KEYWORD: 在规则中填写 DOMAIN-KEYWORD 与指定字符串，可匹配域名中包含该字符串的请求。它的范围比完整域名匹配更宽，可能命中名称相近但并非目标站点的域名。只想处理某个明确域名时，应优先考虑更精确的条件。

GEOIP: 在规则中使用 GEOIP,CN,DIRECT，表示依据 IP 地理数据库的归属记录决定策略。判断对象是目标 IP，不是网页语言，也不是访问者所在地。数据库记录可能与服务实际部署情况存在差异，异常时要结合解析结果与命中规则检查。

IP-CIDR / IP-CIDR6: 在规则中用 IP-CIDR 匹配 IPv4 地址范围，用 IP-CIDR6 匹配 IPv6 地址范围。CIDR 中斜杠后的数字表示网络前缀长度，并非端口。填写前应确认目标地址属于哪个范围，前缀写得过宽可能改变大量无关请求的路径。

FINAL: 在规则列表末尾查看 FINAL，例如 FINAL,PROXY 表示前面没有命中时使用相应策略。它是兜底处理，不是再次测试所有服务器，也不会自动挑选响应最快的条目。大量请求落入 FINAL 时，应先确认前面的规则是否覆盖了预期目标。

PROXY / DIRECT / REJECT: 在规则末尾读取策略标记：DIRECT 表示直接连接，REJECT 表示拒绝，PROXY 应结合当前配置中的引用关系确认。PROXY 不是服务器地址，也不是固定的一组连接参数。路由姿态 Proxy 与规则标记 PROXY 处于不同层级，不应只凭拼写相近就视为同一设置。

04 / SUBSCRIPTION & CONFIG

订阅与配置

以下操作均以用户已有自己的订阅或服务器信息为前提。本站提供官方手册，不提供、不销售、不推荐节点或订阅服务。

服务器 / Add Server: 在 Add Server 选择协议，再填写 Address、Port 以及该协议所需的认证参数。这里的服务器条目是一组连接信息，不等同于规则配置。只输入域名和端口通常不足以完成配置，缺少的字段应向用户自己的服务商核对。

Config: 在 Config 页面管理与启用配置文件，文件可包含规则、DNS 等设置。Global Routing 中的 Config 则表示按当前配置处理流量，两处同名但用途不同。切换配置前记录原先启用的文件，确认新文件中的策略引用能与现有服务器选择对应。

Scan QR Code: 在 Scan QR Code 入口识别用户已有二维码中的连接信息，必要时按系统提示允许相机访问。二维码是数据载体，内部可能是单个服务器链接，也可能是订阅地址，导入后的结果应逐项核对。包含认证内容的二维码同样属于敏感资料，不宜公开转发。

客户端一次性买断: 在 App Store 购买 Shadowrocket，获得的是客户端授权；客户端一次性买断 ≠ 线路套餐。购买不会自动生成服务器、订阅地址或认证参数，已有配置仍需自行导入。Shadowrocket 是闭源商业应用，系统要求、兼容性及通用购买适用情况以 App Store 页面标注为准；购买前可先查看正版核验说明。

05 / DNS & NETWORK

DNS 与网络

把域名解析、协议握手与目标访问分开检查。单次测试结果只能说明当时、当前测试方式下的表现。

DNS: 在当前配置的 DNS 相关设置中查看解析方式，DNS 的作用是把域名转换为 IP 地址。域名无法解析与代理服务器无法连接属于不同环节，应分别检查。解析结果也可能参与后续 IP 类规则判断，因此修改 DNS 后要同时观察解析与规则命中的变化。

DNS over HTTPS: 在支持的 DNS 设置中填写 DNS over HTTPS 服务地址，可通过 HTTPS 传送解析查询。它保护的是查询传输过程，不代表所有应用数据都改走同一条代理路径。解析服务本身仍需可达，出现超时应检查服务地址、连接路径和相关规则，而不是反复更换多个设置。

Connectivity Test / 延迟: 在 Connectivity Test 执行测试，结果反映当前测试方法下的响应情况。延迟数值不等同于下载速度，测试成功也不能证明每个域名、每种连接方式都可用。比较结果时应保持网络、测试方法与目标一致，并用实际需要访问的服务继续验证。

TLS / SNI: 在服务器的 TLS 相关字段中核对 SNI，SNI 用于握手时标识目标服务器名称。TLS 负责保护传输并通过证书验证对端身份，连接 Address 与证书名称不一定相同，但必须符合服务端实际部署。证书错误应优先核对名称、有效期与设备时间，不应把跳过校验当作常规解决方法。

MTU: 在相关协议设置中查看 MTU，它表示网络接口传输单个数据包的大小上限。某些路径中数值不合适可能导致分片或部分请求停滞，但网页打不开并不必然由 MTU 引起。调整前记录原值，先排除认证、DNS 与路由问题，再一次改变一个数值并复测。

需要按操作顺序阅读时，前往完整使用手册；需要核对购买入口时，前往App Store 正版核验。