官方手册 / 术语索引

Shadowrocket 术语表
界面词、协议与规则关键字

先区分设置所在层级,再判断需要修改的内容。本页保留界面英文原词,用中文说明用途、适用条件与容易混淆的边界;可按分类跳转,也可直接引用每条术语的锚点。

界面原词 协议参数 规则语法

准备首次连接,请阅读使用教程;已有配置但连接异常,请按排查手册定位。以下涉及服务器与订阅的说明,均以用户已有自己的订阅或服务器信息为前提。

界面与开关

连接入口与路由模式

开关负责建立连接,Global Routing 决定请求如何处理。开关已开启、服务器已选中、规则已生效,是需要分别确认的三件事。

Home
Home 是查看连接开关、已有服务器与当前选择的主要界面。列表里出现服务器,只说明条目已保存,不代表认证成功或连接已经建立。首次使用应先核对所选条目,再操作连接开关,并用实际请求验证结果。
Global Routing
Global Routing 用于选择整体路由方式:配置、代理、直连分别对应 Config、Proxy、Direct。Config 根据当前配置中的规则处理请求,Proxy 以代理方式处理,Direct 直接连接。排查某个网站的命中结果时,应先记录当前模式,否则修改规则后可能看不到预期变化。
On Demand
On Demand 根据设置的网络或访问条件触发连接,不等于客户端能自动修复失效服务器。启用前应先完成一次手动连接验证,再逐项添加触发条件。如果关闭开关后又出现连接,应检查 On Demand 的条件是否仍然满足。
Add Server
Add Server 是手动录入已有服务器参数的入口。先选择协议类型,再按原始信息填写地址、端口与认证参数;TLS、传输方式等附加项也需与服务端一致。名称通常用于辨认条目,不能替代真正的服务器地址。
Connectivity Test
Connectivity Test 用于观察指定测试条件下的可达性与响应时间。测试通过说明该次探测得到响应,不代表所有网站、UDP 请求或大文件传输都能正常工作。遇到结果与实际访问不一致时,应结合测试方法、目标地址与连接记录判断。
Settings
Settings 集中显示客户端相关设置,具体项目应以当前平台与应用内界面为准。排查时先记录原值,一次只改变一个相关选项,再重复相同的验证请求。不要把服务器的协议参数与客户端全局设置混为一类修改。
协议

协议类型与连接参数

协议名决定客户端与服务器如何通信,不直接代表连接速度。应根据已有服务器信息选择类型,不能只改下拉选项就把一种协议转换成另一种。

Shadowsocks
Shadowsocks 是一种代理协议,常见参数包括服务器地址、端口、密码与加密方法。加密方法必须与服务端一致,不能根据名称相似程度替换。若原始信息还包含插件或其他传输参数,应一并核对,不能只保留地址和密码。
VMess
VMess 使用用户标识等信息完成认证,并可结合不同传输方式使用。导入后要同时检查用户标识、端口、传输类型与 TLS 设置,而不是只核对服务器名称。涉及认证异常时,设备时间是否准确也是需要检查的条件。
VLESS
VLESS 使用用户标识进行认证,协议类型与传输层安全配置需要分别理解。填写正确的用户标识,并不意味着 TLS、服务器名称、传输路径等项目可以省略。连接失败时,应逐项对照已有配置,而非反复更改不相关的 DNS 设置。
Trojan
Trojan 通常结合 TLS 与密码认证使用,地址、端口、密码和服务器名称需要相互对应。证书校验失败与密码错误属于不同问题,应从错误记录区分。不要为了让测试通过而直接跳过证书检查,应先确认域名、设备时间与服务端证书配置。
Hysteria2
Hysteria2 是基于 QUIC 的代理协议,运行条件与 UDP 可达性有关。除服务器地址和认证信息外,还应按已有配置核对 TLS 与相关参数。某个网络中连接失败、换网络后恢复时,可以把 UDP 传输条件作为排查方向,但不能仅凭现象认定原因。
WireGuard
WireGuard 使用密钥对建立加密隧道,常见配置还包含端点、隧道地址与路由范围。公钥、私钥与预共享密钥各有用途,不能互换填写;私钥应作为敏感信息保存。握手成功与目标地址能否按预期路由,是两个需要分别验证的结果。
HTTP / SOCKS5
HTTP 与 SOCKS5 是不同的代理协议类型,不能因为使用相同地址就随意互换。HTTP 代理处理 HTTP 代理请求及 CONNECT 等场景,SOCKS5 在连接建立时使用自己的协商方式。认证要求与 UDP 能力还受服务端实现影响,应按已有服务器说明配置。
规则关键字

匹配条件与处理策略

规则前半部分描述“匹配什么”,策略部分描述“如何处理”。下面的 example.com 等地址仅用于语法说明,不是可连接的服务器信息。

DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD
DOMAIN 匹配完整域名;DOMAIN-SUFFIX 匹配指定域名及其子域名;DOMAIN-KEYWORD 匹配域名中包含的关键字。例如 DOMAIN-SUFFIX,example.com,PROXY 将匹配范围交给 PROXY。域名字段不是完整 URL,不应把协议前缀或页面路径一起填入。
IP-CIDR / IP-CIDR6
IP-CIDR 匹配 IPv4 地址范围,IP-CIDR6 用于 IPv6,范围由地址与斜杠后的前缀长度共同表示。例如 IP-CIDR,192.168.0.0/16,DIRECT 描述一个 IPv4 网段的处理方式。它们匹配地址而不是域名拼写,核对命中结果时要结合实际目标 IP。
GEOIP
GEOIP 根据 IP 数据库中的地区归属匹配目标地址,例如 GEOIP,CN,DIRECT。数据库记录、DNS 返回地址以及目标使用的内容分发网络都可能影响结果。它不能用于精确判断网站运营方所在地,也不应替代对具体域名的规则检查。
FINAL
FINAL 指定前面的规则都未匹配时使用的最终策略,通常置于规则列表末尾。例如 FINAL,PROXY 把剩余请求交给 PROXY。若前面已有范围更广的规则命中,请求不会因为末尾写了 FINAL 就重新选择一次策略。
PROXY / DIRECT / REJECT
这三个大写关键字是规则中的策略:PROXY 交给代理,DIRECT 直接连接,REJECT 拒绝请求。它们与 Global Routing 中的 Proxy、Direct 界面选项属于不同层级。看到某条 REJECT 命中时,应检查对应规则用途,而不是立即把现象归因于服务器超时。
Rule
Rule 指由匹配条件与处理策略组成的规则,通常按配置顺序逐条检查,由命中项决定处理方式。更具体的例外规则应放在能够覆盖它的宽泛规则之前。修改后先保存并确认当前 Config,再用同一目标请求检查命中结果,避免同时改动多项造成判断困难。
订阅与配置

内容导入、解析与验证

服务器条目保存连接参数,订阅负责获取或更新内容,Config 则承载规则等设置。导入成功只完成了其中一个环节,仍需核对选中状态与实际访问。

Subscribe
Subscribe 指通过用户已有的订阅地址获取并更新服务器条目的机制。订阅返回的内容可能是一组连接信息,不一定包含完整规则与 DNS 配置。链接中的访问凭据应妥善保存,排查时不要公开完整地址;更新失败也不等于已经保存的所有条目立即失效。
SERVER
SERVER 对应客户端连接的远端服务器条目,通常包含协议、地址、端口与认证信息。中文说明中的“节点”在此指这样的连接条目,不是订阅本身。条目名称和地区标签主要用于辨认,实际连接条件应以参数与测试结果为准。
Config
Config 可以指保存规则、DNS 等设置的配置文件,也可以指 Global Routing 中按配置处理请求的模式。文件存在、文件被选中、整体模式采用 Config,是不同状态。修改前先保留原配置,保存后确认当前使用项,再验证目标请求的规则命中情况。
DNS
DNS 把域名解析为 IP 地址,解析过程与代理连接建立并不是同一件事。域名访问失败时,应区分解析超时、返回地址异常与服务器连接失败。调整 DNS 前记录原设置,并使用相同域名复测;一次解析成功也不能证明后续连接或路由一定正确。
延迟
延迟表示一次测试在指定方法与目标下的响应时间,通常以毫秒显示。较小的数字不直接等于更高的带宽,也不能反映长时间传输、丢包与所有业务的体验。比较结果应尽量保持同一网络、同一测试方法,并结合实际访问验证。
URL Rewrite
URL Rewrite 按匹配表达式改变 URL 的处理方式,和选择代理或直连出口的路由规则不同。是否生效取决于匹配条件、请求类型与相关配置,不能假定它能读取所有加密请求的完整内容。修改时先限定目标范围,并保留原配置以便恢复。
Scan QR Code
Scan QR Code 用于识别二维码中保存的连接或配置内容,不是一个独立的代理协议。扫描完成后仍需核对协议、地址、认证与附加参数,并确认内容来自自己的已有配置。二维码本身也可能包含敏感凭据,不应直接公开截图。
安装与平台

获取渠道与安装包类型

Shadowrocket 是全平台闭源商业应用。iPhone / iPad 版经 App Store $2.99 一次性付费,Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费;具体获取与系统放行步骤集中在下载页。

App Store
App Store 是 iPhone / iPad 的获取渠道,系统要求以 App Store 页面标注为准。在产品页核对开发者 Shadow Launch Technology Limited、官方图标与应用 ID 932747118。需要获取应用时,请从下载页的 iPhone / iPad 分区查看商店入口与说明。
已购项目
已购项目是 Apple 账户中查找已获取应用的位置,换机或重装时应使用原购买账户查找 Shadowrocket。iPhone 与 iPad 可在同一购买账户下恢复获取,是否显示可下载还受设备兼容性与商店状态影响。重新出现购买提示时,先核对当前用于商店购买的账户,不要直接重复付款。
Apple 芯片 / Intel
这两项表示 Mac 的处理器类型,可在“关于本机”查看后选择对应的 dmg 安装包。本站下载页分别列出 Apple 芯片版与 Intel 版,安装包经本站 /dl/shadowrocket/ 路径提供。首次打开若提示无法验证开发者,在确认来源后按“隐私与安全性”中的“仍要打开”操作,其他提示参见安装放行说明。
deb / rpm / AppImage
这是 Linux 的不同分发格式:Debian / Ubuntu 通常使用 deb,Fedora 等发行版通常使用 rpm,AppImage 则需结合运行环境判断。AppImage 下载后需要授予执行权限,包管理器安装也应按所选格式操作。先在Linux 下载分区选择本站安装包,再按安装表完成权限与依赖检查。

术语帮助定位设置,不替代操作流程。继续阅读首次连接教程,或在故障排查手册中按症状检查。