[Glossary]

Shadowrocket
术语手册

按界面、协议、规则与配置查阅概念。先区分设置入口和规则关键字,再判断一条请求如何被处理;英文名称与客户端及配置文件保持一致。

[Interface]

界面与开关

先判断开关控制的是连接状态、整体流量姿态,还是单次诊断。连接已开启,不代表所有请求都会经过代理服务器。

Global Routing

Routing Mode

决定整体流量处理方式,三种姿态为配置(Config)、代理(Proxy)、直连(Direct)。Config 按当前配置中的规则选择策略;Proxy 将流量交给代理处理;Direct 使用直接连接。排查分流结果时,应先确认此处是否为 Config,否则修改 Rule 段可能看不到预期效果。

On Demand

Connection

根据设定的网络条件触发连接或断开,处理的是“什么时候建立连接”。它与 Rule 段负责的“请求走什么策略”是两个层次,不能用来代替域名分流。手动断开后又自动连接时,先检查 On Demand 的条件,再排查其他连接设置。

Add Server

Server Entry

手动添加已有服务器信息的入口,需要先选协议,再填写地址、端口及对应认证参数。TLS、SNI 和传输设置也要与服务器端一致,不能只凭地址和端口判断填写完整。单条分享链接导入后,也可回到对应记录逐项核对。

Connectivity Test

Diagnostics

用于检查服务器在所选测试方式下能否响应,测试显示的延迟是该次测量的结果。延迟不是下载速度,也不能代表所有目标网站的访问质量;测试目标、网络环境和测试方式都会影响结果。出现异常时,应结合真实请求是否成功及命中策略一起判断。

DNS

Name Resolution

负责把域名解析成 IP 地址,属于连接目标之前的重要环节。解析成功和目标连接成功并不是同一件事,错误结果可能表现为域名访问失败而 IP 访问正常。修改 DNS 设置前先确认当前配置及网络条件,并注意缓存可能使新设置不会立即体现在已有请求上。

[Protocol]

协议

协议规定客户端与服务器如何通信,不是速度或可用性的等级。以你已有服务器提供的参数为准,不要为尝试连接而随意更换协议类型。

Shadowsocks

Protocol

代理协议的一种,常见必要参数包括服务器地址、端口、加密方法和密码。加密方法与密码必须和服务器设置对应;地址正确但认证不一致,同样不能正常使用。若服务器还要求额外传输参数,应按提供的信息填写,不能把另一种协议的字段直接套用。

VMess

Protocol

使用用户标识等参数进行认证的代理协议,通常需要同时核对地址、端口、UUID 以及传输选项。使用 WebSocket 等传输时,Host 和 Path 也是连接配置的一部分。导入后仍然失败,应按服务器信息检查 TLS 与传输层,而不是只反复修改 UUID。

VLESS

Protocol

使用用户标识的代理协议,协议本身与所采用的传输、安全层需要分别理解。不能看到 VLESS 名称就推断具体加密方式,也不能认为它与 VMess 的全部参数通用。核对时以服务器给出的 UUID、传输方式及安全参数为一组,避免把不同记录的字段混在一起。

Trojan

Protocol

通常结合 TLS 使用、通过密码认证的代理协议,密码与证书相关设置均会影响连接。SNI 用于 TLS 握手中的服务器名称,可能与实际连接地址不同,应按服务器信息填写。遇到证书错误先核对名称、设备时间和证书状态,不应把 Allow Insecure 当作常规修复方式。

Hysteria2

Protocol

基于 QUIC 的代理协议,连接依赖相应的 UDP 网络条件及服务器支持。认证、TLS、端口和混淆等参数应与服务器端配套,不能按其他协议的经验省略字段。连通测试异常时,还需区分参数错误与当前网络对 UDP 的处理,协议名称本身不保证某种实际速度。

WireGuard

Protocol

通过公私钥等参数建立加密隧道,配置中还会涉及 Endpoint、地址和允许的地址范围。私钥属于敏感信息,不应出现在公开截图、文章或求助记录中。已有隧道握手并不代表所有目标地址都能访问,仍需核对路由范围、DNS 与服务器端转发设置。

需要理解分享链接与订阅的区别,可阅读 分享链接格式说明。

[Rule]

规则关键字与策略

规则由匹配条件和命中后采用的策略组成,按排列顺序检查。以下使用 example.com 作为教学域名,不代表提供任何服务器或订阅。

[Rule]

[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

此示例让指定域名交给 PROXY,局域网地址使用 DIRECT,其余请求由 FINAL,DIRECT 兜底。使用前需选中包含这些规则的配置,并将 Global Routing 设为 Config。

PROXY DIRECT REJECT

DOMAIN

Rule Type

匹配完整域名,例如 DOMAIN,example.com,PROXY 只针对这个域名,而不是自动包含所有子域名。适合只处理单一主机名的情况,填写时不加入 URL 的路径或协议前缀。若同一服务分散在多个域名,需分别确认实际请求使用的主机名。

DOMAIN-SUFFIX

Rule Type

匹配指定域名及其子域名,例如 DOMAIN-SUFFIX,example.com,PROXY 可覆盖 example.com 和 api.example.com。它按域名层级匹配,不是任意字符串包含判断。比起逐条填写子域名更简洁,但应确认整个域名范围都适合相同策略。

DOMAIN-KEYWORD

Rule Type

检查域名是否包含指定关键字,例如 DOMAIN-KEYWORD,example,PROXY。匹配范围往往比 DOMAIN 或 DOMAIN-SUFFIX 更宽,可能包含原本不打算处理的其他域名。只有确实需要关键字覆盖时才使用,并通过实际请求检查是否出现误匹配。

GEOIP

Rule Type

根据 IP 地理数据库的归类结果匹配,例如 GEOIP,CN,DIRECT。数据库归类并不等于目标网站使用的语言或所属机构,CDN 和地址变化也会影响结果。域名规则已在前面命中时,请求不会再由后面的 GEOIP 规则重新选择策略。

IP-CIDR / IP-CIDR6

Rule Type

分别用 IPv4 和 IPv6 地址段匹配目标,斜杠后的数字表示网络前缀长度。示例 IP-CIDR,192.168.0.0/16,DIRECT 覆盖相应的私有地址范围。它匹配地址而不是域名文字,处理域名请求时还需考虑解析结果以及前序规则是否已经命中。

USER-AGENT

Rule Type

按可识别的 User-Agent 内容匹配,例如 USER-AGENT,ExampleApp*,DIRECT。这不是按应用进程身份分流,同一应用的不同请求可能使用不同标识,其他程序也可能使用相同标识。加密请求中的相关内容未必可见,不能假定该规则覆盖应用的全部流量。

FINAL

Fallback

为前序规则都未命中的请求指定兜底策略,通常作为 Rule 段最后一行。FINAL,DIRECT 表示其余直连,FINAL,PROXY 表示其余交给代理,两者决定了完全不同的默认行为。排查某个域名“为什么走了代理”时,应同时检查具体命中项与 FINAL。

PROXY

Policy

规则中的策略关键字,表示把命中的请求交给代理策略处理,不是某一种具体协议。能否完成请求还取决于实际选用的服务器、认证及连接状态。它与 Global Routing 中的 Proxy 姿态不同:前者是单条规则的处理结果,后者是整体流量处理方式。

DIRECT

Policy

让命中的请求直接连接目标,不经代理服务器转发。DIRECT 规则仍然可以在 Config 姿态下生效,因此看到连接开关开启并不意味着这类请求经过了代理。直连是否成功取决于本地网络、解析与目标服务状态,策略名称本身不是可用性保证。

REJECT

Policy

拒绝命中的请求,用于明确不允许继续连接的目标。使用前应把匹配范围写清,过宽的域名关键字或地址段可能让正常功能一起受影响。若某页面内容缺失,先查看请求是否命中 REJECT,再决定缩小规则范围,而不是直接改动全部策略。

匹配顺序、段落结构与更多写法见 Rule 规则参考。

[Config]

订阅与配置文件

订阅主要解决服务器列表的导入与更新,配置文件负责组织规则和相关设置。两者都可以表现为链接,但不能仅凭“是一个网址”就判断导入位置。

Subscribe

Subscription

通过订阅地址导入及更新服务器列表的入口,订阅从你的服务商处获取。更新时列表内容可能随来源变化,手动修改某条记录前应考虑下次更新是否会覆盖。订阅地址可能包含认证信息,求助时应遮盖完整地址中的敏感部分,不要公开可直接使用的链接。

SERVER

Connection Record

表示一条服务器连接记录,中文说明中也常称为“节点”,其内容不只是一个 IP 地址。协议、端口、认证、传输及 TLS 参数要配套使用;同一地址可以对应多条不同配置。单条分享链接通常导入一条记录,不因此自动具备订阅地址的后续列表更新能力。

Config

Configuration

可指配置文件及其管理入口,文件中可包含 General、Rule、Host、URL Rewrite 等段落,各段负责不同内容。服务器列表存在不等于分流规则已经启用,还需选中目标配置并确认 Global Routing 的姿态。编辑前保留原文件,修改后检查段头、逗号与排列顺序,便于失败时恢复。

URL Rewrite

Configuration Section

用于对符合条件的请求 URL 执行重写等处理,不等同于 Rule 段中的 PROXY 或 DIRECT。规则是否能作用于请求,取决于匹配条件和请求内容是否可被相应功能处理。涉及 HTTPS 时还有额外的可见性与证书前提,不能认为填入一条重写就会改变所有加密请求。

[Platform]

安装与平台

Shadowrocket 覆盖 iPhone、iPad、Mac、Windows、安卓和 Linux。获取渠道与安装格式按设备区分,具体入口集中在下载指南。

App Store

Distribution

iPhone / iPad 获取 Shadowrocket 的商店渠道,系统要求以 App Store 页面标注为准。核对开发者 Shadow Launch Technology Limited、官方图标及应用 ID 932747118,避免只按名称判断。iPhone / iPad 版为 $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费,后四类平台的安装包通过本站 /dl/ 获取。

打开 Shadowrocket App Store 产品页

Apple 芯片 / Intel

Architecture

选择 Mac 版安装包时需要区分的芯片类别,在“关于本机”中查看芯片或处理器信息后再选对应 dmg。Apple 芯片版与 Intel 版不是两个不同产品,也不应仅按电脑购买年份猜测。Mac 首次打开遇到“无法验证开发者”提示时,先核对来源,再按“隐私与安全性”中的“仍要打开”处理。

查看 Mac 两种芯片的下载入口

安装放行

System Permission

指核对本站安装包来源后,按操作系统提示完成首次运行或安装授权。Windows SmartScreen 可在确认文件来源后选择“更多信息 → 仍要运行”;安卓需为实际下载并打开 apk 的应用授予“允许安装未知应用”。Mac 提示“已损坏”及 Linux AppImage 执行权限的处理步骤不同,不应套用其他平台的方法。

查看各系统安装放行说明

已购项目

Purchase History

iPhone / iPad 换机或重装时,使用原购买账号在 App Store 的已购记录中查找 Shadowrocket;入口名称可能随系统版本调整。若重新显示购买价格,先核对当前账号与商店地区,不要直接重复支付。iPhone / iPad 版为 $2.99 一次性买断,Mac / Windows / 安卓 / Linux 版免费,后者重新获取对应安装包即可。

查看重新下载与购买记录说明