官方手册 概念速查

Shadowrocket
界面与规则术语

按所在界面和使用场景查词，区分连接模式、匹配条件与处理策略。

英文名称保留应用与配置中的原写法。每个术语都可通过标题旁的链接定位；需要连续操作步骤时，转到教程，需要核对购买记录时，查看App Store 指南。

界面与开关

连接方式与操作入口

先认清当前模式，再判断配置是否生效。连接开关开启，只说明系统已开始处理相应流量，不能单独证明目标网站或服务器可达。

Global Routing

整体流量处理模式的选择入口，三种姿态为配置 Config、代理 Proxy、直连 Direct。需要按域名或 IP 规则分流时，应选择 Config 并检查当前配置；切换模式本身不会补齐服务器认证参数，也不会修复远端连接错误。

Config

这个名称有两种常见语境：配置管理入口，以及 Global Routing 中按配置处理流量的模式。进入配置管理可以查看或编辑文件，而选择 Config 模式才是要求流量按当前配置执行；只保存文件但未选用正确配置，结果可能与预期不同。

Proxy / Direct

它们是 Global Routing 中的模式名称，分别对应代理与直连，用于改变整体处理方式。排查规则是否影响结果时，可以在明确目的后临时切换并重新发起请求；测试结束应恢复所需模式，不要把界面模式与规则中的大写策略关键字混用。

On Demand

按已设置条件由系统触发连接的机制，适合需要根据网络环境管理连接的情况。它依赖系统 VPN 配置及相关条件，不是对服务器可用性的保证；手动断开后若连接又被触发，应先检查 On Demand 设置，再判断是否存在异常。

Add Server

手动填写用户已有服务器信息的入口，先选择协议类型，再核对地址、端口和认证字段。不同协议的表单不能直接互换，同样名为密码或用户标识的字段也应按原配置填写；保存成功只表示条目已建立，仍需实际连接验证。

Connectivity Test

用于辅助检查可达性的测试入口，结果需要结合所选测试方式理解。显示的耗时通常反映某类探测的往返或请求过程，不等同于下载速度，也不能覆盖所有目标网站；遇到超时，应继续检查网络、服务器参数与具体请求结果。

协议

协议类型与连接参数

协议决定双方如何建立连接；传输方式与安全层则可能是另外的设置。以下解释均以用户已有自己的订阅或服务器信息为前提，填写时以对应配置为依据。

Shadowsocks

一种代理协议，常见参数包括服务器地址、端口、加密方式和密码。加密方式必须与服务器一致，不能为了尝试连接而随意更换；从已有信息手动填写时，还应确认是否有额外传输参数，避免只复制地址与密码而遗漏其他要求。

VMess

使用用户标识等参数建立连接的代理协议，可与不同传输方式配合使用。排查时应把协议身份参数、传输路径与安全层设置分开核对；即便地址和用户标识相同，传输方式或路径不匹配仍可能导致连接失败。

VLESS

一种代理协议，用户标识、传输方式及安全层参数需要与服务器端一致。仅看到 VLESS 名称不能推断连接使用了哪种安全层；手动转填时应逐项对照已有配置，而不是将其他协议的字段照搬到当前条目中。

Trojan

通常结合 TLS 使用的代理协议，连接时需要同时核对认证密码和证书相关设置。服务器地址与用于证书验证的名称可能承担不同作用，不能简单视为同一字段；出现证书错误时应核对名称和设备时间，保留正常的证书验证。

Hysteria2

基于 QUIC 的代理协议，使用 UDP 传输，实际表现受网络路径、拥塞和服务器设置共同影响。填写时关注 password、sni、obfs 等原配置字段；如果路径限制了 UDP，单纯修改规则通常不能解决握手问题。

WireGuard

使用公私钥与隧道地址建立连接的 VPN 协议，常见字段包括 PrivateKey、PublicKey、Address 和 AllowedIPs。私钥属于敏感信息，不能用于公开求助截图；MTU 与地址范围应按实际配置理解，不宜直接套用他人的数值。

HTTP / SOCKS5

两种不同的代理协议类型，服务器支持哪一种，就应选择对应类型并核对认证要求。目标网站使用 HTTPS，不代表代理类型必然应选 HTTP；协议名称也不能单独说明客户端到代理服务器之间是否具有加密保护，需继续检查相关传输设置。

规则关键字

匹配对象与处理策略

一条规则通常先写匹配方式，再写匹配内容，最后指定策略。先问“匹配了什么”，再问“匹配后怎样处理”，比只看某个关键字更容易定位问题。

DOMAIN

匹配一个指定的完整域名，例如 DOMAIN,example.com,DIRECT 针对的是该域名本身。它不会自动覆盖所有子域名，也不是 URL 路径匹配；需要将同一域名下的不同路径分别处理时，不能仅靠更改这条规则中的域名实现。

DOMAIN-SUFFIX

按域名后缀匹配，通常覆盖所写域名本身及其子域名，例如 DOMAIN-SUFFIX,example.com,PROXY。填写匹配内容时只写域名部分，不写协议头或页面路径；若某个子域名需要例外处理，应把更具体的规则放在这条规则之前。

DOMAIN-KEYWORD

按域名中包含的字符串匹配，适合确实需要覆盖多个相关域名的情况。关键词太短会把无关域名也纳入范围，因此它不应被当成 DOMAIN-SUFFIX 的简单替代；出现意外命中时，应先检查关键词是否过于宽泛。

GEOIP

按照目标 IP 在地理数据库中的归类匹配，例如 GEOIP,CN,DIRECT。数据库归类不等于网站显示语言、经营主体所在地或用户所在位置；同一域名也可能解析到不同地址，因此分析规则结果时要同时查看实际目标 IP。

IP-CIDR / IP-CIDR6

分别用于匹配 IPv4 与 IPv6 地址范围，斜杠后的数字表示网络前缀长度。比如 192.168.0.0/16 表示一个 IPv4 网段，而不是一个主机地址；只设置 IPv4 规则不代表 IPv6 访问会自动按相同条件命中。

FINAL

前面的规则均未命中时使用的最终处理规则，通常放在规则列表末尾。FINAL,DIRECT 与 FINAL,PROXY 的兜底方向不同，应根据实际需求选择；排查某个目标为何直连或代理时，也要确认它是否最终落到了这里。

PROXY / DIRECT / REJECT

规则中的内置策略关键字，分别表示代理处理、直接连接与拒绝请求。它们写在规则的策略位置，不能替代域名或地址条件；PROXY 仍依赖实际可用的代理选择，DIRECT 则不代表请求会绕过设备所处的本地网络。

规则顺序

规则通常按从上到下的顺序匹配，应把更具体的例外放在较宽泛的条件前面，再以 FINAL 兜底。两条规则覆盖同一目标时，后面的规则可能没有机会生效；调整后需保存、确认当前配置，并用新请求复测。

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

需要逐行说明时，查看DOMAIN-SUFFIX 规则写法示例。

订阅与配置

导入内容与配置范围

服务器条目描述如何连接，订阅用于批量更新条目，配置文件则组织规则与通用设置。导入之前先识别内容类型，避免把不同入口当成同一种操作。

Subscribe

用于导入用户已有订阅地址的类型，通过远端内容获取或更新服务器条目。订阅地址可能包含身份凭据，应当按敏感信息保存；更新成功表示内容已获取并解析，不代表其中每个服务器都能连接，也不代表完整规则配置已随之切换。

服务器条目

客户端中保存的一组连接参数，通常包含协议、地址、端口及相应认证信息，也常被称为节点。显示名称主要用于辨认，并不能证明实际位置或性能；更换条目后，已有连接可能需要重新建立，验证时应发起新的请求。

Config 配置文件

用于组织通用设置、规则和策略等内容的文本配置，可能包含 [General]、[Rule] 等段落。它与服务器订阅不是同一类内容；修改前宜保留当前可用副本，导入后应确认选用的是目标文件，再检查规则及相关设置。

DNS / DoH

DNS 负责把域名解析为 IP 地址，DoH 则通过 HTTPS 承载 DNS 查询。域名能够解析不等于后续连接一定成功，更换解析方式也不等于更换出口；排查时应分别确认解析结果、规则命中和目标连接，避免一次修改多项设置。

Scan QR Code

从二维码中读取连接信息的入口，识别结果可能是单个服务器信息，也可能是订阅地址。二维码只是数据载体，不会自动证明内容正确；保存前应核对协议类型、地址及其他参数，遇到无法识别的格式时可回到已有原始配置逐项检查。

按操作顺序继续阅读：导入已有配置、选择 Global Routing 并验证连接。

App Store 与购买

正版核对与购买记录

Shadowrocket 是 Apple 平台付费客户端，以 iPhone 与 iPad 为主；Mac、Apple TV 与 Apple Vision 的兼容性及系统要求以 App Store 页面标注为准。

App Store 产品页

Shadowrocket 的唯一获取入口，也是核对价格、兼容性和购买适用范围的位置。辨认时应同时检查官方图标、开发者 Shadow Launch Technology Limited 与应用 ID；只看名称或搜索结果排序不足以完成核对，具体步骤见正版核对说明。

应用 ID

App Store 产品链接中的应用标识，Shadowrocket 对应 932747118，链接中表现为 id932747118。它用于区分具体应用，不是账号编号，也不是购买凭证；即使不同店面显示的语言或货币不同，仍应核对这一应用标识。

一次性买断

指客户端的购买方式，美区定价约为 2.99 美元，实际价格以 App Store 页面为准，各店面按当地货币显示。客户端一次性买断 ≠ 线路套餐，连接仍需用户已有自己的订阅或服务器信息；购买应用与维护这些连接信息是两件不同的事。

已购项目

App Store 中查看购买记录并重新获取应用的入口，换机或重装时应先确认当前使用的商店账号及其购买记录。恢复应用不等于恢复客户端内的配置，服务器信息和规则应分别确认；家人共享的适用范围以商店页及账户设置为准。