官方手册 · 术语参考

Shadowrocket
术语表

按用途查词,保留英文原文。

先区分界面选项、协议参数与规则策略,再对照当前页面操作。每个术语都有独立锚点,可直接保存或分享具体条目。

INTERFACE

界面与开关

先确定当前所在页面。页面名、整体路由方式与连接开关各有职责,不能用其中一个状态推断全部连接结果。

界面与开关

Home

用于查看已有服务器条目、选择连接对象及操作连接开关的主要页面。选中一个条目只是在指定连接对象,并不等于已经建立连接;还应查看开关状态与实际访问结果。条目为空时,应先用自己的订阅或服务器信息完成添加。

界面与开关

Global Routing

决定整体请求处理方式的选项:配置、代理、直连分别对应 Config、Proxy、Direct。需要按规则区分请求时,使用 Config 并核对当前启用的配置。切换这一选项不会替你修改服务器地址、认证信息或配置文件内容。

界面与开关

Config

在配置管理位置,Config 指向配置文件的查看、选择与管理;在 Global Routing 中,它表示按当前配置处理请求。同一个词必须结合页面判断,不能把“打开 Config 页面”当作“已经启用规则分流”。修改后需要确认文件确实被选用,再验证目标请求。

界面与开关

Proxy / Direct

这是 Global Routing 中的两种整体选择,分别对应代理与直连。Proxy 使用所选代理处理请求,Direct 使用直接连接;它们不是针对单个域名编写的规则。若预期按域名分别处理,却一直使用其中一种整体方式,应先核对 Global Routing,而不是立即重写规则。

界面与开关

On Demand

用于按已配置的条件触发系统 VPN 连接,具体行为取决于应用中的相关设置与系统状态。它不负责修正服务器参数,也不等同于定时更新订阅。排查连接为何再次出现时,应同时核对 On Demand 与系统 VPN 状态,而不是只看刚才是否手动关闭过开关。

界面与开关

Data

用于查看应用记录的流量等统计信息,可辅助了解一段使用过程中的数据变化。应用统计、运营商账单与服务商计量可能采用不同范围和周期,数字不必完全一致。比较前先确认统计起点与对象,不能仅凭一个累计值判断是哪条规则生效。

界面与开关

Settings

应用设置入口,用于核对连接行为与其他应用选项,具体项目以当前应用内显示为准。排查问题时,先记录相关选项的原值,再一次只修改一个变量。应用内的 Settings 与系统“设置”不是同一个入口,教程提到系统授权或电池记录时需要切换位置。

界面与开关

Connectivity Test

用于检查服务器在当前网络下的可达情况,结果适合做排查线索。测试成功不能代替实际请求验证,耗时也不等同于可用带宽或所有网站的响应速度。遇到失败时,先确认本地网络,再核对服务器参数;需要完整顺序可查看连接失败排查说明。

PROTOCOLS

协议与连接参数

协议决定客户端与远端如何通信,不是速度等级。Type 应与用户已有服务器的实际协议一致,不能靠轮流切换协议名来修复连接。

协议

Shadowsocks

一种代理协议,通常需要核对服务器地址、端口、密码与加密方式。加密方式是连接参数的一部分,不能凭名称相近随意替换。导入已有条目后若无法连接,应逐项对照原始信息,特别留意复制密码时是否带入空格或遗漏字符。

协议

VMess

一种使用身份标识等参数的代理协议,地址与端口只是配置的一部分。传输方式以及相关 TLS、路径和主机名设置也需要与服务器一致。某个字段仅在指定传输方式下有意义,排查时应按原始配置核对,不能把其他条目的附加参数直接照搬。

协议

VLESS

一种代理协议,需要让身份标识、传输方式及安全相关参数相互匹配。它与 VMess 是不同的 Type,不能因使用相似的地址或身份标识就互换。导入后仍应核对附加参数是否完整,尤其不要只保留地址、端口便认为配置已经齐全。

协议

Trojan

一种通常结合 TLS 使用的代理协议,认证密码与 TLS 相关信息分别承担不同作用。连接地址能够访问,不代表服务器名称与证书验证也一定正确。出现证书相关错误时,应核对服务器名称、证书和设备时间,不宜把关闭验证作为通用处理步骤。

协议

Hysteria2

一种基于 QUIC 的代理协议,通信依赖当前网络的 UDP 条件。除地址与端口外,还需要核对认证及 TLS 相关参数,不能用其他协议测试成功来直接证明它也可用。切换网络后结果不同,应将网络条件与配置参数分开验证,而不是仅凭协议名称判断原因。

协议

WireGuard

一种基于密钥的隧道协议,配置中的密钥、地址与对端信息具有不同作用。私钥属于敏感凭据,不应随截图、日志或求助消息公开。核对连接时,需要保持本地与对端参数对应;仅导入一段公钥并不能构成完整、可连接的配置。

RULE KEYWORDS

规则关键字

规则回答两个问题:匹配什么、如何处理。匹配关键字与处理策略应分开阅读,同时检查规则顺序和当前 Global Routing。

规则关键字

DOMAIN

按完整域名匹配,用于精确指定某一个域名。针对 example.com 的 DOMAIN 规则,不会自动覆盖 api.example.com 等子域名。若目标是覆盖整个域名及其下级名称,应先判断 DOMAIN-SUFFIX 是否更符合预期。

规则关键字

DOMAIN-SUFFIX

按域名后缀匹配,可覆盖指定域名及其子域名,例如 example.com 与 www.example.com。它不是在完整 URL 中随意寻找字符串,路径也不是该规则的匹配对象。修改后应检查实际命中情况,并确认更早的规则没有先行处理请求。

规则关键字

DOMAIN-KEYWORD

按域名中包含的关键字匹配,通常比完整域名或域名后缀匹配的范围更宽。关键字过短时,可能覆盖原本不打算处理的其他域名。只有确实需要这种宽泛匹配时才使用,并应结合实际请求检查结果,不能把它当作 DOMAIN-SUFFIX 的同义写法。

规则关键字

GEOIP

依据目标 IP 在地理归属数据库中的结果进行匹配,例如 GEOIP,CN,DIRECT。它不按品牌归属或域名后缀判断,结果也可能受到地址变化与数据库内容影响。域名规则与 GEOIP 同时存在时,还要结合解析结果及规则顺序理解最终处理方式。

规则关键字

IP-CIDR / IP-CIDR6

分别用于匹配 IPv4 与 IPv6 地址网段,网络地址和前缀长度共同决定范围。相同地址配上不同前缀长度,可能覆盖完全不同数量的目标。编写前应确认目标地址类型与预期范围;只添加 IPv4 规则,并不表示相应 IPv6 请求也被同一规则覆盖。

规则关键字

FINAL

用于处理前面的规则均未匹配到的请求,通常放在规则末尾作为兜底。FINAL,DIRECT 与 FINAL,PROXY 的处理方向不同,应按自己的配置目标选择。修改 FINAL 不会改变已被前序规则匹配的请求,因此排查时不能只看最后一行。

规则关键字

PROXY / DIRECT / REJECT

它们是规则中的处理策略关键字,分别表示代理处理、直接连接与拒绝请求,不是协议名称。PROXY 不会自动补齐服务器参数,DIRECT 也不代表绕过所有系统网络条件。与界面中的 Proxy、Direct 对照时,应同时看大小写与出现位置,避免把整体模式和单条规则混为一谈。

SUBSCRIPTION & CONFIGURATION

订阅与配置

订阅解决条目从哪里来,配置解决请求如何处理。先确认导入对象,再决定到哪个入口操作,避免把订阅地址填进不相干的字段。

订阅与配置

Subscribe

在 Add Server 中用于导入已有订阅链接的 Type,链接应使用你从自己的服务商处获取的完整内容。订阅可用于获取和更新服务器条目,但不等同于完整的分流配置。链接中可能包含访问凭据,求助时应隐藏敏感部分,不能公开粘贴真实地址。

订阅与配置

Add Server

添加服务器或订阅条目的入口,Type 决定接下来需要填写哪些字段。已有订阅链接时选 Subscribe;手动填写单台服务器时,应选择其实际协议并逐项核对参数。保存只表示条目已写入,还需要选择条目、建立连接并验证请求结果。

订阅与配置

服务器

指客户端连接的远端服务,也常指应用里保存的一条连接配置。一个可用条目需要地址、端口、协议及相应认证信息共同对应,显示名称本身不参与认证。用户可以自行修改备注便于辨认,但不能因此认为远端服务或连接能力已经发生变化。

订阅与配置

[Rule]

配置文件中组织分流规则的段落标记,下面的规则按顺序参与匹配。宽泛规则放在前面,可能使后面的精确规则没有机会生效。修改前先保留原配置,修改后确认启用的是这份文件,并在 Config 路由方式下检查结果。

订阅与配置

DNS

用于将域名解析为 IP 地址,属于连接过程中的一个环节。域名解析成功,不代表后续连接、TLS 验证与规则处理一定成功;反过来,连接失败也不必然是 DNS 问题。排查时应先区分解析错误与连接错误,再检查配置中的相关设置。

STORE & PURCHASE

商店与购买

Shadowrocket 是 Apple 平台的付费闭源商业应用,唯一获取入口是 App Store。应用购买记录、设备上的配置与远端服务权益需要分别核对。

商店与购买

App Store

Shadowrocket 的唯一购买与安装入口,正版核对包括开发者 Shadow Launch Technology Limited、官方图标与应用 ID 932747118。以 iPhone、iPad 使用为主,Mac、Apple TV、Apple Vision 的兼容性与系统要求以 App Store 页面标注为准。购买前可先看正版核对说明。

商店与购买

一次性买断

指为客户端应用支付一次购买费用,美区定价约 2.99 美元,实际金额以 App Store 页面为准,各店面按当地货币显示。客户端一次性买断 ≠ 线路套餐,购买应用不会自动生成服务器信息。后续导入仍以用户已有自己的订阅或服务器信息为前提。

商店与购买

已购项目

在 App Store 中查看账号购买记录并重新下载应用的入口,具体入口名称可能随系统界面调整。换机或重装时应先核对用于商店购买的账号,再查找 Shadowrocket。恢复应用购买与恢复服务器条目是两回事,已有订阅和配置还需分别检查,详见恢复说明。

商店与购买

商店地区

指 Apple 账号用于商店交易的国家或地区设置,会影响应用可见性、显示货币与可用支付方式。它不等同于设备语言,也不能仅凭当前所处位置判断。搜索不到应用时,先核对账号商店地区与产品页可见性,调整前应阅读获取指南中的相关注意事项。

从术语转到具体操作

导入、连接与验证按顺序进行;遇到异常时,先确定问题发生在哪一层,再调整对应设置。