官方手册 · 概念速查

Shadowrocket 术语表

适用平台为 iPhone、iPad、Mac、Windows、安卓与 Linux。iPhone / iPad 版从 App Store 获取,$2.99 一次性付费;Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费。iPhone / iPad 系统要求以 App Store 页面标注为准。

按界面入口、协议类型、规则语法与诊断过程查词。界面词和配置关键字保留英文原文;不同平台的入口位置可能不同,以下解释用于理解概念,不把某个平台的界面位置当作通用操作步骤。

需要获取应用时,前往全平台下载页;电脑与安卓等平台的安装包由本站 /dl/ 提供。首次打开的系统放行步骤见安装说明。

界面与开关

先区分“在哪个页面操作”“何时连接”与“连接如何分流”。它们分别属于界面入口、连接触发条件和路由模式,不能相互替代。

界面与开关

Home

Home 是查看服务器条目、当前选择与连接开关的界面入口。选中一个条目只表示准备使用它,不表示连接已经建立;还应检查开关状态及系统提示。

界面与开关

Global Routing

Global Routing 用于选择整体路由姿态:配置、代理、直连,对应界面词 Config、Proxy、Direct。排查规则没有生效时,应先确认这里使用 Config,再检查当前配置文件,而不是立即修改域名规则。

界面与开关

Config

在 Global Routing 中,Config 表示依照当前配置文件处理连接,包括按规则匹配相应策略。作为页面名称时,Config 又是管理配置文件的入口;看到同一个词,需要结合它所在的位置判断含义。

界面与开关

Proxy / Direct

Proxy 与 Direct 分别表示代理模式和直连模式,适合用于区分问题是否与规则配置有关。它们是 Global Routing 的模式名称;配置文本里的 PROXY、DIRECT 则是规则动作,大小写与使用位置都应按原文保留。

界面与开关

On Demand

On Demand 是按预设设备或网络条件触发连接的机制,重点在于“何时建立连接”。规则分流处理的是连接进入后“使用哪种策略”,因此启用 On Demand 并不等于已经配置好分流规则。

界面与开关

Add Server

Add Server 用于手动录入用户已有服务器信息。先选择与原始资料相符的协议类型,再填写地址、端口和认证字段;字段相似不代表协议可以互换,保存成功也不代表远端一定可达。

协议

协议描述客户端与远端如何通信。应按用户已有资料填写,不凭名称推断速度、电量或稳定性;这些表现同时受网络路径、服务器负载与参数影响。

协议

Shadowsocks

Shadowsocks 是一种代理协议,常见信息包括服务器地址、端口、加密方法与密码。加密方法必须与远端一致,不能只核对密码;如果原资料还包含插件或其他扩展设置,也需要按提供的信息逐项确认。

协议

VMess

VMess 使用 UUID 等身份信息完成认证,并可搭配不同传输方式。导入后应同时核对传输类型、路径、Host 与 TLS 设置;UUID 正确并不足以证明整条配置完整。

协议

VLESS

VLESS 采用精简的身份验证设计,本身不提供负载加密,需要结合适当的安全传输使用。它与 VMess 不是同一个类型,不能通过保留 UUID、只改协议名称的方式完成转换。

协议

Trojan

Trojan 通常结合 TLS 与密码认证,填写时需要分别核对认证信息和证书相关名称。连接地址与 TLS 验证名称承担不同职责;遇到证书错误时,应检查名称、设备时间与远端证书,而非直接关闭验证。

协议

HTTP / SOCKS5

HTTP 与 SOCKS5 是常见的通用代理接口类型,认证字段及可处理的流量范围有所不同。协议名称本身不表示链路已加密;应用访问 HTTPS 网站与客户端到代理服务器之间是否加密,也属于不同层次。

协议

WireGuard

WireGuard 通过密钥与 Peer 配置建立隧道,常见参数包括 Endpoint、地址与 Allowed IPs。Endpoint 指向远端入口,Allowed IPs 描述 Peer 关联的地址范围;这套信息不能直接当成普通账号密码填写。

协议

Hysteria2

Hysteria2 基于 QUIC,连接依赖 UDP 路径可达,以及匹配的认证与 TLS 设置。普通网页能访问不代表该路径上的 UDP 一定可用;若资料提供带宽或混淆参数,应依据实际配置核对,而不是任意填大数值。

参数字段与设计取舍的进一步解释见协议手册。

规则关键字

规则由匹配条件与处理策略组成,通常按配置中的先后顺序检查。阅读时先看匹配对象是域名还是 IP,再看末尾策略,不要把关键字本身理解成代理开关。

规则关键字

DOMAIN

DOMAIN 用于精确匹配域名,例如 DOMAIN,example.com,PROXY。这条规则不会自动覆盖 www.example.com;需要覆盖该域名及其子域名时,应理解 DOMAIN-SUFFIX 的匹配范围。

规则关键字

DOMAIN-SUFFIX

DOMAIN-SUFFIX 匹配指定域名及其子域名,例如 DOMAIN-SUFFIX,example.com,PROXY。填写的是域名,不是完整网页地址,因此不要把协议前缀、页面路径或查询参数一起放入域名字段。

规则关键字

DOMAIN-KEYWORD

DOMAIN-KEYWORD 根据域名中是否包含指定字符串进行匹配,例如 DOMAIN-KEYWORD,ads,REJECT。关键词不理解网站用途,过短的字符串可能命中预期之外的域名;需要边界清晰时应优先检查精确域名或后缀条件。

规则关键字

IP-CIDR / IP-CIDR6

IP-CIDR 匹配 IPv4 网段,IP-CIDR6 匹配 IPv6 网段,例如 IP-CIDR,192.168.0.0/16,DIRECT。斜杠后的数字表示前缀长度;它们匹配 IP 地址,不能直接替代域名规则,解析结果与 IPv6 路径也可能影响命中情况。

规则关键字

GEOIP

GEOIP 根据 IP 地理数据库中的分类进行匹配,不是根据网页语言、域名后缀或网站经营者判断。地址分类可能随数据库与网络分配变化;遇到某个站点行为不符预期时,应检查实际目标 IP 和规则命中记录。

规则关键字

FINAL

FINAL 用于处理前面规则均未匹配的连接,通常放在规则列表末尾。FINAL,DIRECT 表示剩余连接使用直连策略,并不表示此前已经命中的 PROXY 或 REJECT 规则会被覆盖。

规则关键字

PROXY / DIRECT / REJECT

PROXY 表示交给相应代理策略处理,DIRECT 表示直接连接,REJECT 表示拒绝连接。策略名与具体服务器条目不是同一概念;若配置使用自定义策略组,还需检查该组引用的条目与当前选择。

订阅与配置

服务器信息决定连接到哪里,配置文件决定如何处理连接,订阅用于批量取得或更新已有条目。导入之前,先识别手中的信息属于哪一种。

订阅与配置

Subscribe

Subscribe 关联用户已有订阅信息的导入与更新,可用于批量维护服务器条目。订阅链接可能携带访问凭据,不应出现在公开截图或分享记录中;更新成功也不代表规则配置已经随之更新,需分别确认导入内容。

订阅与配置

Server

Server 是包含协议、地址、端口与认证字段的连接条目。显示名称只是辨认标签,不能证明地理位置或性能;排查时应核对实际参数,并区分条目已经保存、已经选中和已经连通这三种状态。

订阅与配置

配置文件

配置文件可以组织规则、DNS 与策略等设置,与单独的 Server 条目用途不同。导入后需要确认它已被选为当前配置,并与 Global Routing 的 Config 模式配合;修改前宜保留原文件,以便比较与恢复。

订阅与配置

Scan QR Code

Scan QR Code 用于从二维码中识别连接或订阅信息,二维码只是数据的呈现方式。识别后仍应确认内容类型、协议与必要字段;包含密码或订阅凭据的二维码,应按敏感资料保存和传递。

订阅与配置

已购项目

已购项目是 iPhone / iPad 使用原购买 Apple 账户查找并重新下载应用的入口,不等同于恢复应用内的服务器与配置数据。iPhone / iPad 版 App Store $2.99 一次性付费,两种设备通用;Mac、Windows、安卓、Linux 版免费。

准备开始导入时,可按快速上手逐步操作;重新获取应用的相关说明见换机与重装。

连接与诊断

诊断应区分域名解析、远端可达、认证与实际业务访问。一次测试通过只说明该次测试的条件成立,不应代替全部验证。

连接与诊断

DNS

DNS 将域名解析为 IP 地址,是访问网站前的重要环节。解析成功与连接策略正确是两件事:一个地址能解析出来,仍可能在连接、认证或规则阶段失败;调整 DNS 时应记录原设置,避免同时改动多项后难以定位原因。

连接与诊断

Connectivity Test

Connectivity Test 按当前测试方式检查服务器响应或可达性,结果受测试目标与路径影响。测试成功不代表所有网站、UDP 或持续传输都可用;应在相同网络和相同测试方法下比较,再验证实际需要使用的应用。

连接与诊断

延迟

延迟通常指特定测试条件下的往返耗时,不等于下载带宽,也不能单独代表稳定性。测试方法、设备网络和远端负载都会改变结果;比较时应保持条件一致,并结合丢包、连接失败和实际访问表现判断。

连接与诊断

TLS / SNI

TLS 用于保护传输并验证远端身份,SNI 则在握手时告知服务器所请求的名称。服务器地址、SNI 与其他 Host 字段不一定相同,应按已有资料分别核对;证书报错时优先检查名称、设备时间与证书状态。

连接与诊断

UDP

UDP 以数据报方式传输,不采用 TCP 式连接握手,部分实时应用与协议会使用它。是否可用取决于客户端设置、协议、服务器和中间网络的共同支持;网页访问正常并不能直接证明 UDP 业务也正常。

按问题选择下一步

分享诊断信息前,请遮去密码、密钥、订阅凭据和可识别个人的数据。保留错误类型、操作步骤与必要的设置名称,通常更有助于复现问题。