官方手册 · 术语查询

Shadowrocket 术语手册

按界面词、协议和规则关键字查阅含义。先分清连接对象、路由模式与处理动作,再修改具体设置。

本页保留应用中的英文原文,每个术语均可通过标题旁的链接单独定位。界面入口与可用选项可能因平台而异,操作时以当前应用显示为准;需要连续操作步骤时,查阅入门教程,需要设置说明时,查阅设置手册。

Shadowrocket 支持 iPhone / iPad / Mac(Apple 芯片与 Intel)/ Windows / 安卓 / Linux。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费;获取方式统一见全平台下载说明。

01 · 界面与开关

页面入口与连接模式

页面名表示操作位置,模式名决定请求如何处理,两者不要混用。

Home #
Home 是查看服务器条目、选择连接对象和操作连接开关的主要页面。选择条目不等于已经建立连接,还需要检查连接开关及系统授权状态。排查时先确认这里实际选中的条目,再检查规则,避免把选错服务器误判为配置问题。
Global Routing #
Global Routing 用于选择整体路由模式,而不是选择具体服务器。配置、代理、直连分别对应界面中的 Config、Proxy、Direct。规则文件看似没有生效时,应先核对是否处于 Config 模式,再检查文件是否已选用。
Config / Proxy / Direct #
Config 按当前配置中的规则决定请求处理方式;Proxy 按代理模式处理;Direct 按直连模式处理。这些是整体模式,与规则行里的大写动作关键字不是同一层级。临时切换模式可帮助缩小排查范围,测试结束后应恢复原本需要的模式。
On Demand #
On Demand 根据网络环境等条件触发连接行为,适合需要按条件连接或断开的场景。它控制连接何时发生,不代替域名或 IP 规则决定请求走向。发现连接自动恢复时,先检查是否存在命中的 On Demand 条件,不要只反复操作主开关。
Add Server #
Add Server 是手动建立服务器条目的入口。应按用户已有的服务器信息选择协议,并逐项填写地址、端口和认证字段,不要仅凭字段外观猜测类型。保存成功只表示条目已记录,参数是否匹配仍需通过实际连接验证。
Settings #
Settings 是查看和调整客户端设置的页面。设置项可能影响测试、日志、同步或连接行为,但并非所有项目都适用于每个平台。修改前记录原值,每次只改与当前问题相关的一项,便于判断效果并恢复。

02 · 协议

连接格式与认证方式

协议名不是速度等级。客户端类型、认证信息、传输设置与服务器端必须对应。

Shadowsocks #
Shadowsocks 是一种代理协议,连接通常需要服务器地址、端口、密码与加密方式。密码正确但加密方式不一致,同样可能连接失败。手动录入时按原始信息逐项核对,不应把其他协议的用户标识直接当作这里的密码。
VMess #
VMess 使用用户标识等参数进行认证,完整连接还可能包含传输方式与安全设置。导入后应核对地址、端口、用户标识以及相关传输字段,而不是只看条目名称。认证失败时也应检查设备时间,避免时间偏差干扰判断。
VLESS #
VLESS 是使用用户标识的代理协议,协议名称本身不代表已启用传输加密。实际连接的安全与兼容性还取决于配套的传输和安全层设置。不要因同样使用用户标识,就把 VMess 与 VLESS 条目直接互换类型。
Trojan #
Trojan 通常结合 TLS 使用,需要正确的密码及与服务器对应的安全设置。服务器名称与证书校验会影响连接,填写服务器 IP 并不意味着可以忽略名称字段。遇到证书错误时,应先核对域名、设备时间和服务器配置,而不是直接关闭校验。
Hysteria2 #
Hysteria2 是基于 QUIC 的代理协议,其工作依赖相应的 UDP 通信条件。当前网络的 UDP 可达性、认证字段和服务器设置都会影响连接。仅有普通网页能够打开,不能据此断定这一协议所需的通信路径也正常。
WireGuard #
WireGuard 使用公私钥与对端配置建立加密隧道。配置时需要区分本地私钥、对端公钥、端点和地址范围,不能将公钥与私钥位置互换。私钥属于敏感信息,提交故障截图或分享配置前应先移除。
HTTP / SOCKS5 #
HTTP 与 SOCKS5 是常见代理协议类型,均需按服务器实际支持的方式填写。端口相同不表示协议兼容,认证是否必需也由服务器决定。SOCKS5 这个名称本身不承诺传输加密,选择时应理解所用服务的实际连接方式。

03 · 规则关键字

匹配条件与处理动作

先判断匹配对象,再看命中后的动作,最后检查规则顺序。

规则 #
规则通常由匹配类型、匹配内容与处理动作组成,用来决定某类请求如何处理。规则列表一般按顺序判断,前面已经命中的条件可能使后面的规则不再参与判断。添加规则后应检查所在位置,并确认 Global Routing 使用 Config。
DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD #
DOMAIN 用于精确域名匹配,DOMAIN-SUFFIX 用于域名后缀匹配,DOMAIN-KEYWORD 用于域名关键词匹配。例如 DOMAIN-SUFFIX,example.com,PROXY 表示按后缀匹配后交给代理处理。关键词范围可能更宽,不宜用过短的词代替明确域名。
GEOIP #
GEOIP 根据 IP 地址数据库中的地区归属进行匹配,例如 GEOIP,CN,DIRECT。它不依据网页内容、域名后缀或访问者所在地判断。解析结果、地址数据库和服务使用的分布式基础设施都可能影响命中结果。
IP-CIDR / IP-CIDR6 #
IP-CIDR 匹配 IPv4 网段,IP-CIDR6 匹配 IPv6 网段,斜杠后的前缀长度决定范围。网段规则面向地址,不是域名文字;目标地址改变时,命中情况也可能改变。只处理单个地址时,应确认前缀没有意外覆盖更大的范围。
FINAL #
FINAL 是前面规则未命中时使用的兜底规则,例如 FINAL,PROXY。它通常放在规则列表末尾,否则可能提前接管原本应继续匹配的请求。兜底动作应与实际需求一致,不能靠不断追加更靠后的规则修正前面的兜底。
PROXY / DIRECT / REJECT #
PROXY 表示交给代理处理,DIRECT 表示直接连接,REJECT 表示拒绝请求。它们是规则里的处理动作,不是协议名称,也不是服务器地址。阅读规则时保留这些大写写法,并与 Global Routing 中的 Proxy、Direct 模式区分。
USER-AGENT #
USER-AGENT 依据可读取的 HTTP User-Agent 字段匹配请求,不能直接等同于按应用名称分流。加密连接中,该字段不一定可供读取,因此规则存在不代表所有请求都能命中。排查时先确认请求条件与字段可见性,不要仅调整关键词。

04 · 订阅与配置

连接信息、文件与恢复

服务器订阅、规则配置与商店购买记录分别管理不同内容,不能互相替代。

Subscribe #
Subscribe 用于通过用户已有的订阅地址导入或更新服务器条目。订阅更新可能改变条目内容,因此应先区分订阅管理的记录与自行添加的记录。订阅地址可能包含访问凭据,不应放进公开截图、日志或分享文本。
服务器条目 #
服务器条目保存地址、端口、协议和认证等连接参数,常被称为节点。条目名称只是便于识别的标签,不能据此判断实际位置、可用性或性能。出现重名时,应核对参数和所属订阅,避免误删正在使用的记录。
Config 配置文件 #
Config 配置文件可保存规则、DNS 或策略等设置,与提供服务器条目的订阅不是同一个概念。文件已下载不代表已经选用,修改文件也不代表当前模式一定按它处理。Config 同时出现在页面名和路由模式中,阅读步骤时应结合所在位置判断含义。
Scan QR Code #
Scan QR Code 是通过二维码读取可识别连接信息的入口,二维码可能包含单条服务器信息或订阅地址。扫描后应检查实际识别的类型和关键字段,再决定保存。二维码只是编码形式,不代表内容可信,也不应公开包含认证信息的二维码。
iCloud 同步 #
iCloud 同步在相应账户和系统权限条件下同步应用支持的数据,具体范围应以应用说明为准。开启开关不等于所有内容已上传完成,换机前应在目标设备核对恢复结果。同步与独立导出备份用途不同,重要配置宜保留可恢复的副本。
已购项目 #
已购项目用于通过原购买账户查找应用购买记录并恢复下载,不用于恢复服务器信息或规则文件。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。商店应用 ID 为 932747118,开发者为 Shadow Launch Technology Limited;系统要求以 App Store 页面标注为准。

05 · 设置与诊断

解析、测试与运行记录

诊断结果只反映特定条件,需结合目标请求、当前模式与网络环境一起判断。

DNS #
DNS 将域名解析为 IP 地址,解析结果会影响后续连接和部分规则判断。能连接服务器但某个域名打不开时,可分别检查解析是否成功以及请求最终采用的路径。随意叠加多个解析设置会增加排查难度,应先确认当前配置实际使用哪一项。
Connectivity Test / 延迟 #
Connectivity Test 用于观察特定测试条件下的响应情况,延迟是相应过程的耗时指标。延迟较低不等于下载速度一定更快,测试成功也不代表所有目标请求都能成功。比较结果时应尽量保持网络、测试方式和目标一致,并补充实际请求验证。
Log #
Log 是帮助定位连接、解析或请求处理问题的运行记录。排查时记录复现时间、目标域名和当前模式,再对应查看相关记录,比单独截取一条错误更有效。分享前应移除订阅地址、认证字段及不必要的个人访问记录。
URL Rewrite #
URL Rewrite 根据匹配规则修改可处理的请求地址或相关行为,与选择代理或直连不是同一功能。它是否生效取决于请求是否可处理、匹配表达式和相应配置条件。修改表达式前先确认目标范围,避免把正常请求也纳入改写。
Proxy 端口 #
Proxy 端口是本机代理服务接受连接的监听端口,与远端服务器条目中的端口不同。其他程序使用它时,需要填写对应监听地址、端口及协议类型。开放到其他设备访问会扩大可访问范围,启用前应核对监听设置、网络信任范围和访问控制。
Data #
Data 用于查看应用记录的数据流量信息,统计范围与周期应按当前界面理解。应用侧记录与服务商的用量计算口径可能不同,不能直接当作账户剩余额度。观察异常消耗时,应结合统计时间、连接记录和实际使用行为一起判断。

从术语返回操作步骤

导入与首次连接查看教程;DNS、On Demand 与诊断选项查看设置手册;常见问题查看问答。核对 iPhone / iPad 商店信息可打开 Shadowrocket App Store 产品页。

返回术语分类 ↑