官方手册 · 术语参考

Shadowrocket 术语表

按界面位置与配置用途查词,区分连接模式、协议参数和规则策略。

本页保留界面词、协议名与规则关键字的英文原文。先根据出现位置判断词义,再查看对应解释;例如界面中的 Proxy 与规则中的 PROXY 有关联,但作用层级不同。

界面与开关

这一类词出现在页面入口、连接设置和测试工具中。遇到相同词形时,先确认是在界面里选择模式,还是在配置文件中编辑规则。

界面与开关

Global Routing

控制整体流量处理方式,常见三种姿态是配置、代理、直连,对应界面词 Config、Proxy、Direct。Config 按配置规则分流,Proxy 将适用流量交给所选代理,Direct 使用直连。排查某条规则为什么没有生效时,先确认这里是否选择了 Config。

界面与开关

Config

既可以指管理配置文件的页面,也可以指 Global Routing 中按配置规则处理流量的模式。前者用于查看、导入和选择配置,后者决定连接是否按这些规则分流。仅导入一个配置文件,并不等于已经选中它或切换到了相应模式。

界面与开关

On Demand

根据设定条件触发 VPN 连接的按需连接功能,实际行为由启用状态和相关条件共同决定。它不负责提供服务器,也不替代分流规则。修改后应在实际使用的网络条件下验证,判断连接是否按预期建立。

界面与开关

Add Server

用于添加服务器信息的入口,需要选择协议,并填写对应的地址、端口和认证参数。已有服务器信息从你的服务商处获取,不能仅根据链接外观推断所有字段。保存记录只是完成参数录入,之后仍需选用该记录并验证连接。

界面与开关

Connectivity Test

用于检查连接可达性与响应时间,常被用于 Shadowrocket 延迟测试。数值受测试方式、测试目标及当前网络影响,不等同于持续传输速度。比较结果时应尽量保持测试条件一致,并以实际需要访问的服务能否正常使用作补充验证。

协议

协议决定客户端与服务器如何通信。下列说明用于理解字段含义,不代表不同协议可以互换;录入前应按已有服务器信息核对完整参数。

协议

Shadowsocks

采用指定加密方法与密码建立代理连接,服务器地址和端口用于定位远端端点。加密方法必须与服务器一致,名称相似也不能直接替换。认证失败时应逐项核对参数,避免同时修改多个字段而无法确定原因。

协议

VMess

使用用户标识等参数进行认证的代理协议,常见配置还包含传输方式与 TLS 选项。协议认证、传输设置和证书验证属于不同层次,填写正确的用户标识并不代表其他层次已配置正确。应保留服务商提供的字段对应关系。

协议

VLESS

使用用户标识进行认证,其协议名称本身不能说明完整连接的安全属性。实际连接还取决于传输方式、TLS 及服务器要求的其他参数。不要把另一种协议记录直接改名后使用,应按照目标服务器的完整说明重新核对。

协议

Trojan

通常使用 TLS 保护连接,并以密码进行认证。用于连接的地址、TLS 所需的域名以及证书是否有效,都可能影响连接结果。遇到证书错误时,应先核对域名、设备时间与服务端证书,不应把关闭验证当作默认处理步骤。

协议

HTTP / SOCKS5

这是两类不同的代理协议,部分服务器还要求用户名和密码。是否保护客户端到代理服务器之间的链路,需要查看具体连接配置,不能只凭协议名称判断。填写时应区分代理端点和最终访问目标,不要把网站地址当作服务器地址。

协议

WireGuard

通过公钥与私钥建立加密隧道,配置中通常涉及本地密钥、对端公钥、端点和地址参数。不同字段有明确归属,公钥与私钥不能互换。私钥属于敏感信息,排查时不要将完整配置或含密钥的截图公开发送。

协议

Hysteria2

基于 QUIC 的代理协议,连接情况与当前网络能否正常传递 UDP 流量有关。除地址和认证信息外,还需核对 TLS 参数及服务端协议代际。其他协议可连接而此协议失败时,不能据此直接断定密码错误,应同时检查网络条件。

规则关键字与策略

规则前半部分描述匹配条件,末尾指定处理策略。以下 example.com 与私有地址段仅用于解释语法;实际使用时应按自己的访问需求检查匹配范围与规则顺序。

规则关键字与策略

DOMAIN

精确匹配一个域名,不自动扩展到它的全部子域名。需要只处理某个具体主机名时,精确规则比宽泛匹配更容易控制范围。这里填写域名本身,不包含 URL 的协议前缀和路径。

DOMAIN,example.com,PROXY
规则关键字与策略

DOMAIN-SUFFIX

按域名后缀匹配,可覆盖指定域名及其子域名。示例同时适用于 example.com 和它的子域名,但不是按任意字符片段匹配。若某个子域名需要例外处理,应把更具体的规则放在前面。

DOMAIN-SUFFIX,example.com,PROXY
规则关键字与策略

DOMAIN-KEYWORD

检查域名中是否包含指定关键字,覆盖范围可能明显大于后缀匹配。过短或过于常见的关键字容易命中不相关域名。使用前应列出预期对象;若只需要一个域名及其子域名,优先考虑更明确的匹配条件。

DOMAIN-KEYWORD,example,PROXY
规则关键字与策略

GEOIP

根据 IP 地理归属数据库判断目标地址是否属于指定地区。这里描述的是数据库对目标 IP 的归类,不是访问者所在地,也不是网站运营主体的所在地。域名解析结果或数据库内容变化,都可能影响最终匹配。

GEOIP,CN,DIRECT
规则关键字与策略

IP-CIDR / IP-CIDR6

分别用于匹配 IPv4 与 IPv6 地址段,斜杠后的数字表示网络前缀长度,不是端口。示例中的 IPv4 规则覆盖一个私有地址段,IPv6 规则覆盖本机回环地址。地址段覆盖越广,越需要检查是否会影响其他目标。

IP-CIDR,192.168.0.0/16,DIRECT
IP-CIDR6,::1/128,DIRECT
规则关键字与策略

FINAL

为前面规则均未命中的流量指定最终策略,通常放在规则列表末尾。它不是对已有匹配结果的二次覆盖,而是未命中时的兜底。若提前放置,后面的具体规则可能失去匹配机会。

FINAL,PROXY
规则关键字与策略

PROXY

规则中的策略关键字,表示将匹配连接交给代理处理。具体使用哪个服务器,还需要结合当前选择及配置中的策略引用判断。它与 Global Routing 中的 Proxy 不是同一个设置:前者是一条规则的结果,后者是整体处理模式。

规则关键字与策略

DIRECT

表示匹配的目标连接直接发出,不通过该规则所指向的代理服务器。是否能成功访问,仍取决于本地网络、DNS 结果和目标服务状态。规则中的 DIRECT 只作用于匹配流量,不等同于把 Global Routing 切换为 Direct。

规则关键字与策略

REJECT

表示拒绝匹配的连接,适合处理明确不需要发出的请求。错误的匹配范围可能同时阻断登录、验证或内容加载所需的连接。增加此类规则前应保留原配置,并在修改后检查相关业务是否仍正常。

DOMAIN,example.com,REJECT

配置文件段落

方括号中的名称是配置段落标记,用于组织不同类型的内容。把规则写入错误段落,不会因为关键字正确就自动获得预期效果;编辑前应先保存一份可恢复的配置。

配置文件段落

[General]

用于容纳配置文件支持的通用选项,与逐条匹配请求的规则列表用途不同。字段名、取值和分隔方式都需要遵守对应语法。不能把界面里的任意开关名称直接写成字段,也不能默认所有选项都适用于当前配置。

配置文件段落

[Rule]

用于存放分流规则,通常自上而下匹配,由先命中的规则决定对应流量的策略。更具体的例外应放在宽泛条件之前,FINAL 通常放在末尾。排查时不仅要检查单行语法,也要检查它前面是否已有规则命中。

[Rule]
DOMAIN,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
配置文件段落

[Host]

用于定义静态域名映射,让指定名称按配置指向相应地址。它影响名称解析结果,不直接指定 PROXY、DIRECT 或 REJECT 策略。目标服务地址改变后,旧映射可能导致访问异常,因此不宜长期保留未经核对的固定地址。

配置文件段落

[URL Rewrite]

用于组织 URL 重写规则,其目标是处理匹配的 URL,而不是选择代理服务器。它与 [Rule] 中按域名或 IP 分流的规则不能相互替代。能否处理某个请求还取决于请求类型及相关设置,不应仅凭一条表达式推断所有流量都会被重写。

订阅与账号

订阅内容、服务器认证与 App Store 购买记录分别对应不同用途。Shadowrocket 仅在 Apple 平台发行,主要用于 iPhone 与 iPad,唯一获取入口是 App Store;系统要求以 App Store 页面标注为准。

订阅与账号

订阅 / Subscribe

指通过链接获取并更新一组记录的管理方式,具体返回内容可能是服务器列表,也可能是配置文件。订阅链接从你的服务商处获取,导入前应确认适用入口与内容类型。链接可能携带访问凭据,排查问题时应遮盖敏感部分。

订阅与账号

服务器 / SERVER

指客户端实际连接的远端端点及其参数记录,通常包含地址、端口、协议和认证信息。它不同于规则,也不同于决定请求去向的策略。服务器列表中的显示名称便于辨认,但名称本身不能证明协议参数或连通性正确。

订阅与账号

已购项目

App Store 中与购买时的 Apple 账户关联的应用记录,换机或重新安装时可据此查找 Shadowrocket。恢复应用获取资格,不等于恢复应用内的服务器参数与配置文件。跨设备购买适用性以 App Store 页面标注为准,操作步骤见已购项目恢复说明。

订阅与账号

一次性买断

指 Shadowrocket 客户端本身的一次性购买,具体价格以 App Store 页面标注为准。客户端一次性买断 ≠ 线路套餐,购买应用后仍需使用自己已有的订阅或服务器信息。本站提供官方手册,不提供、不销售、不推荐节点或订阅服务。

按问题继续查阅

术语解释用于确认含义,操作步骤与故障定位分别见对应章节。涉及购买时,可在 App Store 核对开发者 Shadow Launch Technology Limited、官方图标及应用 ID 932747118。