官方手册 · 概念速查

Shadowrocket 术语与概念

按界面位置理解设置,按匹配条件理解规则。英文名称保留原样,中文说明用途、边界与常见混淆。

先区分模式、规则与服务器

Global Routing 决定整体处理方式,Rule 决定哪些连接匹配哪些策略,SERVER 提供实际连接参数。这三层不是同一个设置。排查时先确认当前模式,再看命中的规则,最后核对服务器信息,避免在不同层级之间来回修改。

本页界面说明以 iPhone/iPad 为例,其他平台的项目位置可能不同。Shadowrocket 是全平台闭源商业应用:iPhone / iPad 版在 App Store $2.99 一次性付费,Mac(Apple 芯片与 Intel)/ Windows / 安卓 / Linux 版免费。获取方式与本站 /dl/ 安装包入口统一见下载页;iPhone/iPad 系统要求以 App Store 页面标注为准。

界面与开关

先认清设置所在的位置。相似的英文词可能分别表示整体模式、页面名称或规则策略。

Global Routing

这是决定整体流量处理方式的入口,三种姿态为配置、代理、直连,对应界面词 Config / Proxy / Direct。它先决定是否按配置中的规则分流,因此修改某条 Rule 之前,要先确认当前是否选择 Config。切换姿态不等于更换服务器,也不会自动补齐缺失的认证参数。

Config

在 Global Routing 中,Config 表示按照当前配置的规则处理连接;作为页面名称时,Config 用于管理和选择配置文件。看到这个词时,应先判断它是模式选项还是配置管理入口。导入了一份配置文件,不代表它已经成为当前生效的配置,使用前还要检查选择状态。

Proxy

这是 Global Routing 中的代理模式,连接交由当前代理选择处理,而不是逐条执行 Config 的分流判断。可在诊断时与其他姿态作受控比较,但测试后应恢复原本需要的模式。首字母大写的 Proxy 是界面模式,不能与规则行中的全大写 PROXY 混为一谈。

Direct

这是 Global Routing 中的直连模式,连接直接访问目标,不通过代理服务器。它可用于对照本地网络是否能访问同一目标,但不负责修复 DNS、目标服务或路由本身的问题。规则中的 DIRECT 只作用于命中该策略的连接,作用范围与这个整体模式不同。

On Demand

这是根据预先设置的网络条件触发 VPN 连接行为的功能,条件应按实际设备环境配置。它回答的是何时发起连接,而 Rule 回答连接建立后如何处理流量。启用后若出现断开又连接的现象,应先检查相关条件,再判断是否为连接异常。

Settings

这是客户端设置的集中入口,与 Home 中选择服务器的操作不同。设置项目及位置应以设备上的实际界面为准,不必照着其他平台的路径寻找同名按钮。诊断时每次只改一项,并记录原值,才能判断变化是否与当前问题有关。

协议

协议是客户端与服务器协作的方式,不是速度等级。导入时以已有服务器提供的类型与参数为准。

Shadowsocks

这是一种代理协议,需要服务器地址、端口、密码和加密方法等信息相互对应。仅有地址和端口通常不足以建立正确连接,加密方法也不能凭名称相近随意替换。若已有配置包含额外传输参数,应按原始信息核对,而不是自行省略。

VMess

这是一种使用身份标识等参数进行认证的代理协议。协议类型、身份信息、传输方式和 TLS 设置属于不同字段,识别出 VMess 并不代表其他参数已经正确。手动录入时还应核对设备时间与服务器信息,避免把认证失败直接当作网络不通。

VLESS

这是一种代理协议,身份认证与传输安全需要分开理解。协议名称本身不能说明 TLS 是否启用,传输方式、服务器名称等设置仍需与服务端一致。不要通过反复切换协议类型修复一个已有条目,应回到原始配置信息逐项比较。

Trojan

这是一种通常结合 TLS 使用的代理协议,需要核对认证密码、端口与服务器名称。TLS 验证依赖证书与名称等条件,IP 地址能够响应不代表认证和证书检查也能通过。出现证书相关错误时应先检查域名、设备时间与原始参数,不应直接关闭验证来掩盖原因。

Hysteria2

这是一种基于 QUIC 的代理协议,连接过程依赖 UDP 网络条件。认证、TLS 以及其他传输参数都应与服务器设置对应,不能只填写一个服务器地址。某一网络下失败时,可以保持参数不变更换网络作对照,以区分网络条件与配置问题。

WireGuard

这是一种基于密钥的隧道协议,配置通常涉及接口地址、密钥、对端端点与路由范围。私钥属于敏感信息,分享配置或排障图片前需要移除。隧道能够建立与目标网络能够访问是两件事,仍需检查地址范围、DNS 和对端路由。

HTTP / SOCKS5

这是两种不同的代理协议,地址相同也不能据此互换类型。是否需要账号认证、支持哪些流量,应以服务器提供的信息为准。协议名称本身不表示已经启用加密传输,不能仅凭 HTTP 或 SOCKS5 字样判断整条连接的传输保护情况。

规则关键字与策略

关键字描述“匹配什么”,策略描述“匹配后怎么处理”。下列示例只说明语法,不是可直接覆盖现有配置的完整规则集。

Rule

一条 Rule 通常包含匹配类型、匹配内容和处理策略,规则一般从上到下检查。较宽泛的条目放在前面,可能使后面的具体条目没有机会生效。排查时应检查首次命中的规则,而不是只确认列表里是否存在某个域名。

DOMAIN

这个关键字按完整域名匹配,例如 DOMAIN,example.com,DIRECT。它不会自动包含所有子域名,也不把 URL 路径当作域名的一部分。需要同时处理主域名和下级域名时,应理解 DOMAIN-SUFFIX 的范围后再选择写法。

DOMAIN-SUFFIX

这个关键字匹配指定域名及其子域名,例如 DOMAIN-SUFFIX,example.com,PROXY。它按域名后缀边界理解范围,不是任意位置出现相同文字就算命中。不要在匹配内容中加入 https:// 或页面路径。

GEOIP

这个关键字根据目标 IP 在地理数据库中的分类匹配,例如 GEOIP,CN,DIRECT。判断依据是连接对应的目标地址与数据库,而不是网站显示的语言或注册信息。内容分发网络和地址分配变化可能影响分类,因此不能把它理解为对网站身份的固定判断。

IP-CIDR / IP-CIDR6

这两个关键字分别匹配 IPv4 与 IPv6 地址段,斜杠后的前缀长度决定范围。例如 IP-CIDR,192.168.0.0/16,DIRECT 表示匹配这一 IPv4 地址段。它关注的是 IP,不会根据某个域名自动追踪其所有后续地址变化。

FINAL

这是前面的规则都未命中时使用的兜底条目,例如 FINAL,PROXY。通常应放在规则列表末尾,否则可能提前接走本应由后续规则处理的连接。修改它会影响所有未被前面条目覆盖的目标,调整前应先确认现有分流意图。

PROXY

这是规则中的代理策略标记,表示匹配连接交由代理路径处理。实际连接仍依赖当前选择及对应服务器是否可用,命中 PROXY 不等于目标一定能够访问。它是规则结果,不是 Global Routing 中的 Proxy 整体模式。

DIRECT

这是规则中的直连策略标记,表示匹配连接直接访问目标,不经过代理服务器。设备仍需要正常的本地网络与相应的名称解析条件。某条连接走 DIRECT 并不代表客户端整体处于 Direct 模式,其他连接仍可能匹配不同策略。

REJECT

这是规则中的拒绝策略标记,表示拒绝匹配到的连接。范围过宽时可能连带影响正常页面依赖的资源,因此不能只根据一段模糊名称就大范围添加。修改后若出现局部内容缺失,应核对命中记录和规则顺序,再决定是否缩小匹配范围。

订阅与配置

订阅更新服务器条目,配置描述处理方式;备份与同步则解决数据保存问题,三者不能互相替代。

Subscribe

这是通过用户已有订阅地址获取和更新服务器条目的方式,不是连接服务本身。更新可以改变条目列表,但不会自动修复订阅过期、认证失效或服务端故障。订阅地址可能携带访问凭据,不应公开粘贴到留言、截图或可共享文档中。

SERVER

服务器条目不只是一个地址,还包含端口、协议、认证信息以及可能存在的传输参数。列表中的名称通常只是便于辨认的标签,不能据此判断真实地理位置或连接表现。若需要更正参数,应以用户已有服务器的原始信息为准。

Add Server

这是手动创建服务器条目的入口,适用于已经掌握完整服务器信息的情况。先选择正确的协议类型,再按字段录入地址、端口与认证参数,避免把不同协议的字段相互套用。保存后还需选中条目并验证连接,保存动作本身不表示服务器已经可用。

iCloud 同步

这是借助 iCloud 在适用设备间同步应用所支持数据的方式,需要相应账号与系统条件。同步不等于独立备份,误删或错误修改也可能传播到其他设备。换机前应另行保存需要的配置,恢复后逐项核对当前 Config、服务器条目与订阅状态。

连接与诊断

先明确测试对象,再解释结果。连接状态、解析结果、响应时间与实际页面访问分别回答不同问题。

DNS

这是把域名解析为 IP 地址的过程,常发生在实际访问目标之前。解析成功不表示连接一定成功,而连接失败也不一定是 DNS 故障。排查时应分别检查解析结果、当前路由策略与目标服务,不要只凭页面打不开就连续更换 DNS 设置。

Connectivity Test

这是检查条目连接表现的工具,结果取决于当前选择的测试方式、目标和网络条件。测试有响应,只能说明相应测试路径在当时获得了结果,不能替代实际业务访问。比较多个条目时应保持测试条件一致,并在最终选择后访问自己真正需要的目标。

延迟

延迟是一次测试条件下测得的响应时间,不是下载速度,也不是吞吐量。较低的数值不代表所有网站都会更快,实际表现还受到目标位置、丢包、拥塞与服务器负载等因素影响。单次超时同样不足以下结论,应在相同条件下复测并结合实际访问判断。

Data

这是用于查看流量记录或连接统计的页面,具体项目以当前界面为准。客户端记录与服务商的计费范围、统计周期可能不同,不能用一个总量直接推断另一个账单。诊断时应关注与问题对应的目标、时间和策略信息,分享记录前移除私人地址与认证信息。

URL Rewrite

这是针对符合条件的 URL 执行重写处理的配置能力,与选择 PROXY 或 DIRECT 路径不同。域名规则负责流量分流,URL Rewrite 则关注请求地址的匹配与处理。HTTPS 下能否处理相应内容取决于加密与相关配置条件,不能假定添加一条重写规则就会对所有请求生效。

从术语回到操作

首次配置时,按入门教程完成已有信息导入、Global Routing 选择与连接验证。需要逐阶段检查权限、配置、流量与日常维护时,转到完整使用手册;遇到某个明确错误,再按FAQ缩小排查范围。

阅读顺序建议:Global Routing → Config → Rule → PROXY / DIRECT / REJECT → DNS。先建立层级关系,再研究某个协议的参数,能减少把路由问题误当作认证问题的情况。

返回术语分类 ↑
Shadowrocket 全平台下载