官方手册 · 名称与含义

Shadowrocket 术语表

先分清界面选项、协议、匹配条件与执行策略,再阅读配置。以下保留英文原文,解释各名称在 Shadowrocket 中的作用,以及不能仅凭名称推断的内容。

Interface

界面与开关

页面名称表示操作入口,不表示连接已经成功。检查问题时,应把当前选择、连接状态与实际请求结果分开观察。

界面与开关

Home

Home 是集中查看服务器条目与连接入口的页面。列表中已有条目,只说明信息已经保存,不代表该条目当前可用或 VPN 已建立。首次使用时,先核对选中的条目和 Global Routing,再启动连接,避免把列表选择与实际连接状态混为一谈。

界面与开关

Global Routing

Global Routing 决定整体流量处理方式,配置、代理、直连分别对应界面中的 Config、Proxy、Direct。Config 按当前配置进行处理,Proxy 与 Direct 分别采用整体代理与整体直连的处理方式。排查规则没有生效时,应先核对这里的选择;修改 Rule 不会替代整体模式选择。

界面与开关

On Demand

On Demand 用于按照已设置的条件触发 VPN 连接行为,而不是给每个域名指定去向。它与分流规则处于不同层次,也不会补齐服务器缺失的认证参数。若连接在手动关闭后又被触发,应检查当前启用的 On Demand 条件,再判断是否需要调整。

界面与开关

Add Server

Add Server 是手动录入用户已有服务器信息的入口。应先选择对应协议,再逐项填写地址、端口及认证信息;传输方式和 TLS 选项也要与服务端一致。保存成功只代表表单已被接受,后续仍需测试连接,不能把任意一组参数直接套用到另一种协议。

界面与开关

Connectivity Test

Connectivity Test 按当前测试方式检查条目的可达性,测试中的延迟读数反映特定条件下的响应时间。它不是持续下载速度,也不代表所有网站或应用请求都能成功。比较结果时应使用相同测试方式和网络环境;单次超时还需结合 DNS、认证与目标地址继续排查。

界面与开关

Data

Data 用于查看流量统计,读数要结合所选视图、统计周期与当前连接情况理解。上传与下载方向不同,按服务器观察和按应用观察也不一定得到相同的汇总口径。数字为零时先确认请求是否经过被观察的连接,不要仅凭统计值判断某个服务是否正常。

界面与开关

DNS

DNS 是将域名解析成 IP 地址的机制,解析通常发生在建立目标连接之前。域名能够解析不代表目标服务一定可达,解析失败也不等于服务器密码有误。排查时应区分解析阶段与连接阶段,并结合当前配置中的 DNS 设置判断,而不是同时改动多个无关选项。

Protocols

协议

协议规定客户端与服务器如何通信,不决定规则的匹配顺序。以下说明以用户已有自己的服务器信息为前提,参数应按服务端实际配置核对。

协议

Shadowsocks

Shadowsocks 使用约定的加密方法与密码建立代理连接。客户端中的方法、密码、服务器地址及端口都需要与服务端一致,不能只根据名称相同就判断兼容。若已有信息还包含插件或其他传输参数,应按对应字段核对;改变加密方法本身不会修复地址填写错误。

协议

VMess

VMess 使用用户标识等参数进行认证,连接信息还可能包含传输方式与 TLS 设置。用户标识正确并不代表连接参数完整,主机名、路径等字段也可能参与连接。导入后应检查各字段是否与原始信息一致,不要把协议名称、传输方式与安全层当成同一项设置。

协议

VLESS

VLESS 使用用户标识进行认证,实际连接还取决于传输层与安全层参数。名称相近的协议不能直接互换,已有服务器采用什么协议,就应选择对应类型。遇到连接失败时,需要分别核对用户标识、传输方式和安全设置,不能仅凭某一项已填写就判断整条记录正确。

协议

Trojan

Trojan 通常结合 TLS 建立连接,并使用密码完成认证。除地址和端口外,还应核对密码、用于 TLS 的主机名及证书是否匹配。证书错误与认证失败属于不同问题;应先确认正确的主机名和证书配置,而不是把跳过证书验证当成常规处理方法。

协议

Hysteria2

Hysteria2 是基于 QUIC 的代理协议,连接依赖 UDP 可达性以及正确的认证与 TLS 参数。协议名称本身不构成速度保证,不同网络中的表现需要实际测试。排查时先确认已有服务器使用的确实是 Hysteria2,再核对端口、认证内容、主机名与当前网络对 UDP 的支持情况。

协议

WireGuard

WireGuard 使用公私钥建立加密隧道,配置中通常需要区分本端信息与对端信息。对端公钥、端点地址、隧道地址与允许的路由范围各有作用,不能互相替代。私钥属于敏感凭据,提供排查材料时应移除;隧道已建立也仍需确认路由与 DNS 是否符合预期。

协议

HTTP / SOCKS5

HTTP 与 SOCKS5 是两种不同的代理协议,录入时应选择服务器实际支持的类型。协议名称本身不代表所有通信都经过加密,代理连接的保护方式与目标网站使用的 HTTPS 需要分别理解。若服务端要求用户名和密码,应完整填写,不能因地址和端口正确就省略认证。

Rules & Policies

规则关键字与策略

规则先描述匹配对象,再指定命中后的动作。顺序会改变结果:通常首条命中即停止,具体规则应放在宽泛规则之前,FINAL 放在最后。

规则关键字与策略

Rule

Rule 指配置中的规则部分,文本配置以 [Rule] 标识该段。规则通常从上到下检查,命中后采用该条指定的策略,不再继续查找后面的普通规则。修改前应先确认正在使用的 Config,并保留原配置;只编辑一个未启用的文件不会改变当前请求的处理方式。

规则关键字与策略

DOMAIN

DOMAIN 用于匹配完整域名,例如 DOMAIN,example.com,DIRECT 只描述对该域名的匹配。它不会自动把所有子域名纳入相同规则,子域名应另写条件或改用合适的后缀规则。域名字段不应填入带路径的完整网页地址,否则匹配对象就与规则类型不符。

规则关键字与策略

DOMAIN-SUFFIX

DOMAIN-SUFFIX 按域名后缀匹配,通常同时覆盖指定域名与其子域名。示例 DOMAIN-SUFFIX,example.com,PROXY 可说明这一范围,但它不是在任意网址字符串中寻找相同文字。需要让某个子域名采用不同策略时,应把更具体的 DOMAIN 规则排在这条规则之前。

规则关键字与策略

DOMAIN-KEYWORD

DOMAIN-KEYWORD 检查域名中是否包含指定关键词,匹配范围通常比精确域名或后缀更宽。短词可能出现在多个无关域名中,因此不适合用来替代已知的准确域名条件。若某条规则意外影响其他请求,应检查关键词范围及它在 Rule 中的位置,再决定是否缩小条件。

规则关键字与策略

IP-CIDR / IP-CIDR6

IP-CIDR 与 IP-CIDR6 分别按 IPv4、IPv6 网段匹配目标地址,斜杠后的前缀长度决定网段范围。例如 IP-CIDR,192.168.0.0/16,DIRECT 描述一个 IPv4 网段条件。它们匹配的是地址而非域名文字,是否需要先进行解析,还应结合规则参数与当前 DNS 行为判断。

规则关键字与策略

GEOIP

GEOIP 依据 IP 地理数据库中的地区归属匹配目标地址,例如 GEOIP,CN,DIRECT。它不会分析网页内容、域名后缀或用户所在位置,数据库归属也可能与实际服务部署情况存在差异。已知域名需要固定策略时,可以使用更具体的域名规则并放在 GEOIP 之前。

规则关键字与策略

FINAL

FINAL 是此前规则均未命中时采用的兜底规则,应放在 Rule 段最后。例如 FINAL,PROXY 表示把剩余请求交给 PROXY 策略处理。FINAL 不是对前面规则结果进行二次覆盖,也不保证代理连接可用;如果它提前出现,后面的规则就无法承担预期的匹配作用。

规则关键字与策略

PROXY / DIRECT / REJECT

PROXY、DIRECT、REJECT 是规则中的策略名称,分别表示交由代理策略处理、直接连接和拒绝请求。这里的全大写关键字与 Global Routing 中的 Proxy、Direct 界面选项属于不同层次。PROXY 不包含具体服务器凭据,DIRECT 也不等于关闭整个 VPN;实际动作仍需结合当前模式与配置理解。

Subscribe & Config

订阅与配置

订阅主要管理连接条目,配置主要描述处理行为。导入、保存、选中与实际启用是不同动作,应分别核对结果。

订阅与配置

Subscribe

Subscribe 通过用户已有的订阅地址导入或刷新服务器条目,内容由对应地址的返回结果决定。更新可能增加、修改或移除条目,因此更新前后应检查当前选择是否仍然存在。订阅导入不等于完整分流配置导入;链接可能含访问凭据,排查时不要公开完整地址。

订阅与配置

SERVER

SERVER 表示连接目标及其参数组成的服务器条目,通常包括协议、地址、端口、认证与传输设置。条目的显示名称只是便于识别的标签,不能证明实际部署位置或可达性。检查用户已有信息时应以具体字段为准,并区分手动创建的条目与订阅管理的条目,避免刷新后误判修改结果。

订阅与配置

Config

Config 既是保存和选择配置的界面名称,也是 Global Routing 中按配置处理流量的选项。配置文件可以包含 General、Rule 等段,用来描述不同层面的行为。文件已经保存不等于已被选中,选中文件也应结合 Global Routing 判断;排查时先确认实际启用的是哪份配置。

订阅与配置

URL Rewrite

URL Rewrite 根据匹配表达式重写请求地址等内容,与决定连接去向的路由规则不同。是否能够处理某个请求,取决于匹配范围和请求是否满足相应处理条件,不能仅凭规则存在就认定已经执行。修改前应理解表达式与替换目标,涉及加密请求时还要单独核对相关处理条件。

App Store

App Store 与购买

应用购买、设备兼容性和连接信息分别核对。Shadowrocket 是闭源商业应用,商店中的购买记录不包含用户的服务器配置。

App Store 与购买

App Store

App Store 是 Shadowrocket 唯一的购买与安装入口,主要使用设备为 iPhone 与 iPad。Mac、Apple TV、Apple Vision 的兼容性也可在同一产品页查看,系统要求与购买适用范围一律以 App Store 页面标注为准。本站的获取应用说明集中列出核对步骤。

App Store 与购买

正版核对

正版核对应同时检查官方图标、开发者 Shadow Launch Technology Limited 与应用 ID 932747118。应用 ID 可在产品页地址中的 id932747118 核对,不能只凭搜索结果里的名称相近作判断。官方图标应与本站页头所用图标一致,三项信息应一起确认。

App Store 与购买

已购项目

已购项目是查找应用购买记录并重新下载的入口,应使用购买时的 Apple ID 查看。重新下载应用与恢复应用内配置是两件事,服务器条目和配置内容仍需从自己的备份或已有信息恢复。找不到记录时先核对购买账户及商店状态,具体恢复路径见已购恢复说明。

App Store 与购买

一次性买断

一次性买断指应用本身的一次性购买,美区定价为 $2.99,实际价格以 App Store 页面为准,各店面按当地货币显示。客户端一次性买断 ≠ 线路套餐,购买应用不会自动生成可用的服务器信息。连接前仍需导入用户已有自己的订阅或服务器参数,购买适用范围以商店页标注为准。