官方手册 · 名称与作用

Shadowrocket 术语手册
界面、协议与规则关键字

先区分界面入口、连接协议、匹配条件和处理策略,再查具体参数。本页保留 Home、Config、Global Routing 等英文原文;同一个名称出现在不同位置时,按所在层级理解,不把服务器列表、配置文件与系统连接状态混为一谈。

适用于 iPhone / iPad / Mac(Apple 芯片与 Intel)/ Windows / 安卓 / Linux 上的 Shadowrocket 概念查阅。不同平台的入口位置可能不同,操作路径以当前应用界面为准。

使用前需已有自己的订阅或服务器信息。本站不提供、不销售、不推荐节点或订阅;客户端一次性买断 ≠ 线路套餐。获取方式为 iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费,详见全平台下载。

界面与开关

按步骤操作 →

这一类名称说明“在哪里操作”和“当前采用哪种处理方式”。开关已打开、服务器已选中、规则已生效是三个不同状态,需要分别核对。

界面与开关

Home

Home 是查看服务器与订阅条目、选择当前服务器并操作连接的主要入口。选中某个条目只确定可用的代理对象,哪些请求会使用它仍由 Global Routing 和配置决定。排查时先确认列表中的选择,再检查连接状态,避免把“已有条目”误认为“已经连接”。

界面与开关

Add Server

Add Server 用于手动录入已有服务器资料,先选协议,再填写相应字段。地址和端口相同并不意味着不同协议可以共用其余参数,认证方式、传输方式与 TLS 设置仍需逐项对应。资料不完整时应向原服务提供方确认,而不是根据字段名称猜值。

界面与开关

Global Routing

Global Routing 决定整体流量处理姿态:配置对应 Config,代理对应 Proxy,直连对应 Direct。Config 按当前配置中的规则处理请求;Proxy 与 Direct 则用于整体采用代理或直连路径。正在检查某条域名规则时,应先确认处于 Config,否则规则文件的修改可能不是当前请求路径的决定因素。

界面与开关

Proxy / Direct

Proxy 与 Direct 是 Global Routing 中的界面选项,不是服务器协议名称。前者整体采用代理路径,后者整体采用直连路径;它们可以帮助缩小故障范围,但切换后访问结果仍受 DNS、目标服务与网络条件影响。规则文件里的大写 PROXY、DIRECT 属于策略关键字,见策略说明。

界面与开关

On Demand

On Demand 根据设定条件触发连接行为,解决的是何时建立或恢复连接的问题。它不负责判断每个域名走哪条路径,因此不能替代规则分流。手动关闭后又出现连接时,应检查 On Demand 条件及系统中的相关配置,而不是只删除 Home 里的服务器条目。

界面与开关

Connectivity Test

Connectivity Test 按当前选择的测试方法和目标检查响应情况,结果只描述这次测试。某个服务器测试成功,不代表所有网站、UDP 请求或应用业务均可用。测试失败时先核对测试目标、协议参数和当前网络,再结合 Log 判断失败发生在哪一层。

协议描述客户端与服务器如何交换数据,不是速度等级。录入时以用户已有资料为准;协议、认证、传输与安全层参数需要作为一组核对。

协议

Shadowsocks

Shadowsocks 使用双方约定的加密方法与密码等参数建立代理连接。服务器地址、端口、加密方法和密码需要一致,只核对密码无法排除配置错误。若资料包含额外参数,也应按原始说明填写,不能直接套用其他条目的设置。

协议

VMess

VMess 使用用户身份参数认证,并可结合不同传输方式工作。UUID 之外,还应核对传输方式、Host、Path 与 TLS 等实际提供的参数。设备时间明显不准确也可能影响认证,出现握手或认证错误时可一并检查系统时间。

协议

VLESS

VLESS 将身份识别与传输、安全层配置分开,UUID 只是连接资料的一部分。服务器要求的传输参数与安全参数必须与客户端设置对应,不能把协议名称相近当作可以互换的依据。导入后若连接失败,应先与原始资料逐项比对,而不是随意关闭安全检查。

协议

Trojan

Trojan 通常结合 TLS 使用,通过密码完成认证。连接地址、证书对应的域名以及 TLS 相关参数可能承担不同作用,不能因为地址可解析就省略其余检查。证书错误应从域名、设备时间和服务端证书状态排查,不应把跳过验证作为常规处理方式。

协议

Hysteria2

Hysteria2 是基于 QUIC 的代理协议,运行依赖相应 UDP 通信路径。地址和认证参数正确但仍无法连接时,需要确认当前网络是否允许相关 UDP 流量。带宽等可调参数应依据实际网络和服务端说明设置,提高填写数值并不等于提高可用带宽。

协议

WireGuard

WireGuard 使用公私钥与对端参数建立隧道,PrivateKey 应保密,PublicKey 用于识别相应对端。AllowedIPs 涉及路由范围,MTU 影响数据包大小,两者并非认证密码。出现部分请求卡住时,除检查握手外,还需核对地址、路由范围与 MTU。

协议

HTTP / SOCKS5

HTTP 与 SOCKS5 是两类代理协议,均可能需要地址、端口与认证信息。协议名称本身不能证明传输已加密,UDP 支持范围也需要结合具体实现和配置确认。把它们用作代理入口时,还应限制访问范围,避免将可用端口暴露给不需要使用的设备。

规则关键字

先确认当前 Config →

一条规则需要同时读懂匹配条件和末尾策略。下面示例只演示语法;example.com 是示例域名,不是服务器或订阅地址。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
规则关键字

规则

规则把请求的匹配条件与处理策略联系起来,通常按配置顺序检查,采用先匹配的条目。较具体的条件一般应放在较宽泛的条件之前,否则后面的细分规则可能没有机会命中。排查时应确认当前文件、规则顺序和实际命中记录,而不是只搜索文件里是否存在某个域名。

规则关键字

DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD

DOMAIN 匹配完整域名,DOMAIN-SUFFIX 匹配指定域名及其子域名,DOMAIN-KEYWORD 则按域名中包含的关键字匹配。例如 DOMAIN-SUFFIX,example.com,PROXY 可覆盖 example.com 及其子域名。关键字匹配范围较宽,选择前应考虑是否会连带匹配其他不相关域名。

规则关键字

GEOIP

GEOIP 根据 IP 地理归属数据库中的地区标记匹配目标地址,不依据页面显示的语种或用户所在地判断。数据库记录、DNS 解析结果及服务的地址分布都可能影响匹配。一个域名使用多个地址时,不同请求出现不同结果,需要结合实际解析地址检查。

规则关键字

IP-CIDR / IP-CIDR6

IP-CIDR 使用 IPv4 网段匹配地址,IP-CIDR6 用于 IPv6 网段,斜杠后的前缀长度决定范围大小。前缀越短,覆盖范围通常越大,因此错误的网段可能影响大量请求。域名同时返回 IPv4 与 IPv6 地址时,只检查其中一类规则不足以解释全部连接。

规则关键字

USER-AGENT

USER-AGENT 根据可见请求中的 User-Agent 字段匹配,它不是对所有应用进程的通用识别方式。加密请求中的相关字段通常不能被直接读取,不能仅凭这类规则推断某个应用的全部流量都会被命中。使用前应确认协议、字段可见性与实际匹配记录。

规则关键字

FINAL

FINAL 为前面规则没有匹配到的请求提供最终处理策略,通常放在规则列表末尾。FINAL,DIRECT 表示剩余请求使用直连路径,并不表示前面已经命中的请求也改为直连。修改最终策略可能影响大量未单独列出的目标,应先保留原文件以便恢复。

规则关键字

PROXY / DIRECT / REJECT

PROXY、DIRECT、REJECT 是规则中的策略关键字,分别表示交给代理路径、直接连接和拒绝请求。它们不是域名匹配条件,也不是三种服务器协议。遇到请求被拒绝时,应先找命中的 REJECT 规则;遇到出口不符时,则应核对命中的策略及其实际指向。

订阅与配置

查看导入流程 →

服务器条目负责连接资料,订阅负责成组更新,Config 负责配置内容。导入成功只代表资料被读取,连接与规则是否符合预期仍需验证。

订阅与配置

Subscribe

Subscribe 用于保存并更新一组服务器条目,链接来自用户已有的服务资料。更新可能改变条目名称、数量或参数,但不应据此假定当前 Config 也已同步替换。订阅链接可能携带个人访问凭据,截图、日志或求助内容中应移除完整链接。

订阅与配置

服务器 / 节点

服务器或节点在这里指一组可被客户端选用的远端连接参数,通常包括地址、端口、协议及认证信息。列表中的显示名称便于辨认,并不能单独证明实际位置、带宽或可用性。手动修改订阅生成的条目前,应考虑后续更新是否会覆盖修改。

订阅与配置

Config

Config 既可指管理配置文件的界面入口,也可指 Global Routing 中按配置处理请求的姿态。配置文件可能包含规则、DNS 及其他设置,但具体内容取决于文件本身,不能把订阅列表直接当作完整配置。切换或远程更新前应备份当前文件,并确认引用资源与最终策略。

订阅与配置

Scan QR Code

Scan QR Code 从二维码读取连接资料,二维码承载的可能是单个服务器信息,也可能是可识别的链接。扫描不是连接验证,导入后仍应检查协议、地址、端口和认证字段。二维码本身可能包含敏感信息,不宜公开展示用户实际使用的完整图像。

订阅与配置

URL Rewrite

URL Rewrite 根据匹配条件处理请求 URL,与决定请求走代理还是直连的规则分流不是同一层功能。它能处理的内容受协议、加密状态和具体配置条件限制,不能视为对所有请求都生效。使用已有配置时应逐条理解作用范围,避免不明规则改变正常请求。

Settings 设置项

逐项查看设置含义 →

调整设置前先记录原值,每次只改变一个变量。默认值及可用选项以当前应用界面为准;术语解释不代替针对实际网络条件的判断。

Settings 设置项

DNS

DNS 将域名解析为地址,解析成功与目标连接成功是不同阶段。DNS 查询使用的路径也不能直接证明业务流量的最终出口,需要结合规则和连接记录分别核对。出现域名访问失败但地址可达时,可以先检查解析响应、缓存及配置中的 DNS 设置。

Settings 设置项

Ping / 延迟

Ping 或延迟结果描述指定测试条件下的响应耗时,并不直接代表下载速度。不同测试方法、测试目标和网络负载会产生不同结果,因此比较时应保持方法一致。某次超时也不一定等于服务器完全不可用,应结合实际请求与 Connectivity Test 继续判断。

Settings 设置项

Log

Log 记录连接、匹配或错误信息,可用于区分解析失败、认证失败和目标拒绝等情况。排查时先复现一次问题,再寻找相同时间附近的记录,避免被历史错误干扰。分享日志前应移除服务器地址、认证信息、订阅链接及可识别个人访问内容的数据。

Settings 设置项

Widget

Widget 是由系统展示应用状态或提供操作入口的小组件,可用内容取决于平台与当前应用能力。小组件的刷新时机受系统机制影响,显示内容可能不是即时状态。判断是否已连接时,应回到应用及系统连接状态核对,不只依据小组件的一次显示。

Settings 设置项

iCloud 同步

iCloud 同步在可用设备和账号条件下同步应用所支持的数据,不能等同于完整设备备份。系统权限、连接授权和部分本地设置仍可能需要在新设备上重新确认。换机前应检查同步是否完成,并另外导出重要 Config 文件,恢复后再验证服务器选择与规则行为。

Settings 设置项

Proxy 端口

Proxy 端口是提供代理服务时监听的本地端口,与远端服务器所使用的端口不是同一个参数。其他设备能否访问,还取决于监听地址、局域网权限及防火墙设置。没有跨设备使用需求时应限制访问范围,调整端口后也要同步检查调用方使用的地址与端口。