官方手册 · 概念速查

Shadowrocket 术语表

按使用位置查找概念。先区分连接开关、路由姿态与规则策略,再核对订阅、协议和 DNS 参数。

  • 5 类概念
  • 30 个术语
  • 英文关键字原样保留

本页以用户已有自己的订阅或服务器信息为前提。Shadowrocket 是 Apple 平台的付费客户端,唯一获取入口是 App Store。客户端一次性买断 ≠ 线路套餐。购买客户端不会自动获得服务器信息。

连接与路由

界面与开关

连接是否建立、连接走哪条路径,是两个不同的问题。Global Routing 的选择不等同于顶部连接开关。

界面与开关

Home

Home 是查看服务器列表、选定服务器与控制连接的主要入口。导入成功只表示信息已写入列表,不表示已经连接;还需确认选中服务器并打开连接开关。首次连接时,系统可能要求允许添加 VPN 配置,授权后仍应进行实际连通性测试。

界面与开关

Global Routing

Global Routing 决定整体采用哪种路由姿态:配置、代理、直连,对应 Config、Proxy、Direct。Config 按当前配置分流,Proxy 使用代理路径,Direct 使用直连路径。排查规则未生效时,先确认这里选择了 Config,再检查当前配置文件与规则顺序。

界面与开关

Config

Config 在不同位置承担不同含义:作为页面名称时,是管理配置文件的入口;作为 Global Routing 选项时,表示按当前配置分流。保存一份文件与将其设为当前配置不是同一件事。修改后应确认实际使用的文件,而不是只看文件列表中是否存在它。

界面与开关

Proxy

Proxy 是 Global Routing 的代理姿态,通常让受客户端接管的连接使用代理路径。它与规则行末尾的大写 PROXY 不是同一层设置:前者决定整体路由方式,后者是规则命中后的策略。需要验证分流效果时,应回到 Config 姿态进行检查。

界面与开关

Direct

Direct 是 Global Routing 的直连姿态,让受客户端接管的连接采用直连路径。选择 Direct 不表示系统 VPN 配置已经关闭,也不等于删除服务器。测试结束后应恢复原来的路由姿态,避免把整体直连误认为某一条规则失效。

界面与开关

On Demand

On Demand 根据网络或域名等条件触发连接行为,用于决定何时连接。它与连接建立后决定流量去向的分流规则属于不同层次。出现手动断开后再次连接的情况时,应检查按需条件是否仍被满足,再逐项测试触发范围,避免同时修改多种条件。

连接参数

协议

协议名用于确定客户端与服务器如何通信。按已有服务器信息选择类型,不能仅凭名称判断速度,也不能用更换协议名称代替参数核对。

协议

Shadowsocks

Shadowsocks 是一种加密代理协议,常见参数包含服务器地址、端口、加密方法与密码。客户端的加密方法必须与服务端匹配,不能随意选择名称相近的选项。导入后若连接失败,应先核对参数是否完整,再检查服务器可达性与当前网络。

协议

VMess

VMess 是一种代理协议,身份信息与传输设置共同决定连接能否建立。UUID、传输方式、路径、Host 和 TLS 等字段是否需要填写,取决于已有服务器的实际配置。不能仅核对地址与端口;还应留意设备时间是否准确,以及导入内容是否遗漏传输参数。

协议

VLESS

VLESS 是一种代理协议,通常需要与匹配的传输及安全层设置配合使用。协议类型相同,不代表两组服务器参数可以互换。填写时应整体核对身份信息、传输方式与安全选项,不要把其他协议的字段值直接套入;导入格式也应与实际内容一致。

协议

Trojan

Trojan 通常基于 TLS 建立连接,认证信息、服务器名称与证书相关设置需要相互匹配。连接地址与 TLS 验证使用的名称可能不同,应以已有服务器参数为准。遇到证书错误时先核对名称、设备时间和服务端证书状态,不应把跳过验证作为常规处理方式。

协议

Hysteria2

Hysteria2 是基于 QUIC 的代理协议,其运行条件涉及 UDP 可用性、认证信息与安全层设置。某个网络中的测试成功,不代表换到另一个网络后仍能使用相同路径。排查时应把网络对 UDP 的支持与服务器参数分开检查,带宽相关选项也应依据实际条件设置。

协议

WireGuard

WireGuard 使用密钥对建立隧道,常见参数包括本地地址、对端公钥、Endpoint 与 Allowed IPs。它不是只填写服务器地址和密码的配置方式,缺少路由或地址参数也可能导致无法访问。私钥属于敏感信息,备份与排查截图中都应妥善保护。

匹配条件与执行策略

规则关键字

规则通常按从上到下的顺序匹配,命中后使用对应策略。先写匹配条件,再写策略;范围更具体的规则通常应放在范围更宽的规则之前。

规则关键字

DOMAIN

DOMAIN 精确匹配指定域名,例如 DOMAIN,example.com,DIRECT。这条规则不自动覆盖 www.example.com 等子域名。需要只调整某一个完整域名时,可以使用精确匹配,并把它放在可能提前命中的宽泛规则之前。

规则关键字

DOMAIN-SUFFIX

DOMAIN-SUFFIX 匹配指定域名及其子域名,例如 DOMAIN-SUFFIX,example.com,PROXY。它可以覆盖 example.com 与 www.example.com,但不是任意位置的字符串包含匹配。需要对同一域名范围统一分流时,应先确认更具体的例外规则排在前面。

规则关键字

DOMAIN-KEYWORD

DOMAIN-KEYWORD 按域名中包含的字符串匹配,覆盖范围通常比 DOMAIN 和 DOMAIN-SUFFIX 更宽。关键字可能同时命中原本不打算处理的域名。新增这类规则后,应查看实际请求的域名与命中结果;能用明确域名表达的需求,优先采用更准确的条件。

规则关键字

GEOIP

GEOIP 按目标 IP 的地理归属数据库结果匹配,例如 GEOIP,CN,DIRECT。数据库归属不等同于服务器的实时物理位置,也不能仅靠网站使用的语言判断命中结果。域名解析得到的 IP 与数据库记录都会影响检查结论,应结合实际连接信息分析。

规则关键字

IP-CIDR

IP-CIDR 用 CIDR 网段表示法匹配目标 IPv4 地址,例如 IP-CIDR,192.0.2.0/24,DIRECT。斜杠后的前缀长度决定地址范围,不是端口号。IPv6 网段使用 IP-CIDR6;添加前应核对目标地址属于哪种地址族,并确认网段没有覆盖过多目标。

规则关键字

FINAL

FINAL 指定前面的规则均未命中时采用的最终策略,例如 FINAL,PROXY。它通常放在规则列表末尾,不负责识别某个具体域名。某次连接落到 FINAL 时,应先检查前面的匹配条件是否覆盖实际目标,再决定是否需要新增规则。

规则关键字

PROXY · DIRECT · REJECT

PROXY、DIRECT、REJECT 是规则命中后的策略名称,分别表示代理、直连与拒绝。PROXY 实际使用的服务器还需结合当前选择及配置中的策略关系检查。它们是规则语法中的大写名称,不应与 Global Routing 中的 Proxy、Direct 界面选项混写。

信息导入与维护

订阅与配置

服务器集合、分流配置与客户端购买各有独立职责。本站不提供、不销售、不推荐节点或订阅,以下操作只针对用户已有的信息。

订阅与配置

Subscribe

Subscribe 用于导入与更新用户已有的服务器集合,订阅地址可能包含身份凭据。订阅不是客户端购买凭证,也不一定包含完整的分流规则。填写时应保留完整地址并避免多余空格;发送诊断信息时,应遮盖地址中的认证参数。

订阅与配置

服务器

服务器是客户端连接所需的一组服务端参数,通常包含协议、地址、端口与认证信息,中文说明中也可能称为节点。列表名称只是便于辨认的标签,不代表已验证可用。选中一项后,还需检查连接状态、路由方式与实际请求结果。

订阅与配置

Add Server

Add Server 是手动填写服务器信息的入口,应先选择与已有参数一致的协议类型。不同协议需要的字段不同,不能只填地址和端口就认为信息完整。保存前应逐项对照认证与传输设置;手动输入适合参数明确的情况,信息不完整时先核对原始记录。

订阅与配置

配置文件

配置文件组织分流规则及相关网络设置,解决的是连接应如何处理的问题。订阅通常提供服务器集合,解决的是可以连接到哪里的问题,两者不能简单互相替代。修改前先确认当前文件并留存备份,修改后再用目标请求验证实际命中结果。

订阅与配置

订阅更新

订阅更新会重新读取已有订阅地址,并刷新其中的服务器集合;它不是更新 Shadowrocket 本身。更新后服务器名称、参数或数量可能变化,本地手动修改也可能受影响。更新失败时,先检查地址完整性、当前网络与响应内容,不要立即删除原来的可用记录。

订阅与配置

备份

备份是在修改、删除或迁移前,保存可恢复的服务器与配置数据。恢复 App Store 中的已购应用,与恢复应用内的数据是两件事。备份可能包含订阅凭据、密码或密钥,应存放在可信位置,并确认保存内容确实覆盖当前使用的设置。

解析与诊断

DNS 与网络

域名能否解析、服务器能否连接、目标请求能否完成,需要分层判断。一次延迟测试不能替代完整的使用验证。

DNS 与网络

DNS

DNS 把域名解析为 IP 地址,是许多网络请求开始前的一步。解析使用的路径与后续业务连接采用的路径需要分别检查,修改分流规则不一定改变全部 DNS 行为。出现域名访问失败时,应先判断解析是否成功,再检查返回地址的连接情况。

DNS 与网络

DNS over HTTPS

DNS over HTTPS 通过 HTTPS 传输 DNS 查询,常用简称为 DoH。它保护的是到解析服务这一段的查询传输,不等于所有业务流量都改走同一路径。设置时需要完整且可访问的服务地址;发生异常时,应区分解析服务不可达与目标网站不可达。

DNS 与网络

延迟

延迟是特定测试方法在当时网络条件下测得的耗时,不直接等于下载速度、吞吐量或连接稳定性。不同测试方法的数值不宜直接比较,超时也需要结合测试目标分析。排序只能辅助选择服务器,最终应以实际请求能否稳定完成作为判断依据。

DNS 与网络

Connectivity Test

Connectivity Test 用于验证当前测试条件下的连通性。结果应结合选中的服务器、Global Routing、DNS 与测试目标一起理解,不能推出所有应用都必然可用。首次连接后先执行测试,再打开实际需要访问的目标;失败时逐层排查,避免一次更改多项参数。

DNS 与网络

URL Rewrite

URL Rewrite 根据匹配条件对请求 URL 执行重写处理,与决定连接走代理还是直连的分流规则不同。能否处理某次请求取决于协议、请求可见范围及相关设置,并非添加规则后就适用于全部流量。修改前应了解匹配范围,避免宽泛条件影响正常请求。

Shadowrocket 正版下载