官方手册 · 概念速查

Shadowrocket 术语表

按界面词、协议与规则关键字查阅含义。先区分“在哪个页面设置”和“由哪条规则处理”,再对照自己的配置修改。

01 / Interface

界面与开关

英文名称保留界面原文。同一个词出现在页面标签与模式选项中时,需要结合所在位置理解。

界面与开关

Home

Home 是查看服务器列表、选择当前服务器并操作连接开关的主要页面。连接前先确认选中的条目,再检查 Global Routing;开关处于开启状态,仅说明连接功能已经启用,不能据此判断所有目标都能正常访问。

界面与开关

Config

Config 既是管理配置文件的页面名称,也是 Global Routing 中“配置”模式对应的英文选项。前者用于选择和编辑文件,后者表示按当前配置规则处理流量;仅导入一个文件,不等于已经选中它,也不等于当前正在按它分流。

界面与开关

Global Routing

Global Routing 决定整体流量处理方式,常用三种姿态为配置(Config)、代理(Proxy)和直连(Direct)。Config 依据规则分流,Proxy 使用代理路径,Direct 使用直连路径;排查规则未生效时,应先确认当前选项是否为 Config。

界面与开关

On Demand

On Demand 根据已设置的网络条件触发连接行为,适合需要按网络环境管理连接的情形。它不负责决定某个域名最终走哪条规则,也不会补全服务器参数;排查自动连接行为时,应同时核对条件设置与当前连接状态。

界面与开关

Add Server

Add Server 用于把用户已有的服务器资料保存为连接条目。协议类型决定需要填写哪些参数,地址、端口、认证信息及传输设置都应与资料一致;保存成功只表示条目已建立,仍需测试并实际连接验证。

界面与开关

Connectivity Test

Connectivity Test 是检查服务器在当前网络下是否可达的测试入口。测试结果受探测方式、网络路径和服务端响应影响,不能直接当作网页速度排名;测试通过后,仍应打开实际需要使用的目标,确认解析、连接和内容加载。

界面与开关

DNS

DNS 将域名解析为 IP 地址,是访问域名时的重要环节。解析失败可能导致连接尚未建立就中断,而解析成功也不代表目标服务可达;修改 DNS 前先记录原设置,并通过同一个目标复测,避免同时改动多个变量。

02 / Protocols

协议

协议描述客户端与服务端如何通信,不是速度等级。以下说明均以用户已有自己的服务器资料为前提。

协议

Shadowsocks

Shadowsocks 使用加密方法与密码等参数建立代理连接。填写时需要同时核对服务器地址、端口、加密方法和密码,附加设置也应以服务端资料为准;即使地址能够连通,认证或加密方法不一致仍可能使业务请求失败。

协议

VMess

VMess 使用用户标识等参数进行身份验证,并可结合不同传输方式使用。导入后除了检查地址与端口,还需核对用户标识、传输路径及 TLS 等相关设置;不要把另一种协议的字段逐项照搬,因为同名字段的使用条件可能不同。

协议

VLESS

VLESS 使用用户标识进行身份验证,其安全性需要结合实际传输与加密设置理解,不能只凭协议名称判断。配置时应按服务端资料检查身份参数、传输方式及相关安全选项;是否需要某个附加字段,取决于双方采用的具体配置。

协议

Trojan

Trojan 通常依托 TLS 传输,并使用密码进行身份验证。除地址、端口和密码外,还要核对 SNI 与证书对应的域名;证书校验报错时,应先检查域名、设备时间和服务端证书,不应把关闭校验作为常规处理步骤。

协议

Hysteria2

Hysteria2 基于 QUIC,连接依赖 UDP 路径,以及双方一致的认证和 TLS 设置。排查时需要区分服务器参数错误与当前网络不支持相应通信路径两类情况;填写带宽相关参数并不等于获得对应速度,实际表现仍受两端与网络条件约束。

协议

WireGuard

WireGuard 使用公私钥与对端配置建立加密隧道,参数结构不同于单纯的地址加密码。配置通常涉及本地密钥、对端公钥、端点和地址范围;私钥属于敏感资料,不应放入公开截图、日志或求助文本。

03 / Rule keywords

规则关键字

关键字定义“按什么条件匹配”,行末策略定义“匹配后怎样处理”。示例中的 example.com 仅用于说明语法。

规则关键字

DOMAIN

DOMAIN 按完整域名进行精确匹配,例如只为 example.com 指定处理方式。它不会自动覆盖 www.example.com 等子域名;需要同时处理主域名和子域名时,应考虑 DOMAIN-SUFFIX,而不是逐个猜测域名前缀。

DOMAIN,example.com,PROXY
规则关键字

DOMAIN-SUFFIX

DOMAIN-SUFFIX 匹配指定域名本身及其子域名,适合按域名层级统一指定策略。example.com 可以覆盖 www.example.com,但不表示任意包含这段字符的域名都会命中;它与单纯字符串包含匹配的范围不同。

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

DOMAIN-KEYWORD

DOMAIN-KEYWORD 按域名中包含的指定字符串进行匹配,不要求该字符串构成完整域名层级。它的范围通常比 DOMAIN 或 DOMAIN-SUFFIX 更宽;使用前应检查是否会连带命中不相关域名,尤其不要用过短且常见的词代替明确域名。

DOMAIN-KEYWORD,example,PROXY
规则关键字

GEOIP

GEOIP 依据 IP 地理数据库中的地区归属匹配目标地址,而不是根据域名后缀或用户所在地判断。内容分发和地址归属变化可能影响匹配结果;需要对某个明确域名固定处理时,应优先检查更具体的域名规则。

GEOIP,CN,DIRECT
规则关键字

IP-CIDR

IP-CIDR 使用 CIDR 表示法匹配 IPv4 地址范围,斜杠后的数字是网络前缀长度,不是端口。示例表示对 192.168.0.0/16 范围采用 DIRECT;填写范围前应确认实际网络规划,避免把原本需要其他策略的地址一并覆盖。

IP-CIDR,192.168.0.0/16,DIRECT
规则关键字

IP-CIDR6

IP-CIDR6 用于匹配 IPv6 地址范围,不能用 IPv4 的 IP-CIDR 条目替代。双栈网络中的同一域名可能返回两类地址,因此排查某条地址规则未命中时,应确认实际连接使用的是 IPv4 还是 IPv6,再检查对应范围。

IP-CIDR6,fc00::/7,DIRECT
规则关键字

USER-AGENT

USER-AGENT 依据可读取的 HTTP User-Agent 字段匹配请求,不能理解为按设备上的应用名称分流。加密请求中的字段通常无法直接读取,因此并非所有连接都适用;使用前应确认协议与处理条件,不要为匹配这类规则而盲目改变证书设置。

规则关键字

FINAL

FINAL 是前面的规则均未命中时采用的最终处理入口,通常放在 Rule 段末尾。它没有域名或地址条件,行末直接写最终策略;如果过早出现,后面的具体规则便无法承担预期的兜底前匹配作用。

FINAL,DIRECT

04 / Policies and order

策略与匹配顺序

规则中的 PROXY、DIRECT、REJECT 是处理结果。它们与 Global Routing 中的 Proxy、Direct 属于不同层次。

策略与匹配顺序

Rule 与匹配顺序

Rule 段按从上到下的顺序检查规则,先命中的规则决定相应处理方式,不是“更具体的规则自动优先”。应把需要优先处理的例外放在较宽泛的条件之前,并把 FINAL 放在末尾;验证时还要确认启用的是预期配置文件。

DOMAIN,example.com,DIRECT DOMAIN-KEYWORD,example,PROXY FINAL,DIRECT
策略与匹配顺序

PROXY

PROXY 是规则中的代理策略,表示把匹配流量交给代理路径处理。它本身不包含服务器地址、密码或订阅资料,也不保证当前服务器可达;规则确实命中 PROXY 后仍无法连接,应继续检查服务器选择、认证参数与当前网络。

策略与匹配顺序

DIRECT

DIRECT 表示匹配流量不经过代理服务器,而使用当前网络的直连路径。它仍可能受到 DNS、目标服务和本地网络条件影响,因此不是“必定成功”的同义词;在 Config 模式下使用 DIRECT,只影响命中该规则的流量。

策略与匹配顺序

REJECT

REJECT 用于阻止匹配的请求继续建立连接,是明确的拒绝结果而非服务器故障。某个页面缺少资源或部分功能失败时,应检查是否存在范围过大的拒绝规则;测试修改时先缩小匹配条件,不要直接删除全部规则。

05 / Subscription and configuration

订阅与配置文件

服务器资料解决“连接到哪里”,配置文件解决“如何处理流量”。导入、更新、选中与连接是不同操作。

订阅与配置文件

Subscribe

Subscribe 通过用户已有的订阅地址获取并更新服务器资料,内容由该地址的提供方决定。更新订阅不等于连接,也不代表 Config 中的规则文件同步更新;订阅地址可能含有访问凭据,分享求助信息前应完整移除这些敏感内容。

订阅与配置文件

SERVER

SERVER 对应服务器资料所形成的连接条目,通常包含地址、端口、协议和认证参数,中文说明中也常称为节点。条目名称只是便于辨认的标签,不能证明实际所在地或连接质量;判断是否可用,应以参数核对、测试与实际请求为依据。

订阅与配置文件

.conf 配置文件

.conf 是组织配置内容的文本文件,可包含 General、Rule、Host 与 URL Rewrite 等段落。它与服务器订阅用途不同,不能只凭文件存在就认定分流已生效;编辑前保留原内容,保存后在 Config 确认当前选中的文件,再检查 Global Routing。

订阅与配置文件

URL Rewrite

URL Rewrite 按匹配表达式对可处理的请求地址执行改写或重定向,并不替代 Rule 中的路由策略。示例把匹配的 HTTP 地址重定向到 HTTPS,302 表示重定向状态码;使用时还需确认请求是否满足可处理条件,以及目标地址是否正确。

^http://example\.com https://example.com 302
订阅与配置文件

延迟

延迟描述某次测试中探测请求到响应所经历的时间,不等同于带宽、下载速度或完整页面加载时间。只有探测方式和网络条件接近时,结果才便于比较;应结合多次测试及实际目标使用情况判断,而不是只按一次数字选择服务器。