官方手册 · 英文原文对照

Shadowrocket 术语表

从界面词查到规则策略。先确认术语出现的位置,再判断它描述的是操作入口、连接方式,还是请求的处理结果。

界面与配置 协议参数 规则与诊断

01 / INTERFACE

界面与开关

界面入口与路由姿态不是同一概念。看见英文词时,先核对它属于哪个页面或设置项;实际显示位置以当前应用界面为准。

界面入口

Home

Home 是查看服务器条目、选择连接对象并操作连接开关的主要入口。列表中出现条目,只表示信息已经导入,不代表认证或连接测试已经通过。首次使用时,应先核对选中的条目,再检查 Global Routing,最后开启连接。

手动添加

Add Server

Add Server 用于录入用户已有的服务器信息,先选协议类型,再填地址、端口和认证参数。同样是密码字段,不同协议也可能有不同含义,不能只凭字段相似就互相套用。保存后重新打开条目核对一次,可减少输入遗漏带来的排查成本。

整体路由行为

Global Routing

Global Routing 决定整体采用哪一种路由姿态:配置(Config)、代理(Proxy)或直连(Direct)。Config 按当前配置中的规则处理请求,Proxy 使用代理路径,Direct 使用直连路径。排查分流时应先确认这一项,否则修改规则后可能看不到预期变化。

需要结合位置理解

Config

在配置管理场景中,Config 指向配置文件的查看、导入与选择;在 Global Routing 中,它指按配置规则处理流量的姿态。导入了文件,不等于该文件已经被选中使用。遇到规则未生效,应同时核对当前文件和 Global Routing,而不是只确认文件列表中有名称。

路由姿态

Proxy / Direct

Proxy 与 Direct 是 Global Routing 中的代理、直连姿态,用来改变整体处理方式。它们和规则文本中的大写 PROXY、DIRECT 含义相关,但作用层级不同。临时切换姿态可以帮助定位问题,完成对照测试后应恢复需要的设置,避免把测试状态当成日常配置。

按条件连接

On Demand

On Demand 用于按网络等条件触发系统 VPN 连接行为,例如针对 Wi-Fi 或蜂窝网络设置不同条件。它回答的是何时建立或断开连接,而规则分流回答的是连接建立后如何处理请求。测试时一次只改变一种网络条件,并观察实际连接状态,避免把两个层次的问题混在一起。

设置与观察

Settings / Data

Settings 用于查看和调整设置项,Data 用于查看流量相关信息,具体内容以当前界面为准。流量数值发生变化,说明存在数据活动,但不能单独证明某个网页或服务访问成功。核对问题时,应把统计、连接记录和实际访问结果放在同一时间范围内比较。

02 / PROTOCOLS

代理协议

协议类型由已有服务器的配置决定,不是速度档位。先按服务器信息选择相同类型,再逐项核对认证、传输与 TLS 参数;详细取舍见 协议技术参考。

代理协议

Shadowsocks

Shadowsocks 通过服务器地址、端口、密码及加密方法等参数建立代理连接。加密方法必须与服务器一致,不能仅为尝试连接而随意替换。若已有信息包含插件或额外传输要求,还需确认客户端对应设置与服务器要求相符。

代理协议

VMess

VMess 使用身份标识等参数完成认证,常见信息还包括传输方式及 TLS 相关选项。服务器地址相同并不意味着其他字段可以省略,路径和服务器名称也可能参与连接过程。发生握手错误时,应先逐项对照原始信息,而不是只更换地址或端口。

代理协议

VLESS

VLESS 以身份认证和连接转发为核心,实际传输安全还取决于所采用的传输层及 TLS 配置。填写身份标识之后,仍需核对传输类型、服务器名称和其他必要字段。VLESS 与 VMess 是不同类型,不能因为认证字段外观相近就直接互换。

代理协议

Trojan

Trojan 通常结合 TLS 使用,连接时既需要认证信息,也需要正确的服务器名称与证书校验。密码正确并不代表 TLS 握手一定成功,域名或设备时间异常也可能影响连接。遇到证书错误,应检查名称、时间和服务器配置,不应把关闭校验当作常规处理方法。

代理协议

HTTP / SOCKS5

HTTP 与 SOCKS5 是两类不同的代理协议,具体认证方式、地址解析行为和 UDP 支持需要按服务器能力核对。HTTP 代理并不自动等同于到代理服务器之间采用加密传输,需另看连接配置。导入时必须选择对应类型,不能只沿用地址和端口便认为配置完整。

隧道协议

WireGuard

WireGuard 使用密钥对识别通信双方,配置通常涉及接口地址、对端公钥、端点和路由范围。私钥与对端公钥承担不同角色,不能填反,也不应在公开记录中展示。能够与对端通信只是检查的一部分,还要核对路由范围与 DNS 是否覆盖实际访问目标。

基于 QUIC 的协议

Hysteria2

Hysteria2 基于 QUIC,连接表现会受到当前网络的 UDP 可达性、丢包情况和服务器配置影响。认证信息、TLS 设置及可能存在的额外参数都需保持一致。不能仅根据协议名称判断它在某个网络下一定更快,应在相同条件下验证实际访问与持续传输表现。

03 / RULES & POLICIES

规则关键字与策略

一条规则通常包含匹配类型、匹配内容和策略。关键字回答“匹配什么”,策略回答“如何处理”;阅读时不要把两者当作同一个字段。

域名匹配

DOMAIN / DOMAIN-SUFFIX

DOMAIN 匹配指定的完整域名,DOMAIN-SUFFIX 匹配指定域名及其子域名。例如对 example.com 使用 DOMAIN-SUFFIX,也会覆盖 www.example.com,但并非任意包含这串字符的域名。希望只处理单个主机名时,优先核对是否应使用更精确的 DOMAIN。

文本匹配

DOMAIN-KEYWORD

DOMAIN-KEYWORD 检查域名是否包含指定文本,不要求该文本处于域名后缀位置。范围较短的关键字可能覆盖很多原本不想处理的域名。出现误匹配时,应先检查关键字是否过宽,再考虑改用 DOMAIN 或 DOMAIN-SUFFIX。

地址段匹配

IP-CIDR / IP-CIDR6

IP-CIDR 描述 IPv4 地址段,IP-CIDR6 描述 IPv6 地址段,斜杠后的前缀长度决定覆盖范围。例如 10.0.0.0/8 表示一个地址范围,而不是某个单独主机。域名请求是否命中地址规则,还需结合解析结果和配置中的解析行为判断。

IP 归属匹配

GEOIP

GEOIP 依据 IP 地理归属数据匹配目标地址,不是依据网页语言或域名文字判断地区。结果受数据库内容、目标解析地址和服务部署方式影响。遇到分流结果与预期不符,应查看实际目标 IP,而不是仅从网站名称推断应命中的规则。

兜底规则

FINAL

FINAL 用于前面的规则均未命中时指定最终策略,通常放在规则列表末尾。它不是“优先级最高”的标记,过早出现会让后续规则失去匹配机会。排查某个请求为何走默认路径时,应先检查前面的规则是否匹配成功,再核对 FINAL 后的策略。

处理策略

PROXY / DIRECT / REJECT

PROXY 表示采用代理策略,DIRECT 表示直连,REJECT 表示拒绝相应请求。这些是规则文本中的关键字,不是协议类型,也不是服务器名称。确认请求命中规则后,还要核对策略是否指向预期处理方式,以及代理路径所用的连接对象是否可用。

匹配逻辑

规则顺序

规则按顺序匹配,先命中的规则决定相应请求的策略,因此精确例外通常应放在宽泛规则之前。把新规则追加在 FINAL 后面,通常无法得到预期结果。调整时先保留原文件副本,再一次只改变一处顺序,方便依据记录判断变化来自哪里。

04 / SUBSCRIPTION & CONFIGURATION

订阅与配置文件

本页以用户已有自己的订阅或服务器信息为前提。服务器列表、规则文件与购买记录分别解决不同问题,导入其中一种不会自动补全其余内容。

订阅导入

Subscribe

Subscribe 是导入和更新已有订阅信息时使用的类型或字段,具体入口以当前界面为准。订阅通常提供服务器条目,实际包含哪些内容取决于订阅格式,不能默认其中一定带有完整规则。订阅地址可能包含访问凭据,不应把完整地址贴入公开截图或排查记录。

单个连接条目

Server

Server 指单个服务器连接条目,通常由协议、地址、端口和认证信息组成,列表中也可能显示 SERVER 标签。名称只是便于识别的备注,不能据此确认实际地理位置或可用性。手动修改订阅生成的条目前,应先保留原始信息,并留意后续更新可能覆盖本地改动。

配置文件

.conf

.conf 是配置文件的常见扩展名,文件可组织全局参数、分流规则、本地映射和改写等内容。它与仅提供服务器条目的订阅不是同一个概念,也不能只凭扩展名判断文件内容完整。导入后应查看段落、选中实际使用的文件,并确认 Global Routing 采用 Config。

配置段名

[General] / [Rule] / [Host]

[General] 组织全局参数,[Rule] 组织按顺序执行的分流规则,[Host] 用于本地地址映射。段名决定后续行如何解释,因此同一行放错段落可能无法发挥预期作用。编辑时应先确认段落边界,再核对字段语法,不要把服务器认证信息随意填入规则段。

请求处理

URL Rewrite

URL Rewrite 依据匹配条件对 URL 执行改写等处理,配置中对应 [URL Rewrite] 段。它改变的是请求处理行为,不等同于把请求分配给 PROXY 或 DIRECT。涉及加密请求时还可能受到相关处理条件限制,应先确认必要性、匹配范围与隐私影响,再启用已有规则。

信息导入

Scan QR Code

Scan QR Code 用于读取二维码中已有的连接信息,扫码成功只说明内容被识别,不代表参数一定可用。导入后仍需查看协议、地址和认证字段是否符合原始信息。二维码也可能包含敏感凭据,分享操作截图时应遮挡二维码本身,而不只是旁边的文字。

05 / CONNECTION & DIAGNOSTICS

连接与诊断

诊断时分开观察系统连接、服务器认证、DNS 和实际业务访问。一个环节正常,不能代替其他环节的检查;故障处理可继续查看 常见问题。

地址解析

DNS

DNS 把域名解析为地址等记录,是请求到达目标前的重要环节。解析成功不代表后续认证、连接和页面加载一定成功,缓存也可能让修改后的结果暂时不明显。排查时先区分“无法得到地址”和“已有地址但无法连接”,再检查对应设置,避免同时更改多个参数。

连通性检查

Connectivity Test

Connectivity Test 按当前测试方式和测试目标检查连接是否可达,结果应结合具体设置阅读。一次测试通过,不表示所有域名或所有传输类型都能正常使用。对比服务器条目时,应保持测试方式与网络条件一致,并再访问实际需要使用的服务。

测试指标

延迟

延迟通常表示特定测试条件下的往返耗时,不等同于带宽、持续吞吐量或网页加载速度。数值较低的连接仍可能受到丢包、拥塞或目标服务响应影响。比较结果时应在相近时间、相同网络和相同测试方式下多次观察,不依据单次数值作长期判断。

传输与握手

TLS / SNI

TLS 用于保护传输,SNI 在握手中指示目标服务器名称,两者相关但不是同一个设置。连接地址与服务器名称可以承担不同作用,应照已有服务器信息填写,而不是看到地址是 IP 就删掉名称。出现握手异常时,先核对名称、证书与设备时间,再查看其他传输参数。

系统授权

VPN 配置授权

VPN 配置授权是 Apple 系统允许客户端建立 VPN 连接所需的授权,首次连接时可能由系统提示确认。完成授权不表示服务器密码正确,也不表示所有请求已经走预期策略。遇到连接失败,应分别核对系统授权状态、所选服务器和实际请求结果。

下载 Shadowrocket