官方手册 · 术语查阅

Shadowrocket 术语手册

按界面、连接方式和配置语法查找术语。英文名称与应用界面、协议及规则关键字保持一致;先确定术语所在的层级,再判断应修改服务器参数、连接姿态,还是配置文件。

5 类主题 29 个术语 每项可直接定位

首次操作请阅读使用说明;已经遇到连接问题,可按疑难手册中的症状顺序排查。

01 / 确认操作位置

界面与开关

界面入口说明“在哪里操作”,不表示请求最后经过哪条路径。同一个英文词可能同时用作页面名与选项名,应结合所在位置理解。

Home

查看服务器条目、当前选择与连接开关的界面,也是导入后检查条目是否出现的起点。开启连接前先确认选中的条目与预期一致;开关已开启只说明连接流程已启动,不能据此判断每个网站均可访问。

Config

作为页面名时,Config 指配置文件的管理入口,可用于查看和选择要使用的配置。作为 Global Routing 的选项时,Config 表示按当前配置处理请求;切换到 Config 页面与启用 Config 姿态是两件不同的操作。

Settings

集中管理客户端行为与相关选项的界面,具体项目以当前应用显示为准。排查问题前记录原值,每次只改变一个选项并重复同一项测试,避免同时调整多个设置后无法判断原因。

Add Server

手动添加已有服务器信息的入口,需要先选择正确的协议,再填写地址、端口和认证信息。部分协议还需要传输方式、路径、TLS 或其他参数;只填入地址与密码并不一定构成完整配置。

Connectivity Test

用于检查连接可用性的测试,结果受测试方式、目标地址、当前网络和服务器状态共同影响。界面中的延迟不是持续下载速度,也不能替代实际访问验证;比较结果时应保持测试目标和网络条件一致。

02 / 确认请求如何处理

连接姿态与按需

先看整体连接姿态,再看具体规则。自动连接、域名解析与服务器认证各自处理不同环节,不应把其中一项成功当作整条链路正常的证明。

Global Routing

决定整体请求处理方式的选项,会影响当前配置中的规则是否按预期参与分流。检查某条规则为何没有生效时,应先核对 Global Routing,再查看规则顺序,而不是立即修改服务器参数。

Config / Proxy / Direct

三种基础姿态分别是配置(Config)、代理(Proxy)和直连(Direct):Config 按当前配置处理,Proxy 以代理为主要路径,Direct 以直连为主要路径。这里首字母大写的名称是界面选项,与规则右侧全大写的策略名称所在层级不同。

On Demand

依据配置的网络等条件按需发起连接,用于减少重复手动操作。它不负责修正失效的服务器、错误密码或不匹配的 TLS 参数;建议先确认手动连接正常,再配置触发条件并检查网络切换后的行为。

DNS

将域名解析为 IP 地址的机制,是使用域名访问服务时的重要环节。解析失败、缓存或解析路径变化可能造成部分域名异常;排查时记录出错域名及当前 DNS 配置,不要把所有访问失败都归因于服务器超时。

03 / 对照已有服务器参数

协议

协议规定客户端与远端如何交换数据。下列解释用于识别参数,不构成速度排序;可用性取决于服务器实际部署、双方配置与当前网络条件。

Shadowsocks

一种加密代理协议,客户端与服务器必须使用一致的加密方法、密码及相关参数。导入后若无法连接,应逐项核对协议类型、端口和加密方法,不能因为显示名称相同就认定两份条目等价。

VMess

使用用户标识等信息完成认证的代理协议,实际配置还可能包含传输方式和 TLS 参数。系统时间明显偏差可能影响认证,应开启准确的时间设置;传输路径或名称不一致也可能导致连接失败。

VLESS

一种轻量代理协议,其协议本身不提供内容加密,安全性需要结合 TLS 等外层机制理解。用户标识只是配置的一部分,还应按已有服务器信息核对传输、路径、名称与安全相关选项,不能直接套用其他协议的参数。

Trojan

通常结合 TLS 并使用密码认证的代理协议,连接信息包括服务器地址、端口、密码以及 TLS 名称等。证书名称与连接地址未必是同一个值,应以用户已有服务的配置说明为准;遇到证书错误时先核对名称与系统时间。

Hysteria2

基于 QUIC 的代理协议,依赖可用的 UDP 路径,表现会受到丢包、带宽与拥塞控制配置影响。网络限制 UDP 时,即使地址和认证信息正确也可能无法建立连接;它并不保证在每一种网络中都比其他协议更快。

WireGuard

基于公私钥认证的隧道协议,配置涉及本地密钥、对端公钥、隧道地址、Endpoint 与路由范围。私钥属于敏感信息,不应随截图或日志公开;能够与对端握手也不代表 DNS 和路由范围已经配置正确。

HTTP / SOCKS5

两类代理协议:HTTP 代理可通过 CONNECT 建立隧道,SOCKS5 的 TCP、UDP 能力需结合双方实现与配置判断。不要把代理协议名称与目标网站使用的 HTTP 或 HTTPS 混为一谈;是否加密传输也不能仅凭“使用代理”得出结论。

04 / 分开理解条件与动作

规则关键字与策略

规则左侧说明匹配什么,右侧说明命中后做什么。以下示例仅用于讲解语法,域名为示例值,不代表应直接替换现有配置。

[Rule]

配置文件中组织分流规则的段落,规则按照从上到下的顺序检查,首条命中后执行对应策略。较宽泛的规则如果放在前面,可能使后面的精确规则没有机会生效;检查顺序通常比反复添加相同规则更有效。

DOMAIN-SUFFIX

按域名后缀匹配,指定 example.com 时可覆盖该域名本身及其子域名,例如 www.example.com。它按域名边界判断,不是任意字符串包含;只想匹配一个完整域名时,应了解 DOMAIN 的精确匹配用途。

DOMAIN-KEYWORD

检查域名中是否包含指定字符串,匹配范围通常比针对某个域名后缀更宽。使用常见短词可能影响无关域名,因此应先确认实际请求域名,再决定是否采用这种条件,避免只凭网站显示名称设置规则。

GEOIP

依据 IP 地理归属数据库对目标 IP 进行匹配,判断结果取决于数据库中的记录。它不直接说明网站运营方、用户或服务器所有者所在地;使用内容分发网络的服务,其解析地址也可能随网络与时间变化。

IP-CIDR / IP-CIDR6

分别用于匹配 IPv4 与 IPv6 地址范围,斜杠后的前缀长度决定地址段大小。只写 IPv4 范围并不能覆盖对应服务可能使用的 IPv6 地址;规则未命中时,还需要核对实际连接采用的地址族。

FINAL

用于处理此前未被任何规则命中的请求,是规则列表末尾的兜底。FINAL,PROXY 表示剩余请求交给代理路径,不会覆盖前面已经命中的 DIRECT 或 REJECT 规则,也不能保证代理服务器可用。

PROXY / DIRECT / REJECT

规则命中后执行的三种策略:PROXY 交给代理路径,DIRECT 直接连接,REJECT 拒绝请求。它们是动作而非协议名;规则选择正确但访问仍失败时,应继续检查所选路径的 DNS、连接和认证情况。

05 / 确认导入与保留的内容

订阅与配置文件

服务器条目、远程订阅和配置文件用途不同。导入成功后,应分别检查条目是否存在、当前选中项是否正确,以及当前配置是否符合预期。

订阅

通过 URL 获取并更新服务器条目信息的方式,内容和有效性由用户已有服务决定。订阅 URL 往往包含访问凭据,应按密码对待;刷新操作只是重新拉取远程内容,不会使已经失效的服务自动恢复。

Subscribe

用于订阅远程资源的操作名称,执行前先确认链接所指的是服务器列表还是配置文件。链接可以被获取,不代表其中格式一定能被识别;遇到导入错误时,应检查资源类型与返回内容,而不是只反复粘贴同一链接。

服务器

也常被称为一个节点,是连接远端所需的一组参数,通常包括协议、地址、端口和认证信息。条目的显示名称主要便于辨认,不参与认证;两条名称不同的记录可能指向同一地址,同名记录也可能包含不同参数。

配置文件

组织规则、DNS 及其他处理选项的文档,不等同于服务器订阅。替换前应保留原文件,检查新文件涉及哪些设置;仅导入配置文件不意味着已经获得可连接的服务器,也不意味着已自动选中该配置。

iCloud 同步

借助 iCloud 在相应设备间同步应用支持的数据,具体同步范围以应用内说明为准。同步与服务有效期是两回事,也不能代替操作前备份;在另一台设备修改或删除数据前,应先确认同步状态及影响范围。

已购项目

App Store 中查找既有购买记录的入口,换机或重装时应核对当时购买所用的 Apple ID。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费;购买记录与服务器服务的有效期分别管理。

获取与服务范围

本站是 Shadowrocket 官网与官方手册,解释客户端获取、配置和排查方法。所有连接操作均以用户已有自己的订阅或服务器信息为前提。

iPhone / iPad 版从 App Store 获取,$2.99 一次性付费,系统要求以 App Store 页面标注为准;Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费。其他平台安装包统一由本站 /dl/ 路径提供,请从全平台下载页选择,并按该页的系统放行说明完成首次打开。

iPhone / iPad 可核对开发者名 Shadow Launch Technology Limited、官方图标与应用 ID 932747118。若需要定位某项具体操作,可继续查阅设置说明;若参数含义已经清楚但仍连接失败,请转到疑难手册,按现象逐步测试。

返回术语分类 ↑
免费下载 Shadowrocket