官方手册 / 术语查阅

Shadowrocket 术语表
界面、协议与规则

遇到英文设置项,应该先查什么?先确认它属于界面操作、连接协议还是规则策略,再阅读对应解释。本页保留英文原名,每张术语卡都可通过地址末尾的锚点单独定位。

准备开始操作?按 首次使用教程逐步核对;需要完整规则片段时,转到 规则手册。以下概念说明不替代应用内当前选项。

01 / Interface

界面与开关

同一个词是否总指同一项功能?不一定。先看所在页面与上下文,尤其要区分 Config 入口、Config 模式以及规则中的策略。

界面与开关

Home

在哪里检查当前连接?Home 是查看服务器条目、当前选择与连接开关的主要入口。先核对选中的条目,再查看开关状态;显示已连接只说明隧道状态,不能单独证明目标网站可访问。遇到异常,应继续检查测试结果、模式和规则。

界面与开关

Global Routing

为什么切换模式后访问结果会变?Global Routing 决定整体流量的处理方式,配置、代理、直连对应界面词 Config、Proxy、Direct。需要按配置分流时检查 Config;临时排查可以对照其他模式,但测试后应恢复预期设置,避免把测试状态当成日常配置。

界面与开关

Config

Config 是文件还是模式?在配置管理入口,它指向配置文件的查看、编辑与选择;在 Global Routing 中,它表示按照当前配置处理请求。编辑某份文件后,要再确认它是否为当前使用的配置,不能仅凭保存成功判断规则已生效。

界面与开关

Proxy / Direct

这两个模式与规则策略一样吗?Proxy、Direct 是 Global Routing 中的模式名称,分别用于整体代理与直连处理;规则行中的 PROXY、DIRECT 则是大写策略关键字。排查时先记录模式,再读规则,避免在未按配置分流的状态下反复修改规则文件。

界面与开关

On Demand

为什么网络变化后会触发连接?On Demand 用于按网络等条件触发 VPN 连接,具体条件以应用内选项为准。它回答“何时连接”,规则回答“请求如何处理”,两者不是同一个层次。修改后分别测试 Wi-Fi 与蜂窝网络下的实际行为。

界面与开关

Add Server / Subscribe

已有信息应该填在哪里?Add Server 是添加连接信息的入口,Subscribe 是用于订阅的类型名称。手动添加时选择与已有参数一致的协议;导入订阅时填写用户自己的订阅地址,再检查生成的条目。不要把订阅地址填进单个服务器的地址字段。

界面与开关

Connectivity Test

测试通过能说明什么?Connectivity Test 按所选测试方式检查连通情况,结果只对应当时的测试条件。比较条目时应保持测试方式与网络一致,再验证实际目标。一次失败不能直接证明参数失效,一次成功也不保证所有服务都可访问。

02 / Protocols

协议

协议名称能决定怎样填写吗?只能确定参数类别,不能推导出具体值。请以用户已有的服务参数为准,逐项核对认证、传输与安全设置。

协议

Shadowsocks

为什么地址正确仍无法连接?Shadowsocks 还需要匹配端口、密码与加密方法等参数,任一项不一致都可能导致失败。加密方法不是可任意更换的偏好设置;若已有信息包含额外传输参数,也应一并核对,不能只复制地址与密码。

协议

VMess

只填 UUID 是否足够?VMess 使用 UUID 等身份参数,但完整连接还依赖服务器地址、端口、传输方式及相应的 TLS 设置。若使用 WebSocket,还要核对路径与 Host 等配套字段。不要根据名称相似就复用其他协议的参数组合。

协议

VLESS

VLESS 的安全设置应该怎么理解?VLESS 使用 UUID 识别用户,连接保护需要结合实际传输与安全配置判断,不能只看协议名称。按已有信息核对 TLS、服务器名称和传输字段;即使地址与 UUID 相同,配套字段不同也可能无法建立连接。

协议

Trojan

为什么要同时检查密码和服务器名称?Trojan 通常结合 TLS,并使用密码进行认证,密码正确不代表证书验证一定通过。应核对端口、TLS 服务器名称与证书相关提示。遇到证书错误先检查名称和设备时间,不应把关闭验证作为常规处理方式。

协议

HTTP / SOCKS5

HTTP 与 SOCKS5 可以互换吗?它们是不同的代理协议,需要选择与服务端一致的类型,并核对端口及用户名、密码等认证信息。协议名称本身不保证传输加密,是否存在安全传输层要看完整配置。不要把网页地址直接当作可用代理参数。

协议

WireGuard

WireGuard 为什么需要多组字段?它使用密钥对建立加密隧道,还需要对端端点、隧道地址与路由范围等信息。公钥与私钥用途不同,不能交换填写;私钥属于敏感凭据。连接异常时应按已有配置逐项核对,而不是自行生成一组值替换。

协议

Hysteria2

Hysteria2 的测试为什么可能受网络影响?它基于 QUIC,连接依赖网络中的 UDP 可达性,也依赖正确的认证与 TLS 参数。参数看似一致但连接失败时,应先区分认证问题与网络可达性问题。额外混淆等选项只按已有服务信息填写。

03 / Rules & Policies

规则关键字与策略

规则由什么组成?先判断匹配条件,再执行对应策略。下面的 example.com 仅用于说明语法,阅读示例后应回到自己的配置核对顺序。

规则关键字与策略

Rule

一条规则负责什么?Rule 把请求的匹配条件映射到处理策略,通常按列表自上而下查找,命中后采用相应策略。更具体的例外应放在更宽泛的条件之前;排查时先找最早命中的行,而不是只检查最后新增的行。

规则关键字与策略

DOMAIN

只想匹配一个完整域名怎么办?DOMAIN 用于精确匹配,例如指定 example.com 时不自动包含 www.example.com。条件位置只写域名,不加 https://、端口或网页路径。需要覆盖子域名时,应再判断是否适合使用 DOMAIN-SUFFIX。

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

DOMAIN-SUFFIX

怎样同时覆盖根域名和子域名?DOMAIN-SUFFIX 按域名后缀边界匹配,example.com 可覆盖它本身及 www.example.com 等子域名,但不是任意字符串包含。若某个子域名要采用不同策略,应将它的具体规则放在这条宽范围规则之前。

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

DOMAIN-KEYWORD

含有某段文字的域名如何匹配?DOMAIN-KEYWORD 检查域名中是否包含指定字符串,范围可能跨越多个不同的域名后缀。它比完整域名或后缀条件更宽泛,可能命中原本不打算处理的目标。使用前应列出预期与非预期的匹配案例。

规则关键字与策略

GEOIP

GEOIP 如何匹配目标?它依据 IP 地理数据库中的归属信息匹配目标地址,不依据网页语言或访问者位置。数据库内容与实际网络部署可能存在差异,目标地址变化也会影响结果。排查时应查看实际解析地址和规则命中情况。

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

IP-CIDR / IP-CIDR6

如何指定一段目标地址?IP-CIDR 匹配 IPv4 地址段,IP-CIDR6 匹配 IPv6 地址段,斜杠后的前缀长度决定范围。前缀写得过宽会包含更多地址,不能仅凭开头相似就判断匹配正确。目标有两类地址时,还要分别检查实际使用的地址族。

IP-CIDR,192.0.2.0/24,DIRECT
IP-CIDR6,2001:db8::/32,DIRECT
规则关键字与策略

USER-AGENT

USER-AGENT 能识别每个应用吗?它依据可读取的 HTTP User-Agent 信息匹配,不等同于按应用身份判断。加密请求中的对应信息通常不能直接读取,匹配能力受请求可见性影响。编写前先确认请求中确实存在可用字段,不要把它当作通用的应用分流条件。

规则关键字与策略

FINAL

前面的规则都没命中时怎么办?FINAL 指定最终处理策略,通常放在规则列表末尾。把它放在具体规则之前,会让后续条件失去预期匹配机会。选择 DIRECT 还是 PROXY 应依据自己的配置目标,而不是把示例直接当作通用答案。

FINAL,DIRECT
规则关键字与策略

PROXY / DIRECT / REJECT

规则命中之后会做什么?PROXY 表示交由代理处理,DIRECT 表示直接连接,REJECT 表示拒绝该请求;具体代理出口还要结合当前选择与配置判断。它们是处理结果,不是匹配条件。误用 REJECT 会造成目标访问失败,因此应先确认命中范围。

04 / Subscription & Configuration

订阅与配置

导入成功为什么还要检查配置?连接条目说明“连接到哪里”,配置文件说明“怎样处理请求”,两者不能简单视为同一份内容。

订阅与配置

订阅

订阅地址保存了什么?它是用于导入或更新连接条目的信息来源,内容格式与更新结果以用户已有服务为准,并不必然包含完整规则配置。地址可能含有个人访问凭据,不应放到公开截图、日志或分享文本中。更新后先核对条目,再做连通性测试。

订阅与配置

服务器条目

条目的名称能说明可用性吗?不能,服务器条目是地址、端口、协议与认证等参数的记录,显示名称只是便于辨认的标签。多个条目也可能指向同一个端点。修改前记录原有参数,修改后检查当前实际选中的条目,避免测试了另一条记录。

订阅与配置

配置文件

配置文件与订阅有什么区别?配置文件组织通用设置、规则和其他处理逻辑,常见段名包括 General、Rule、Host 与 URL Rewrite;连接订阅则主要用于管理连接信息。保存文件与选择它生效是不同操作。调整前保留可恢复的副本,并逐项验证修改影响。

订阅与配置

URL Rewrite

URL Rewrite 与 DOMAIN 规则是一回事吗?不是,它按 URL 条件执行重写等处理,而普通分流规则决定连接策略。URL 中的路径、查询参数与协议部分可能影响匹配,加密请求的可见性也会限制处理。仅需选择直连或代理时,先判断普通规则是否已经足够。

05 / DNS & Network

DNS 与网络

解析、连接和认证属于同一步吗?它们是不同环节。先确定故障发生在哪一层,再修改对应设置,避免一次更改多项导致结果难以判断。

DNS 与网络

DNS

域名打不开就一定是 DNS 问题吗?DNS 负责将域名解析为 IP 地址,解析成功之后仍可能在连接、认证或规则处理阶段失败。先检查是否获得预期地址,再判断后续连接情况。修改 DNS 后应考虑缓存影响,并保持测试目标一致,不能只凭一次刷新下结论。

DNS 与网络

Host

Host 与传输参数中的 Host 相同吗?配置文件的 Host 部分用于静态域名映射,传输参数中的 HTTP Host 则是请求相关字段,二者用途不同。静态映射会影响解析结果,目标地址变更后可能需要同步调整。排查时先确认正在阅读的是哪一类设置。

DNS 与网络

延迟

数值更低就一定访问更快吗?延迟是特定测试条件下的响应时间,不等同于传输吞吐,也不能代表每个目标网站的体验。比较时应使用同一种测试方式与网络,并结合实际访问验证。短时波动或一次超时不足以说明长期状态,测试结果应连同条件一起理解。

DNS 与网络

TLS / SNI

服务器地址与 SNI 为什么可能不同?TLS 用于保护连接,SNI 用于在握手时传递服务器名称;连接端点可以是地址,而验证名称需与服务配置及证书对应。应按已有参数填写,不能把两者随意互换。证书报错时核对名称、设备时间和证书状态,再判断后续操作。

查到术语后,怎样继续排查?

先用一句话确定当前问题:是添加信息失败、无法建立连接,还是已连接但目标访问异常?分别记录相关界面词、协议类型、Global Routing 模式与命中规则,再一次只调整一个条件。记录中应隐去订阅地址、密码、私钥等敏感内容。

需要实际步骤时阅读 教程;需要判断规则先后关系时阅读 规则手册;购买、已购恢复及首次打开相关问题请查看 疑难解答。系统要求与设备兼容性以 App Store 页面标注为准。

返回术语分类 ↑