官方手册 / 概念索引

Shadowrocket 术语表

按界面词定位设置,按协议核对参数,按规则关键字理解请求去向。英文名称保留原文,中文解释用于区分概念与操作范围。

阅读顺序:Global Routing → Config → 规则 → 策略动作。导入前请准备好自己已有的订阅或服务器信息。

INTERFACE / 07

界面与开关

先确定正在调整连接触发条件、整体路由姿态,还是某一条服务器参数。这几类设置不能互相替代。

界面与开关

Global Routing

这是决定请求整体处理方式的设置,包含 Config、Proxy、Direct 三种姿态。中文说明分别称为配置、代理、直连,但操作时应认准英文界面词。切换姿态会改变请求去向,不会替你补齐服务器认证信息,也不能单独证明网络已恢复。

界面与开关

Config

在 Global Routing 中,Config 表示依据当前配置的规则处理请求,命中规则后可能使用代理、直接访问或拒绝连接。它不表示所有请求都会使用代理。排查分流时,先确认正在使用的配置文件,再检查规则顺序与最终命中的策略。

界面与开关

Proxy

这是 Global Routing 中将可代理请求交给当前代理选择处理的姿态,可用于对照规则分流与代理路径的差异。它与规则末尾的 PROXY 策略不是同一个设置层级。即使选中 Proxy,远端认证、TLS 与本地网络仍需正常,不能只看开关判断连接成功。

界面与开关

Direct

这是 Global Routing 中使用本地网络直接访问目标的姿态,可用来对照本地网络与代理路径。直接访问能否成功,取决于当前网络、目标服务和域名解析结果。它不是删除服务器记录,也不意味着配置文件中的 DIRECT 规则已经被验证。

界面与开关

On Demand

On Demand 用于根据预设网络条件触发连接,例如针对 Wi-Fi 或 Cellular 设置相应行为。它回答“何时建立连接”,而 Global Routing 回答“请求如何处理”。遇到手动断开后再次连接的情况,应先核对触发条件,再判断是否需要调整该功能。

界面与开关

Add Server

这是手动填写服务器信息的入口,第一步应选择与已有参数一致的协议。不同协议使用的认证字段、传输字段和安全设置并不相同,不能只复制地址与端口。保存前逐项对照服务商提供的信息,尤其注意 UUID、密码、TLS 与服务器名称的对应关系。

界面与开关

Data

Data 用于查看流量统计,阅读时需要同时确认统计对象与统计时段。客户端记录与服务端计费统计可能采用不同口径,因此数值不必完全一致。流量有增长只说明存在数据传输,还需要结合实际访问结果判断目标请求是否成功。

PROTOCOL / 06

协议

协议名决定参数的解释方式,不代表固定的速度或质量。使用哪一种,应以用户已有服务器所提供的协议与完整参数为准。

协议

Shadowsocks

Shadowsocks 使用服务器地址、端口、密码与加密方法等参数建立代理连接。加密方法必须与服务端对应,名称相近也不能任意替换。若条目能够保存但无法连接,应先检查密码与加密方法,再检查地址、端口及网络可达性。

协议

VMess

VMess 使用 UUID 等参数进行身份认证,并可配合不同传输方式。UUID 正确并不代表其余字段都正确,路径、Host 与 TLS 等设置仍需逐项匹配。不要把同一地址下另一种协议的字段直接套用过来,导入后也应按原始信息复核。

协议

VLESS

VLESS 使用 UUID 进行身份认证,其协议本身不承担传输内容加密,需结合 TLS 等实际安全层理解连接方式。填写时还要核对传输类型、服务器名称及服务端要求的附加字段。协议名称一致只是前提,整组参数对应才可能建立可用连接。

协议

Trojan

Trojan 通常在 TLS 连接上使用密码认证,密码与证书校验分别属于不同检查环节。服务器地址用于连接,TLS 中的服务器名称用于标识,二者不一定是同一段文本。遇到证书错误时,应核对名称、设备时间与服务端证书,而不是直接关闭校验。

协议

Hysteria2

Hysteria2 基于 QUIC,通常需要本地网络与远端之间存在可用的 UDP 路径。认证信息、TLS 与服务端要求的其他字段都需要对应。若同一组参数在不同网络下表现不同,应分别检查网络路径与参数,不能仅凭协议名判断持续传输速度。

协议

WireGuard

WireGuard 是通过密钥识别对端的隧道协议,通常需要配套的接口地址、对端信息和路由范围。私钥属于敏感信息,不应随诊断截图或配置文本公开。参数缺失时,应向已有服务的信息提供方核对,不能把公钥与私钥互换,也不能随意填写接口地址。

RULE KEYWORDS / 08

规则关键字

规则通常由匹配条件和处理策略组成。以下片段仅解释语法,example.com 为示例域名,不表示需要实际连接的服务器。

匹配条件

DOMAIN

DOMAIN 按完整域名匹配请求,适合只对一个明确主机名设置策略。匹配 example.com 不等于自动匹配其全部子域名。规则中的域名不应包含协议前缀或网页路径,否则会把网址与域名这两个概念混在一起。

DOMAIN,example.com,PROXY
匹配条件

DOMAIN-SUFFIX

DOMAIN-SUFFIX 按域名后缀匹配,可以覆盖根域名及其子域名,适合为同一域名体系设置统一策略。它不是任意字符串包含匹配。若只需要调整某一个主机,应优先考虑更精确的条件,并把具体规则放在可能覆盖它的宽泛规则之前。

DOMAIN-SUFFIX,example.com,PROXY
匹配条件

GEOIP

GEOIP 根据 IP 地理数据库的区域标记匹配目标地址,并不是根据网页显示内容或使用者所在位置判断。数据库归类可能与实际服务部署存在差异,解析到不同地址也可能得到不同结果。排查时应记录目标 IP 与数据库信息,避免只按域名印象推断。

匹配条件

IP-CIDR

IP-CIDR 用 CIDR 表示法匹配 IPv4 地址范围,例如 192.168.0.0/16 表示一段私有地址范围。斜杠后的数字是前缀长度,不是端口。IPv6 地址范围使用 IP-CIDR6;填写时应确认地址族与范围,避免把局部调整扩大到不相关的目标。

IP-CIDR,192.168.0.0/16,DIRECT
兜底条件

FINAL

FINAL 为未命中前序规则的请求指定最终策略,通常放在规则序列末尾。它不是额外增加一次连接,而是为剩余请求决定处理方式。修改 FINAL 会影响较大范围,应先明确哪些目标需要单独匹配,再调整兜底策略并验证实际访问结果。

FINAL,PROXY
策略动作

PROXY

PROXY 是规则中交给代理处理的策略动作,通常写在匹配条件之后。它与 Global Routing 里的 Proxy 分属规则层和整体姿态层。命中 PROXY 后仍需有可用的代理选择,规则本身不包含账号权益,也不能让失效的服务器恢复连接。

策略动作

DIRECT

DIRECT 表示匹配请求使用本地网络直接访问目标,不经过所选远端代理服务器。它只决定路径,不保证目标服务一定可访问。局域网目标可按实际网段设置相应规则,但应先确认网段范围,避免因宽泛条件改变其他请求的处理方式。

策略动作

REJECT

REJECT 表示拒绝匹配的请求,适合用于明确需要阻止的目标。若应用部分功能突然不可用,应检查是否有请求被过宽的拒绝规则命中。排查时先缩小匹配范围并记录变化,不要把拒绝结果误判为服务器延迟或 DNS 故障。

SUBSCRIPTION & CONFIG / 05

订阅与配置

服务器订阅解决“有哪些服务器信息”,配置文件解决“怎样处理请求”。先辨认导入内容的类型,再判断更新是否改变了当前连接或规则。

订阅与配置

Subscribe

Subscribe 指通过已有订阅地址读取并更新服务器信息的方式,地址由用户自己的服务商提供。订阅地址可能包含访问凭据,不应公开粘贴或展示。更新成功只说明内容读取完成,服务器是否有效仍取决于信息准确性、服务状态和当前网络。

订阅与配置

SERVER

SERVER 所指的服务器条目通常包含地址、端口、协议与认证字段;中文说明中的“节点”常指这样的条目。名称只是用于辨认,不能作为速度或可用性的证据。列表中出现记录不等于连接已经建立,应继续核对选择状态并进行实际访问验证。

订阅与配置

配置文件

配置文件是组织规则、DNS 等设置的载体,与只更新服务器列表的订阅有不同职责。导入某个文件后,还需要确认它是否成为当前使用的配置。替换前保存原配置,并检查规则和相关设置的变化,避免把配置切换造成的差异误判为服务器异常。

订阅与配置

规则

规则把匹配条件与策略动作连接起来,通常按照顺序检查并由先命中的条件决定处理方式。精确条件和宽泛条件的排列会直接影响结果。修改时一次只改一项,并用同一个目标验证;否则即使恢复访问,也难以知道究竟是哪次调整生效。

订阅与配置

iCloud 同步

iCloud 同步依赖账号、系统权限、网络以及应用内相应设置,支持同步的数据范围应以实际界面说明为准。同步不是购买恢复,也不等于全部运行状态会在设备之间复制。更换设备前,另行保存必要配置,并确认目标设备确实收到所需数据。

SYSTEM & NETWORK / 04

系统与网络

系统授权、解析结果、测试读数与购买记录分别属于不同环节。排查时逐层确认,比反复切换连接开关更容易定位问题。

系统与网络

DNS

DNS 把域名解析为 IP 地址,解析是否成功与代理传输是否成功需要分别检查。延迟测试有结果而网页打不开时,仍可能存在解析失败或解析结果不适用的情况。调整前记录现有 DNS 设置,并用同一域名复测,不要同时修改服务器与多项解析设置。

系统与网络

延迟

延迟是在指定测试方法和目标下得到的响应时间,不等同于持续下载速度或完整网页加载时间。不同测试方式得到的数值不能直接混在一起比较。低延迟也不保证认证、TLS、DNS 和目标访问全部正常,应结合 Connectivity Test 与真实请求结果判断。

系统与网络

VPN 配置

首次连接时,Apple 系统可能请求允许添加 VPN 配置,这是系统管理网络扩展连接所需的配置记录。它与远端服务器的地址、密码或订阅有效期不是一回事。误删后应返回 Shadowrocket 按提示重新授权,再检查当前服务器选择和实际访问结果。

系统与网络

已购项目

已购项目是 App Store 中查找当前购买账号历史应用记录的入口,可用于换机或重装时确认购买记录。恢复应用不会自动恢复全部服务器参数,配置数据仍需单独确认。Shadowrocket 只通过 App Store 获取,系统要求与设备适用性以 App Store 页面标注为准。