官方手册 · 名词解释

Shadowrocket 术语表

按名称核对界面入口、协议和规则策略。先区分“何时连接”“如何匹配”和“交给哪条路径”,再修改对应设置;不同平台的入口位置以实际应用为准。

界面与开关

iPhone / iPad 的常见界面词用于辨认入口;连接状态、整体路由方式和服务器选择应分别核对。

Home

iPhone / iPad 的 Home 是查看连接状态与 SERVER 列表的主要页面,Not Connected 表示当前未连接。列表里已经出现服务器记录,只说明信息已被保存,不代表认证或访问已经成功。

检查连接时,先确认所选服务器,再观察开关后的状态;不要把订阅更新成功当成连接成功。

Global Routing

Global Routing 决定整体流量如何处理,配置、代理、直连分别对应界面词 Config、Proxy、Direct。Config 按当前配置执行分流,Proxy 使用代理路径,Direct 使用直连路径。

规则未按预期生效时,先确认是否选择 Config;切换到 Proxy 并不能证明某条规则已经命中。

On Demand

iPhone / iPad 的 On Demand 用于按照已设置的系统网络条件触发连接,具体条件以应用内选项为准。它决定连接何时建立,而 Rule 决定连接建立后流量走向,两者不是同一个开关。

手动断开后再次连接时,应检查 On Demand 条件是否仍然满足,而不是反复删除服务器记录。

Connectivity Test

Connectivity Test 是诊断入口,用来观察指定测试方式下的服务器可达性或响应结果。测试失败可能来自当前网络、目标地址或服务器参数,不宜直接归因于规则。

比较结果时应保持相同网络与测试方式;测试值不能替代实际网页访问,也不能当成下载带宽。

Settings

Settings 是应用设置的集中入口,具体项目会随平台与实际界面有所不同。某个设置名称出现在教程中,不意味着每台设备都需要修改它。

排查前记录原值,每次只调整一个与症状直接相关的选项,再复测同一目标;这样才能判断变化是否有效。

Add Server

Add Server 用于手动填写用户已有的服务器信息,需要先选对协议,再填写地址、端口与对应认证字段。一个地址通常不足以完成配置,TLS、传输方式等附加参数也可能是必需项。

应逐项核对自己的服务端资料,不要把订阅链接整体粘贴进服务器地址栏。

代理协议

全平台配置均应以用户已有服务器的协议和参数为依据。协议名称描述通信方式,不代表速度排序,也不能替代服务端配置。

Shadowsocks

Shadowsocks 是一种加密代理协议,常见字段包括服务器地址、端口、加密方法和密码。加密方法属于协议参数,不能因为名称相似就自行替换。

连接失败时,应先核对加密方法与密码是否和服务端完全一致;若资料还包含附加选项,也需一并保留。

VMess

VMess 是使用用户标识等信息进行认证的代理协议,服务器地址与端口之外还可能需要传输方式、路径及 TLS 参数。相同的用户标识并不意味着任意传输设置都可以通用。

导入后应核对协议类型与完整字段,尤其注意路径和服务器名称是否被遗漏。

VLESS

VLESS 是代理协议之一,协议名称本身不能说明传输已经加密,实际安全属性需要结合 TLS 等设置判断。用户标识、传输类型和相关安全参数应与服务端配套。

不要只把其他记录的协议名改成 VLESS;应根据已有资料新建或重新导入完整记录。

Trojan

Trojan 通常配合 TLS 使用,连接时既要通过密码认证,也要满足服务器名称与证书验证要求。证书错误和密码错误属于不同环节,处理方式也不同。

出现验证提示时,先检查设备时间、服务器名称和服务端证书,不应把关闭验证当作常规修复步骤。

Hysteria2

Hysteria2 是基于 QUIC 的代理协议,连接依赖可用的 UDP 通信条件,并需要正确的认证与 TLS 参数。某个网络可以打开普通网页,不代表其 UDP 路径同样可用。

排查时应对比另一种网络下的结果,再核对服务端端口与参数,不能仅凭一次超时判断协议不受支持。

WireGuard

WireGuard 是基于密钥认证的隧道协议,配置通常涉及本地私钥、对端公钥、端点、隧道地址和路由范围。它使用的密钥关系与普通密码认证不同,字段不能互换。

分享诊断信息时必须隐藏私钥;能够完成握手,也不代表 DNS 与目标路由已经配置正确。

规则关键字与策略

使用 Config 分流时,规则自上而下匹配,命中后执行对应策略。关键字回答“匹配什么”,策略回答“如何处理”。

DOMAIN

DOMAIN 用于精确匹配完整域名,例如 DOMAIN,example.com,DIRECT 针对 example.com。它不会自动把所有子域名都纳入范围,也不按完整 URL 的路径匹配。

只想处理一个明确主机名时,可用它缩小范围;修改后仍要检查前面的规则是否已先行命中。

DOMAIN-SUFFIX

DOMAIN-SUFFIX 匹配指定域名及其子域名,例如 example.com 与 www.example.com。它针对域名层级,不是任意字符串包含判断,也不包含 URL 中的目录部分。

当不同子域名需要不同策略时,应把更具体的规则放在前面,再放覆盖整个域名的后缀规则。

IP-CIDR / IP-CIDR6

IP-CIDR 与 IP-CIDR6 分别按 IPv4、IPv6 地址段匹配,例如 IP-CIDR,192.168.0.0/16,DIRECT 表示一个 IPv4 网段。斜杠后的前缀长度决定范围,不是端口号。

仅添加 IPv4 规则不等于同时覆盖 IPv6;目标使用哪类地址,应结合实际解析与连接记录判断。

GEOIP

GEOIP 根据 IP 地理数据库中的归属结果进行匹配,不依据网页显示语言、域名后缀或公司注册地址。一个域名使用多个服务地址时,不同连接可能得到不同匹配结果。

若需要稳定处理某个明确域名,可优先考虑更具体的域名规则,而不是只依赖地理归属判断。

FINAL

FINAL 是末尾兜底规则,用来接收前面尚未匹配的流量,例如 FINAL,PROXY。它的作用不是提高前置规则的优先级,而是为剩余连接指定结果。

应把它放在规则末尾;若放得过早,后面的具体规则将没有机会处理已被兜底接收的流量。

PROXY

PROXY 是规则里的代理策略,表示命中流量交给代理路径处理,实际连接还依赖所选服务器与相关配置。它与 Global Routing 中的 Proxy 模式大小写和作用范围都不同。

一条规则指定 PROXY 不等于连接必然成功;认证、服务器可达性和 DNS 仍需要分别验证。

DIRECT

DIRECT 表示匹配连接不经过所选代理服务器,而是通过当前网络直接访问目标。它不代表跳过 DNS,也不代表目标必定可达。

规则中的 DIRECT 只作用于命中的连接;Global Routing 的 Direct 则是整体路由方式,排查时应区分两者。

REJECT

REJECT 用于拒绝匹配的连接,是主动执行的规则结果,而不是代理服务器超时。若网页主体能打开但部分功能缺失,应检查相关请求是否被该策略命中。

调整时先定位具体域名和规则位置,缩小匹配范围;不要在未确认原因时整段删除配置。

订阅与配置文件

全平台均需使用用户已有的订阅或服务器信息。服务器列表负责连接资料,配置文件负责规则与相关设置,二者不能相互替代。

订阅 / Subscribe

订阅是一种通过链接获取和更新服务器列表的方式,Subscribe 是相关入口名称。订阅更新成功只说明列表获取与解析完成,不说明其中每个服务器都可连接。

链接中的认证参数属于敏感信息,提交截图或日志前应隐藏;更新前也应留意手动修改的记录是否会被覆盖。

服务器 / SERVER

服务器记录描述客户端要连接的远端服务,通常包含地址、端口、协议和认证参数,SERVER 是界面中的列表标记。显示名称只是用于辨认记录,不是协议或性能证明。

两条记录名称相同也可能使用不同地址;排查应比较实际字段,而不是只看名称或分组。

配置文件 / Config

配置文件组织通用选项、规则和其他功能分段,常见分段包括 [General]、[Rule]、[Host] 和 [URL Rewrite]。Config 既可能指配置相关入口,也用于标识按配置分流的路由方式。

下载或保存文件后,还需确认当前使用的是该配置;文件存在并不等于已经启用。

DNS

DNS 将域名解析为 IP 地址,是连接过程中的一个环节。域名解析失败、代理服务器无法连接、目标服务拒绝访问是不同问题,不能都用“换 DNS”处理。

排查时记录失败域名、当前网络和实际解析结果,再检查配置中的 DNS 设置,避免同时改动路由和解析方案。

URL Rewrite

URL Rewrite 用于按条件重写请求 URL 或进行重定向,不等同于 Rule 中的连接策略选择。URL 改变后可能访问不同目标,但这不表示已经切换了全局路由模式。

涉及 HTTPS 的处理还受加密与证书条件限制;不要把一条重写规则理解为可以直接读取所有加密请求。

延迟

延迟是特定测试条件下观察到的响应时间,反映的是该次测试路径,不等于持续下载带宽。数值较小,也不能保证认证、域名解析和实际网页加载都正常。

比较时保持同一设备、网络和测试方式,并结合实际访问结果;跨网络的一次性数字不适合直接比较。

安装与系统权限

iPhone / iPad 的系统要求以 App Store 页面标注为准;Mac、Windows、安卓、Linux 的安装步骤见获取应用页。系统安装许可与应用内连接授权应分别处理。

VPN 配置权限

iPhone / iPad 首次建立连接时,系统可能请求允许添加 VPN 配置,这项授权用于让客户端建立网络隧道。允许后仍需要正确的服务器资料,它不会自动创建订阅或远端服务。

若权限被拒绝,应通过系统提示或设置重新检查;系统出现 VPN 标记也不能单独证明所有目标都可访问。

已购项目

iPhone / iPad 的已购项目用于查找原账号的应用购买记录,换机或重装时先核对购买时使用的账号。重新下载应用与恢复服务器列表、订阅及配置文件是不同流程,后者应依赖自己的备份。

iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费;各店面显示金额以商店页面为准。

Apple 芯片 / Intel

Mac 的 Apple 芯片版和 Intel 版对应不同处理器架构,应先在“关于本机”查看芯片或处理器,再选择相应 dmg。两种安装包不是两种功能模式,也不能根据外观或电脑名称判断。

首次打开若提示无法验证开发者,应先确认文件来自本站,再到系统设置的“隐私与安全性”查看“仍要打开”;完整步骤见安装放行说明。

系统安装许可

Windows 的 SmartScreen、macOS 的运行提示和安卓的“允许安装未知应用”属于系统对下载文件的控制,不是订阅或协议错误。确认文件来自本站后,Windows 可查看“更多信息 → 仍要运行”,安卓则只给实际下载文件的浏览器开启对应许可。

Linux 的 AppImage 还需执行权限;各平台只按当前提示处理,不应为一次安装关闭整套系统保护,详细步骤见安装放行表。