官方手册 · 术语索引

Shadowrocket 术语手册

按界面位置与配置用途查词。先区分“在哪里设置”,再判断“匹配什么”和“如何处理”。英文名称保持界面与规则文件中的原样。

本页适用于理解 Shadowrocket 的通用概念;各平台入口位置以实际界面为准。已有订阅或服务器信息后,可对照入门指南操作,完整语法见规则参考。

获取方式:iPhone / iPad 版 App Store $2.99 一次性付费,Mac(Apple 芯片与 Intel)/ Windows / 安卓 / Linux 版免费。具体入口见下载指南。

界面与开关

界面选项决定当前工作方式,不要把标题式大小写的选项名与全大写规则策略混用。

界面与开关

Global Routing

控制整体流量处理姿态的入口,常用三项是配置、代理、直连,对应界面词 Config / Proxy / Direct。选择 Config 时,流量按当前配置的规则决定去向;Proxy 与 Direct 则用于切换整体处理方向。排查规则不生效时,先确认这里是否仍为 Config。

界面与开关

Config

既可能指管理配置的页面,也可能指 Global Routing 中的配置姿态,含义取决于所在位置。在配置页面查看文件,不等于已将该文件选为当前使用项。采用 Config 姿态后,还要核对实际启用的配置和 Rule 内容。

界面与开关

Proxy

Global Routing 中的代理姿态,使整体流量采用代理方向处理,具体仍受平台网络机制与配置影响。它不是某一种协议,也不会自动补齐服务器参数。界面中的 Proxy 与规则行末尾的 PROXY 属于不同层次。

界面与开关

Direct

Global Routing 中的直连姿态,适合判断问题是否与代理路径有关。选择 Direct 不等于关闭客户端连接开关,客户端仍可能处于接管网络的状态。若要比较完全停用后的表现,应另行关闭连接,再进行同一目标的测试。

界面与开关

On Demand

根据预设条件触发连接的机制,用于减少重复手动操作。它解决的是何时建立连接,而 Rule 解决连接建立后每个请求如何处理。排查自动重连时,应同时检查 On Demand 条件与系统中的 VPN 状态。

界面与开关

Connectivity Test

用于检查所选路径在特定测试条件下能否完成连接。结果取决于测试方式、目标与当时网络,不能直接当作持续下载速度。测试有响应而网页打不开时,仍需继续检查 DNS、规则命中和目标服务状态。

协议

协议描述客户端与服务器之间如何通信。名称相近或使用相同端口,并不代表参数可以互换。

协议

Shadowsocks

使用对称加密保护客户端与服务器之间代理传输的协议。录入时需匹配服务器地址、端口、密码和加密方法,不能只核对其中一项。是否能承载 UDP,还取决于服务器配置与当前网络条件。

协议

VMess

具有身份认证机制的代理协议,连接资料通常包括用户标识与传输相关设置。协议参数、传输方式以及 TLS 设置是不同层次,必须分别对应服务器端配置。认证失败时应检查资料与设备时间,而不是随意更换加密选项。

协议

VLESS

将身份认证与底层传输安全分离的代理协议,不能仅凭名称认定连接已加密。实际保护方式取决于所配套的安全传输设置。填写时应逐项核对用户标识、传输类型及服务器提供的安全参数。

协议

Trojan

通常运行于 TLS 之上的代理协议,认证信息与证书验证共同影响连接能否建立。服务器地址与用于 TLS 验证的名称可能承担不同作用,应以已有连接资料为准。遇到证书错误时,先检查名称、证书有效期和设备时间。

协议

Hysteria2

基于 QUIC 的代理协议,底层依赖 UDP,传输表现会受到丢包、带宽及网络限制影响。高延迟环境不代表一定更快,实际效果需要在同一网络中比较。若握手超时,应先确认相关 UDP 通信可达,再检查认证和 TLS 参数。

协议

WireGuard

基于 UDP、以密钥对识别对端的隧道协议。除服务器端点外,还需正确设置本端地址、对端公钥与允许的路由范围。出现握手但业务不通时,应继续检查路由和 DNS;私钥属于敏感资料,不应贴入公开截图。

协议

HTTP / SOCKS5

两类常见代理协议名称,并非网站地址前缀的简单选择。基础协议本身不保证客户端到代理服务器之间的传输加密,是否受保护要看额外的安全封装。SOCKS5 的 UDP 转发也需要服务器及客户端配置共同支持。

规则关键字与策略

规则前半段描述匹配条件,末尾指定处理策略。下面的域名与网段仅用于说明语法,不是连接资料。

规则关键字与策略

Rule

配置中描述匹配条件与处理策略的部分,文本段名通常写作 [Rule]。规则不是越多越优先,而是从上到下首条命中即生效。精确条件通常放在宽泛条件之前,末尾再安排 FINAL 作为兜底。

规则关键字与策略

DOMAIN

匹配一个完整域名,例如 DOMAIN,example.com,DIRECT。该行不会自动包含 www.example.com 等子域名。只想针对某一个主机名调整路径时,精确匹配比宽泛关键词更容易检查。

规则关键字与策略

DOMAIN-SUFFIX

匹配指定域名及其子域名,例如 DOMAIN-SUFFIX,example.com,PROXY。它按域名后缀关系匹配,不等同于任意字符串包含。需要把同一域名体系下的请求交给相同策略时,可用它减少重复规则。

规则关键字与策略

DOMAIN-KEYWORD

检查域名中是否包含指定关键词,例如 DOMAIN-KEYWORD,ads,REJECT。短关键词可能覆盖与预期无关的域名,因此这条示例不能当作完整拦截方案。发生误匹配时,应缩小条件或在前面添加更精确的例外。

规则关键字与策略

GEOIP

依据目标 IP 在所用地理数据库中的归类选择策略,不是依据网页语言或设备地区判断。数据库归类与服务实际部署可能存在差异,结果还可能受到域名解析地址影响。对固定业务有明确要求时,应结合更精确的域名规则检查。

规则关键字与策略

IP-CIDR / IP-CIDR6

分别使用 IPv4 与 IPv6 网段作为匹配条件,斜杠后的数字表示网络前缀长度。例如 IP-CIDR,192.168.0.0/16,DIRECT 描述一个私有 IPv4 网段。只配置 IPv4 规则,不代表同一业务的 IPv6 地址也会命中。

规则关键字与策略

FINAL

前面的规则都未命中时使用的最终策略,例如 FINAL,PROXY。它通常放在 Rule 段末尾,因为放在前面会使后面的条件失去匹配机会。兜底选 PROXY 还是 DIRECT,应依据自己的配置目标决定。

规则关键字与策略

PROXY

表示该条规则命中后交由当前代理选择或配置对应的代理策略处理。它是处理结果,不是服务器地址,也不指定 Shadowsocks 等具体协议。判断实际使用哪条连接时,还要查看当前服务器选择与配置中的策略关系。

规则关键字与策略

DIRECT

表示该请求使用直连路径,不交给代理服务器转发。它只决定命中请求的路径,不会让整份配置中的其他请求都改为直连。若目标本身不可达,改用 DIRECT 也不保证恢复访问。

规则关键字与策略

REJECT

表示拒绝命中的请求,常用于明确不希望建立的连接。拒绝某个域名可能同时影响图片、登录或其他依赖同一域名的功能。排查页面内容缺失时,应先核对命中记录,再调整具体条件。

订阅与配置

服务器资料、服务器列表与规则文件承担不同任务。导入前先确认内容类型,更新成功后再确认实际选中的项目。

订阅与配置

Subscribe

用于导入或管理订阅内容的入口,订阅链接从你的服务商处获取。日常所说的订阅可能返回服务器列表,也可能返回配置内容,不能仅凭链接外观判断。更新操作是重新读取远端内容,并不等同于延长服务有效期。

订阅与配置

Add Server

手动录入单个服务器连接资料的入口;服务器是承接代理连接的远端端点,常被称为节点。应先选择对应协议,再依据已有资料填写地址、端口和认证字段。显示名称只是本地辨认标签,修改名称不会改变实际服务器。

订阅与配置

配置文件

组织 General、Rule、Host 等设置的文本,用于描述网络处理行为。服务器列表回答有哪些连接可选,配置文件则可能规定请求如何解析、匹配与处理,两者不能直接视为同一种内容。更换配置前应保留原文件,便于比较与恢复。

订阅与配置

URL Rewrite

描述 URL 改写或重定向行为的配置部分,与 Rule 选择请求路径的作用不同。规则是否生效取决于匹配表达式、请求形式及可见范围,不能仅凭域名相同判断。涉及 HTTPS 内容时还要理解 TLS 边界,普通路径分流不需要因此改动证书设置。

网络与 DNS

解析、建立连接与传输数据是不同阶段。一个阶段的测试通过,不能代替其余阶段的验证。

网络与 DNS

DNS

将域名解析为 IP 地址等记录的机制,是大多数域名访问的前置环节。DNS 返回结果不代表目标端口可达,反过来服务器延迟正常也不代表业务域名解析正常。排查时应同时看查询是否成功、返回何种地址,以及后续规则如何处理该地址。

网络与 DNS

延迟

某次测试中请求与响应的耗时,常以毫秒表示,数值含义取决于测试方式。延迟低不代表可用带宽大,也不保证所有目标网站都响应快。比较结果时应保持测试目标、网络和方式一致,并结合真实业务访问判断。

网络与 DNS

TCP

提供有序可靠字节流的传输协议,通过确认、重传和拥塞控制处理网络变化。建立连接成功后,仍可能因为丢包或带宽竞争而传输缓慢。若应用使用 TCP,测试另一种传输的结果只能作为线索,不能直接代表该应用表现。

网络与 DNS

UDP

以数据报为单位传输,自身不保证送达与顺序,但上层协议可以自行补充可靠性机制。QUIC 和 WireGuard 都依赖 UDP,因此不能把 UDP 简单理解为不可靠业务专用。TCP 可用而 UDP 连接超时时,应分别检查网络路径与服务器监听状态。

需要把这些概念连成操作步骤?阅读入门指南;需要查配置结构和规则顺序?阅读规则参考。