官方手册 / 术语索引

Shadowrocket 术语表

按界面位置与配置用途查词。英文名称保持应用原文,中文解释说明含义、适用范围与容易混淆的地方。

界面名称 协议参数 规则语法 设置含义

本站是 Shadowrocket 官网与官方手册。本页用于理解术语,不替代操作步骤;首次配置可先阅读教程,需要逐项核对设置时再查阅设置参考。同一个词可能出现在不同位置,例如 Config 既是配置文件入口,也可表示 Global Routing 下的一种模式。

Interface

界面与开关

先区分操作入口、总体模式与自动连接条件,再检查服务器或规则。

Home
查看服务器列表、选择服务器并操作连接开关的主要界面。列表里出现条目只说明资料已保存,不代表认证成功或目标可以访问。排查时应分别确认当前选中条目、连接状态和 Global Routing 模式。
Global Routing
决定流量采用何种总体处理方式的模式入口,三种姿态是配置 Config、代理 Proxy、直连 Direct。模式改变会影响如何处理连接,不能仅凭开关已打开判断流量去向。它与单条规则中的 PROXY、DIRECT 策略属于不同层级。
Config
在 Global Routing 中表示配置模式,流量按当前配置文件中的规则处理。作为页面名称时,它表示配置文件的管理入口。需要按域名分流时,不仅要选择该模式,还要确认实际启用的文件及其规则内容。
Proxy
Global Routing 中的代理模式,主要流量按代理路径处理,不是日常按域名逐条分流的同义词。选择此模式并不能让错误的地址或认证参数变得有效。测试时仍需确认当前服务器可用,并对照具体目标的访问结果。
Direct
Global Routing 中的直连模式,主要流量直接连接目标。它适合用于对照当前网络本身的访问情况,但不等于所有应用与系统连接行为都已被验证。单条规则里的 DIRECT 只决定该条匹配流量的处理方式。
On Demand
根据已保存条件触发 VPN 连接的机制,实际行为取决于条件、系统状态与设置。它管理何时尝试连接,不负责修复地址、密码或 DNS 错误。手动断开后若再次出现连接,应一并检查这里的触发条件。
Add Server
手动填写服务器资料的入口。应对照用户已有的信息核对类型、地址、端口与认证字段,再检查传输和 TLS 等附加参数。填写哪些字段取决于协议,不能将一组参数不加区分地用于所有类型。

Protocols

协议

协议名用于识别连接方式,不用于判断服务质量;参数以用户已有的服务端资料为准。

Shadowsocks
一种代理协议,连接配置通常涉及服务器地址、端口、加密方法与密码。加密方法必须与服务端对应,不能因密码相同就省略核对。若资料包含额外选项,也应按原资料填写,而不是自行推测。
VMess
一种使用身份标识等参数进行认证的代理协议。除地址和端口外,还需核对服务端要求的传输方式以及 TLS 等相关选项。导入成功表示资料可以被读取,不表示所有连接参数已经通过验证。
VLESS
一种代理协议,通常需要核对身份标识、传输方式和安全参数。名称与其他协议相近并不意味着配置可互换。修改已有条目时,应完整对照原始资料,而不是只改 Type 后保留所有旧字段。
Trojan
一种通常结合 TLS 使用的代理协议,常见参数包括地址、端口与密码。服务端要求的 TLS 名称也需要准确对应,不能只核对连接地址。证书验证出错时,应先检查参数和设备时间,而不是直接降低验证要求。
Hysteria2
一种基于 QUIC 的代理协议,其连接表现与当前网络对 UDP 的处理有关。认证、TLS 与可选混淆设置应按服务端资料核对。看到该协议名称不代表一定更快,实际结果仍取决于网络与服务端条件。
WireGuard
一种基于密钥的隧道协议,配置涉及本地地址、密钥、对端及路由范围。它与填写单一服务器密码的配置方式不同,相关字段需要成组核对。私钥属于敏感信息,不应包含在公开截图或排查材料中。
HTTP / SOCKS5
两类不同的代理协议,不能因为地址和端口相同就互换类型。服务器可能要求用户名、密码或特定的 TLS 设置,应按提供的资料填写。它们描述代理连接方式,不等同于浏览器访问网页时地址栏中的协议。

Matching & policies

规则关键字

先看匹配条件,再看处理策略;在 Config 模式下结合当前配置文件检查规则顺序。

规则
由匹配条件和处理策略组成的配置条目,用于决定特定连接的去向。常见分流规则按顺序匹配,因此靠前的宽泛条件可能影响后面的精确条目。排查时应同时检查规则本身、排列位置与最终兜底策略。
DOMAIN
按完整域名匹配的规则关键字,例如只针对 example.com 设置处理方式。它不自动等同于该域名下的全部子域名。需要覆盖 www.example.com 等地址时,应明确补充条目或考虑 DOMAIN-SUFFIX。
DOMAIN-SUFFIX
按域名后缀匹配,通常用于覆盖指定域名及其子域名。参数填写域名,不应带网页地址的路径或查询参数。覆盖范围比单个完整域名更大,添加后应检查相关子域名是否都适用同一策略。
DOMAIN-KEYWORD
根据域名中是否包含指定关键词进行匹配。它不表示网页正文包含该词,匹配范围也可能比预期更宽。若只想处理某个明确站点,通常应先核对 DOMAIN 或 DOMAIN-SUFFIX 是否更符合需求。
GEOIP
根据 IP 地理归属数据库的结果进行匹配,而不是按网页语言判断。结果与目标 IP、数据库内容及解析结果有关。一个站点使用分布式服务时,不能只凭站点名称推断它一定命中某个 GEOIP 条件。
IP-CIDR / IP-CIDR6
分别用于匹配 IPv4 与 IPv6 地址段,地址后面的 CIDR 前缀决定匹配范围。修改前缀会影响覆盖的地址数量,不只是改变写法。排查域名访问时还应核对实际解析结果,避免只检查 IPv4 而忽略 IPv6。
FINAL
未命中前面规则时使用的最终处理项,通常放在规则末尾。它不是某个域名的专用条件,而是给其余连接提供兜底策略。若大量未单独列出的目标走向不符合预期,应检查 FINAL 的值。
PROXY / DIRECT / REJECT
常见规则策略,分别表示交由代理路径处理、直接连接与拒绝连接。全大写写法属于规则语法,应与界面模式 Proxy、Direct 区分。PROXY 的实际出口还需结合配置中的代理选择或策略组判断。

Subscription & configuration

订阅与配置

服务器资料决定连接到哪里,配置文件决定如何处理流量,两者需要分别检查。

Subscribe
用于管理用户已有订阅的相关界面词,订阅地址可用于获取和更新服务器条目。服务器订阅导入后,不应据此判断完整分流配置已经启用。订阅地址可能包含访问凭据,分享排查信息时应遮去完整链接。
服务器
保存协议、地址、端口与认证等参数的连接条目,也常被称为节点。条目名称是便于辨认的标签,不能证明实际所在地、可达性或速度。连接失败时应核对字段和服务状态,而不只看显示名称。
配置文件
保存规则、DNS 等行为设置的文件,与服务器订阅的用途不同。导入一个文件不等于它已经成为当前使用的文件,应在 Config 中确认选择状态。切换前宜保留原有文件,便于发现差异时进行对照。
Scan QR Code
通过二维码读取用户已有连接信息的入口,二维码只是承载资料的形式。识别后仍需核对协议类型与字段是否完整,再尝试连接。含密码或其他凭据的二维码应按敏感资料保管,不能直接公开展示。

Settings & diagnostics

Settings 设置项

以下词语用于理解设置与测试结果,不表示每个项目都需要修改。

DNS
将域名解析为 IP 地址的机制,是连接过程的一部分。解析成功与代理服务器连接成功是不同问题,修改 DNS 也不等于切换流量出口。排查时应分别记录域名能否解析、得到什么地址,以及随后连接是否成功。
Connectivity Test
用于检查当前条件下连接可达性的测试入口。通过测试只能说明该次测试涉及的路径有响应,不代表所有站点、协议或分流规则均正常。应结合实际访问目标、当前模式与日志继续判断问题所在。
Ping
测试相关名称,用于观察所选方法和目标下的响应耗时,不应一概理解为 ICMP 测试。不同方法、目标与网络条件的数值不能直接比较。较低延迟不等于较高传输速度,超时也需要结合测试方法进一步核对。
Log
记录连接、解析或规则处理等过程的信息,用于辅助排查;可见字段取决于日志类型与级别。查阅时应对照问题发生的时间,区分认证失败、解析失败和连接超时。分享前检查是否包含地址、订阅凭据或访问记录。
iCloud 同步
通过 iCloud 在符合条件的设备间同步应用支持的数据,范围以实际设置为准。同步不等同于独立备份,也不决定 App Store 购买记录。换机时应分别确认购买账号、同步状态与当前配置,避免将三者混为一谈。