官方手册 · 术语索引

Shadowrocket 术语表

先区分界面入口、协议名称与规则策略,再检查具体参数。本页按五类整理常用词;英文保留应用与配置中的原样写法,中文说明其作用、边界以及容易混淆的地方。

本页以用户已有自己的订阅或服务器信息为前提,只解释客户端用法。需要连续操作步骤时,阅读使用说明;需要配置的完整上下文时,阅读使用手册。

01 · 界面与开关

入口名称与路由模式

连接是否开启、流量按什么方式处理、当前选中哪个服务器,是三个不同的问题。

界面与开关

Home

Home 是查看已有服务器、当前选择与连接状态的主要入口。看到服务器条目只表示信息已导入,不代表认证、网络和远端服务都已验证成功。开始排查时,先记录选中的条目与连接状态,避免一边切换一边判断结果。

界面与开关

Global Routing

Global Routing 用于选择流量处理的全局姿态,包含 Config、Proxy、Direct。它不是连接开关,也不负责把服务器参数补齐。改变此处后,已有规则可能不再按原来的方式参与处理,因此核对规则前应先确认当前姿态。

界面与开关

Config / Proxy / Direct

三种姿态分别为配置、代理、直连:Config 按当前配置处理流量,Proxy 以代理路径为主要处理方式,Direct 以直接连接为主要处理方式。具体系统流量与例外仍要结合实际设置判断。这里首字母大写的界面词,不等于规则行末全大写的策略关键字。

界面与开关

On Demand

On Demand 根据已配置的网络条件触发连接行为,可用于按 Wi-Fi、蜂窝网络等条件组织按需连接。它不是检测到访问失败后自动修复服务器的机制。若手动断开后又出现连接,应检查触发条件与系统状态,而不是只重复操作开关。

界面与开关

Add Server

Add Server 是填写用户已有服务器信息的入口。协议类型、地址、端口和认证字段必须来自同一组有效资料;部分类型还需要传输方式与 TLS 参数。保存成功只说明条目已建立,随后仍应测试连通性并用实际访问确认结果。

界面与开关

Settings

Settings 是查看和调整客户端设置的入口,不应与 Config 中的配置文件混为一谈。排查时先记录选项原值,再一次改变一个与症状相关的设置。同时改动多项会让结果难以复现,也不利于确认究竟是哪一项影响了连接。

02 · 协议

协议名称与参数边界

协议类型应与已有服务器资料一致;名称本身不能说明速度、稳定性或适用网络。

协议

Shadowsocks

Shadowsocks 是一种代理协议,常见参数包括服务器地址、端口、加密方法与密码。加密方法必须与远端设置相符,不能仅因地址正确就认为配置完整。导入后若无法连接,应逐项核对原资料,不要随意替换认证或加密字段。

协议

VMess

VMess 使用对应的身份参数,并可配合不同的传输设置。身份信息相同,不代表传输路径、Host 或 TLS 条件也相同;这些字段需要成套核对。设备时间异常也可能影响认证判断,因此排查时应确认系统时间正常。

协议

VLESS

VLESS 的认证信息与传输设置需要配套使用,不能把它理解为只更换一个协议标签。协议名称本身不说明连接采用哪一种加密保护,仍需检查 TLS 等相关条件。导入已有条目时,应保留原资料中的传输参数与服务器名称。

协议

Trojan

Trojan 通常结合 TLS 使用,需要核对服务器地址、端口、密码及用于验证的服务器名称。用于建立连接的地址与证书对应的名称可能承担不同作用,不应机械地填写成相同内容。遇到证书错误时,应先检查名称、设备时间与证书条件。

协议

Hysteria2

Hysteria2 是基于 QUIC 的代理协议,其连接情况与 UDP 可用性有关。服务器参数完整但当前网络限制了相应传输时,仍可能出现超时。协议名不能保证实际吞吐量;应结合网络条件、认证配置与真实访问结果判断。

协议

WireGuard

WireGuard 是使用密钥对认证对端的隧道协议,配置涉及本地地址、密钥与对端信息。公钥、私钥和预共享密钥的用途不同,不能互换填写。分享排查资料时应隐藏私钥等敏感内容,并检查地址范围与路由设置是否符合已有配置。

协议

HTTP / SOCKS5

HTTP 与 SOCKS5 是不同的代理协议,不能因为地址、端口相同就互相替换。是否需要认证、是否有额外加密保护,以及可处理的流量类型,都要结合具体配置确认。使用时应按已有服务器资料选择类型,而不是按名称推断功能。

03 · 规则关键字

匹配条件与处理策略

关键字回答“匹配什么”,策略回答“如何处理”;顺序决定哪一条规则先产生作用。

规则关键字

[Rule]

[Rule] 是配置中的规则段,规则按从上到下的顺序检查,命中后使用对应策略。范围较大的规则如果放在前面,可能使后面的精细规则没有机会生效。修改前先确认 Global Routing 为 Config,并备份当前配置。

规则关键字

DOMAIN / DOMAIN-SUFFIX

DOMAIN 用于匹配一个完整域名,DOMAIN-SUFFIX 用于匹配指定域名及其子域名。后缀不是网页路径,也不是任意字符串搜索。若只想处理一个明确的主机名,应先考虑精确匹配,避免把整个域名范围一并纳入。

规则关键字

DOMAIN-KEYWORD

DOMAIN-KEYWORD 按域名中包含的字符串进行匹配,覆盖范围可能比预期更大。相同字符串可能出现在多个互不相关的域名里,因此它不等于域名后缀匹配。用于拒绝规则时尤其应检查命中记录,防止误处理正常请求。

规则关键字

IP-CIDR / IP-CIDR6

IP-CIDR 与 IP-CIDR6 分别按 IPv4、IPv6 网段匹配,斜杠后的数字表示前缀长度。它们判断的是地址范围,不是域名文本。一个服务可能使用多组地址,核对规则时不能只根据一次解析结果推断所有请求都会命中。

规则关键字

GEOIP

GEOIP 依据 IP 地理归属数据库进行匹配,不代表设备或使用者的实际所在地。数据库归属与服务运营位置也不一定相同,分布式服务可能涉及多个地区的地址。判断分流结果时,应同时检查目标地址、数据库信息与规则顺序。

规则关键字

FINAL

FINAL 为前面均未命中的流量指定兜底策略,通常放在规则段末尾。它不是“最后再连接一次”,也不表示根据速度自动选择路径。调整它会改变所有未被前面规则覆盖的流量,因此应明确兜底目标后再修改。

规则关键字

PROXY / DIRECT / REJECT

这三个全大写词是规则中的处理策略:PROXY 交给代理路径,DIRECT 直接连接,REJECT 拒绝匹配流量。它们不是服务器协议名,也不负责提供认证参数。策略要与规则条件一起阅读,才能判断具体请求为何被这样处理。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
04 · 订阅与配置

条目、文件与购买记录

服务器列表、路由配置和 App Store 购买记录分别保存不同信息,不能互相替代。

订阅与配置

订阅

订阅通常是用于获取或更新一组服务器条目的地址,前提是用户已有自己的有效订阅。它不一定包含完整路由规则,导入订阅与启用 Config 是不同操作。订阅地址可能包含访问凭据,不应在公开截图、日志或求助文本中完整展示。

订阅与配置

服务器

服务器条目保存远端地址、协议、端口与认证等信息,列表条目也常被称为节点。条目的显示名称只是识别标签,不能据此确认真实地区、速度或服务状态。判断是否可用,应检查实际参数、连通性与服务有效条件,而不是只看名称。

订阅与配置

Config 配置文件

配置文件承载通用选项、规则等设置,与服务器列表分别管理。界面中的 Config 入口与 Global Routing 中的 Config 姿态使用同一个词,但前者涉及文件管理,后者表示按配置处理流量。导入文件后,应确认启用的是哪一份配置。

订阅与配置

[General]

[General] 是配置中的通用设置段,可涉及 DNS、系统流量处理与跳过代理的地址等选项。它与 [Rule] 的用途不同,不能把规则行随意放入此段。复制局部示例时,应同时核对所属段落、字段语法和现有设置的影响。

订阅与配置

Scan QR Code

Scan QR Code 通过二维码读取配置内容,二维码本身只是数据载体。扫描结果可能是一条服务器信息,也可能是需要进一步处理的地址,应先确认内容类型。导入成功后仍需核对协议与参数,含认证信息的二维码也应按敏感资料保存。

订阅与配置

已购项目

已购项目是 App Store 中查找原购买记录的入口,换机或重新安装时应先核对原购买账户。购买记录不是客户端配置备份,重新获取应用不等于自动恢复所有服务器与规则。iPhone 与 iPad 的购买适用范围,以 App Store 页面标注为准。

05 · 连接与诊断

测试结果与实际访问

先判断是解析、连接、认证还是规则问题;一个测试数字不能替代完整的访问链路。

连接与诊断

DNS

DNS 将域名解析为地址,是访问链路中的一个环节。解析成功不代表服务器认证成功,解析失败也不一定表示代理服务器离线。若只有部分域名异常,应分别检查 DNS 设置、返回地址、缓存与相关规则,避免直接改动所有服务器条目。

连接与诊断

Connectivity Test

Connectivity Test 按当前测试方法检查连通性,结果与测试目标、网络及当时的服务器状态有关。测试通过不保证每个网站、每类请求都能正常处理;测试失败也需要结合日志判断原因。比较多个条目时应保持测试方法与网络条件一致。

连接与诊断

延迟

延迟描述测试请求在特定条件下得到响应所需的时间,不等于传输带宽。较低数值不能保证大文件传输或长连接表现更好,丢包、拥塞和远端负载同样会影响体验。选择已有服务器时,应结合重复测试与实际访问,而不是只按一次结果排序。

连接与诊断

Data

Data 用于查看流量记录及相关信息,可辅助检查目标、规则与连接行为。统计口径取决于具体视图,不能直接将其中的数字当作服务端结算流量。定位问题时应围绕同一次操作对照记录,分享前隐藏目标地址与认证等敏感信息。

连接与诊断

TLS

TLS 是用于保护传输连接的机制,服务器名称、证书信任条件与设备时间都会影响验证。连接地址能响应,不代表证书验证就会通过。出现错误时应核对原配置中的名称及证书条件,不宜将跳过验证作为日常排查的默认处理方式。

连接与诊断

VPN 配置授权

VPN 配置授权是 Apple 系统允许客户端建立网络隧道所需的授权,首次连接时可能出现系统确认。授权完成只说明系统允许建立该配置,不证明已有服务器能够连接。即使系统显示连接状态,也应进一步确认 DNS、路由策略与实际访问结果。

按问题继续查阅

条目已导入但不能使用时,按“服务器参数 → VPN 配置授权 → Global Routing → DNS → 具体规则”的顺序缩小范围。每次只改变一个条件,并保留可以恢复的原配置,才能把测试结果与改动对应起来。

  • 首次导入与连接:查看使用说明,依次完成添加、选择、连接与验证。
  • 规则顺序与日常维护:查看使用手册,结合完整配置理解局部规则。
  • 购买、已购恢复与正版核验:查看App Store 正版核验说明。
  • 专题操作与排查:查看技术笔记,再回到对应术语核对概念。

界面中的可用字段可能随设备与应用实际状态有所差异,以当前应用显示为准。本页解释术语,不替代已有服务的参数说明;涉及系统要求与购买范围时,以 App Store 页面标注为准。