Shadowrocket 官方手册 · 概念速查

Shadowrocket
界面、协议与规则术语

先分清术语所属层级,再修改对应设置。这里按五类解释常用概念;每个词条都可通过标题旁的链接直接定位。

30 个术语 界面词保留英文 操作步骤见教程 →

入口与整体行为

界面与开关

界面名称用于定位操作,Global Routing 则决定整体处理方式。相似的词在不同位置可能承担不同职责,尤其要区分 Config 页面、Config 模式与配置文件。

界面与开关 · 主要入口

Home,词条直达链接

Home 是查看服务器条目、选择连接对象与操作连接开关的主要入口。列表中出现服务器,只能说明客户端保存了相关参数,并不等于连接已经建立。首次使用应先核对选中条目,再观察开关与连接状态,最后用实际请求验证。

界面与开关 · 路由模式

Global Routing,词条直达链接

Global Routing 决定请求采用哪一种总体处理方式,三个常见选项为配置(Config)、代理(Proxy)、直连(Direct)。它们是路由模式,不是服务器协议,也不是三个不同的连接账户。检查规则是否生效之前,应先确认当前模式是否为 Config。

界面与开关 · 同名概念

Config,词条直达链接

在 Global Routing 中,Config 表示依据当前配置处理请求,规则可以把不同目标交给不同策略。作为页面名称时,Config 是管理配置文件的入口,而不是一个连接模式开关。阅读操作步骤时,要先看文案指的是“选择 Config 模式”还是“打开 Config 页面”。

界面与开关 · 代理模式

Proxy,词条直达链接

Proxy 是 Global Routing 中的代理模式,用于让请求按代理模式处理。它不表示服务器采用哪种协议,也不要与规则末尾大写的 PROXY 策略混为一谈。排查单个网站的分流结果时,应同时记录当前路由模式与选中的服务器,避免把模式差异误判为规则错误。

界面与开关 · 直连模式

Direct,词条直达链接

Direct 是 Global Routing 中的直连模式,表示请求采用直连方式。它与规则里的 DIRECT 策略含义相关,但作用层级不同:前者是整体模式,后者是某条规则匹配后的动作。切换到 Direct 可以帮助观察直连条件下的表现,但不能据此判断服务器认证参数是否正确。

界面与开关 · 连接触发

On Demand,词条直达链接

On Demand 是按配置条件触发系统 VPN 连接的机制,关注的是何时建立连接。它不负责选择某个域名应走哪条规则,也不能修复错误的服务器密码或地址。建议先确认手动连接正常,再逐项配置触发条件;具体选项见On Demand 设置参考。

界面与开关 · 参数录入

Add Server,词条直达链接

Add Server 是手动录入服务器信息的入口,需要先选择与已有信息一致的类型,再填写地址、端口和认证等参数。不同协议所需字段不同,不能把一套字段直接套用到另一种协议。保存条目只代表完成录入,仍需选择该条目并进行连接验证。

连接参数的技术含义

协议

协议决定客户端与服务器如何交换数据。以下解释用于辨认参数,不构成选择服务的建议;填写内容应与用户已有的服务器配置逐项对应,不能仅凭协议名称推断连接质量。

协议 · 加密与认证参数

Shadowsocks,词条直达链接

Shadowsocks 采用加密方式保护客户端与服务器之间的代理通信,常见核心参数包括地址、端口、密码与加密方式。加密方式必须与服务器一致,名称相近也不能视为可以互换。若已有配置还包含额外传输参数,应一起核对,不能只凭密码正确就认定配置完整。

协议 · UUID 与传输

VMess,词条直达链接

VMess 使用 UUID 等参数进行用户识别与认证,连接还可能结合不同传输方式及 TLS 设置。UUID 正确不代表整组配置正确,地址、端口、传输路径与相关主机名同样需要一致。设备时间明显不准确也可能影响认证,排查时应先检查系统时间再逐项核对字段。

协议 · 身份与安全层

VLESS,词条直达链接

VLESS 是使用 UUID 进行身份识别的轻量代理协议,协议本身不提供内容加密。实际连接的安全属性取决于采用的传输与安全层配置,不能把 UUID 当作加密方式。录入时应按已有参数核对安全选项、传输方式与相应字段,不要因为字段相似而直接照搬 VMess 配置。

协议 · TLS 与密码

Trojan,词条直达链接

Trojan 通常结合 TLS 并使用密码认证,服务器地址与用于证书校验的名称需要分别理解。SNI 用于 TLS 握手中的服务器名称,可能与连接地址的写法不同,应以已有配置为准。遇到证书错误,应检查名称、设备时间与服务器证书,不应把关闭证书校验当作常规处理办法。

协议 · QUIC 与 UDP

Hysteria2,词条直达链接

Hysteria2 是基于 QUIC 的代理协议,依赖 UDP 传输,认证与 TLS 相关字段需按服务器配置填写。当前网络对 UDP 的支持情况会影响握手和数据传输,普通延迟测试有结果并不能证明此协议一定可用。排查时应把网络传输条件与认证参数分开检查。

协议 · 密钥与隧道

WireGuard,词条直达链接

WireGuard 使用公私钥进行身份认证,并通过 UDP 传输隧道数据,配置还涉及接口地址、对端信息与路由范围。私钥属于敏感凭据,不应出现在公开截图或求助内容里。排查连接时,应核对密钥配对、对端地址和路由范围,而不是按密码型协议的思路只检查一个认证字段。

协议 · 代理服务器类型

HTTP,词条直达链接

HTTP 在服务器类型中指 HTTP 代理,客户端向代理服务器提交转发请求,部分连接会使用 CONNECT 建立隧道。此处的 HTTP 与目标网页地址使用哪一种协议是不同概念,不能看到 HTTPS 网页就据此修改服务器类型。代理连接是否启用 TLS,也需要查看实际服务器参数。

协议 · 通用代理转发

SOCKS5,词条直达链接

SOCKS5 是通用代理协议,可提供 TCP 转发,以及由实现和服务器能力决定的 UDP 转发。协议本身不等于加密通道,用户名与密码认证也不能替代传输加密。配置时应核对服务器是否要求认证,并区分“能够连接代理端口”和“能够完成目标请求”这两个结果。

先匹配条件,再执行策略

规则关键字

规则描述“哪些请求符合条件”,策略描述“符合条件后如何处理”。常见规则按顺序匹配,应把更具体的条件放在需要优先处理的位置,并检查末尾的最终策略。

规则关键字 · 精确域名

DOMAIN,词条直达链接

DOMAIN 按完整域名精确匹配,例如 DOMAIN,example.com,DIRECT 针对的是 example.com。它不会自动包含 www.example.com 等子域名,也不匹配网页路径。若目标是整个域名及其子域名,应考虑 DOMAIN-SUFFIX,而不是给 DOMAIN 填入完整网页地址。

规则关键字 · 域名后缀

DOMAIN-SUFFIX,词条直达链接

DOMAIN-SUFFIX 按域名后缀匹配,包含指定域名及其子域名,适合把同一域名范围交给同一策略。比如 DOMAIN-SUFFIX,example.com,PROXY 可匹配 example.com 与其子域名。一个页面可能请求多个其他域名,因此匹配主站域名并不表示页面所有资源都会采用相同策略。

规则关键字 · 字符串条件

DOMAIN-KEYWORD,词条直达链接

DOMAIN-KEYWORD 匹配域名中包含指定字符串的请求,范围通常比精确域名或域名后缀更宽。字符串出现在不相关域名中时也可能命中,因此不宜把短词当作站点范围的可靠边界。使用后应结合请求记录检查实际命中目标,必要时改用更明确的 DOMAIN 或 DOMAIN-SUFFIX。

规则关键字 · IP 归属

GEOIP,词条直达链接

GEOIP 依据目标 IP 在地理数据库中的归属进行匹配,不是按网页所用的文字、公司名称或域名后缀判断位置。域名解析结果变化时,命中的 IP 规则也可能随之改变,数据库记录还可能与实际部署存在差异。检查这类规则时,应一起查看解析结果、规则顺序与最终采用的策略。

规则关键字 · 地址范围

IP-CIDR,词条直达链接

IP-CIDR 用 CIDR 表示法匹配 IPv4 地址范围,斜杠后的前缀长度决定网段范围,例如 192.0.2.0/24。IPv6 地址范围使用 IP-CIDR6,不应把两类地址混填。网段规则针对地址而非网页路径,同一地址承载多个域名时,需要注意规则可能覆盖的实际请求范围。

规则关键字 · 最终策略

FINAL,词条直达链接

FINAL 为前面的规则都未匹配的请求指定最终策略,通常应放在规则末尾。比如 FINAL,DIRECT 表示未命中特例的请求采用 DIRECT,而不是所有请求都直连。修改最终策略会改变大量未单独列出的请求,应先明确目标,再逐项验证已列特例与普通请求。

规则关键字 · 处理动作

PROXY / DIRECT / REJECT,词条直达链接

PROXY、DIRECT、REJECT 是规则匹配后的处理策略,分别表示交给代理、直接连接和拒绝请求。它们与 DOMAIN-SUFFIX 等匹配关键字分工不同:前者决定动作,后者决定条件。规则也可能引用配置中定义的策略名称,名称必须与当前配置一致,不能把任意标签当作已经存在的策略。

把一行规则拆成三个部分

DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

第一行依次是匹配关键字、域名条件与处理策略;第二行为其余请求指定最终策略。这里的 example.com 仅用于说明语法,实际配置应依据自己的目标与已有参数调整。完整操作可继续阅读指定网站的 DOMAIN-SUFFIX 配置。

列表来源与规则文件

订阅与配置

服务器条目、订阅与配置文件各有用途。导入成功只说明数据已进入客户端,还需要核对选中项、当前文件及路由模式,才能判断请求实际如何处理。

订阅与配置 · 批量维护

Subscribe,词条直达链接

Subscribe 通过用户已有的订阅地址导入和更新服务器条目,订阅内容变化后可在客户端更新对应列表。订阅地址可能包含个人访问凭据,应从自己的服务商处获取并妥善保存,分享截图时遮盖完整地址。更新列表与切换当前连接是不同动作,更新完成后仍需检查实际选中的条目。

订阅与配置 · 单个连接条目

Server,词条直达链接

Server 指客户端保存的一组服务器连接参数,通常包含地址、端口、协议与认证信息,日常所说的“节点”通常指这类条目。显示名称只是便于辨认的标签,不能据此判断服务器位置、性能或可用性。手动添加时应按本人有权使用的服务器信息录入,遇到错误先检查字段对应关系。

订阅与配置 · 规则与设置

Config file,词条直达链接

Config file 是保存规则及相关设置的配置文件,与用于更新服务器列表的订阅用途不同,不能认为任意订阅地址都可以当成规则配置导入。导入文件后应确认当前实际启用的文件,并检查其中引用的策略名称。更换文件可能改变分流与解析行为,修改前宜保留可恢复的副本。

解析、测试与状态记录

设置项与诊断

诊断结果只反映特定条件下的一次观察。记录测试方法、发生时间、目标与错误线索,比只比较一个延迟数字更有助于定位问题;每次修改一项后再复测。

设置项与诊断 · 域名解析

DNS,词条直达链接

DNS 将域名解析为 IP 地址,解析结果会影响后续连接及部分 IP 规则匹配,因此解析失败与服务器认证失败需要分开排查。选择解析方式时,应理解请求的处理路径,而不是只替换一个地址。能解析出地址不代表目标一定可访问,详见DNS 设置参考。

设置项与诊断 · 延迟观察

Ping,词条直达链接

Ping 与延迟测试相关,结果取决于测试方法、测试目标以及当时的网络条件,不一定等同于传统 ICMP 测试。较小的数值不直接代表网页速度,也不能证明认证、TLS 与目标请求全部成功。比较结果时应保持测试条件一致,并结合Ping 设置参考确认当前方法。

设置项与诊断 · 错误线索

Log,词条直达链接

Log 是检查请求、连接与错误线索的日志入口,排查时应把具体操作的发生时间与对应记录联系起来。应先辨认问题发生在解析、握手、认证还是目标响应阶段,再修改对应设置。日志可能包含域名、地址或认证信息,分享前应删除敏感内容;记录方法见Log 设置参考。

设置项与诊断 · 数据同步

iCloud,词条直达链接

iCloud 用于相关应用数据同步,具体同步范围应以当前应用提供的选项为准,不能假定所有记录和凭据都会自动迁移。配置同步与 App Store 已购记录是不同事项:恢复应用购买不等于恢复服务器参数。换机前应检查同步状态并保留必要备份,相关选项见iCloud 设置参考。

设置项与诊断 · 可达性检查

Connectivity Test,词条直达链接

Connectivity Test 用于检查特定测试条件下连接能否完成,通过一次测试不表示所有目标与所有协议都正常。出现失败时,应记录测试目标与错误提示,再分别检查服务器参数、当前网络和相关解析结果。若测试通过但某个网站仍异常,应转向检查该请求的规则命中与实际连接路径。

从术语回到操作

第一次配置可从教程按顺序完成导入与验证;需要调整具体选项时查阅Settings 设置项参考;购买、已购恢复与连接故障的常见解释集中在疑难解答。先确定问题属于哪一层,再进入对应说明,避免把购买状态、服务器可用性与规则行为混在一起。