官方手册 / 名词解释

Shadowrocket 名词解释

先辨认设置所在层级,再核对参数与规则。界面词、协议名和规则关键字保留英文原文,中文解释用于说明它们控制什么,以及不能据此推断什么。

需要操作步骤时,转到入门指南;需要按设备获取应用时,查看全平台下载页。本页不提供、不销售、不推荐节点或订阅。

01 / 界面与开关

连接状态与处理姿态

列表、开关与路由姿态各有职责。看到条目、选中条目和建立连接,不是同一个状态。

界面与开关

Home

Home 用于查看已有服务器条目及连接相关状态,通常也是开始检查所选条目的位置。条目出现在列表中只说明信息已保存,不表示服务器已经可达;排查时还应确认当前选择、连接开关与实际请求结果。

界面与开关

Global Routing

Global Routing 决定整体流量处理姿态:配置对应 Config、代理对应 Proxy、直连对应 Direct。Config 按当前配置规则处理连接,Proxy 与 Direct 则采用各自的整体姿态;它与单条规则末尾的 PROXY、DIRECT 动作不是同一层级,排查分流前先核对这里。

界面与开关

On Demand

On Demand 根据已有条件请求系统按需建立连接,不应理解为持续检测并修复所有连接故障。它不能修正错误的服务器密码、端口或传输参数;调整前先确认手动连接可用,再核对条件与系统权限。

界面与开关

Add Server

Add Server 是手动添加服务器条目的入口,应以用户已有的服务器信息逐项填写。先选正确的协议类型,再核对地址、端口、认证和传输参数;不同类型的字段不能仅凭名称相近就互相套用。

界面与开关

Connectivity Test

Connectivity Test 用于检查当前测试目标和测试方式下的连通性,结果受本地网络、服务器响应及目标状态影响。显示的耗时不等于文件下载速度,测试成功也不代表所有应用请求都会成功;应结合实际失败目标复核。

界面与开关

DNS

DNS 负责把域名解析为 IP 地址,解析结果会影响后续连接及部分地址规则的判断。域名打不开可能发生在解析阶段,也可能发生在连接阶段;修改 DNS 前先区分这两种情况,避免同时改动多项设置而失去对照。

02 / 协议

类型、认证与传输

协议名只说明连接机制的一部分。使用用户已有信息核对完整参数,不按协议名称推断速度或可用性。

协议

Shadowsocks

Shadowsocks 是一种代理协议,基本信息包括服务器地址、端口、加密方式和密码。客户端选项必须与服务器端一致;地址和端口相同但加密方式不同,仍可能无法通信,不能仅凭条目名称判断配置正确。

协议

VMess

VMess 使用身份标识及相关认证参数,实际连接还可能配合不同传输方式和 TLS 设置。核对时应把身份标识、传输路径、服务器名称等分开检查;系统时间明显不准也可能影响认证,不能只反复更换端口。

协议

VLESS

VLESS 将身份认证与传输层设置分开处理,配置时需要同时核对身份标识及配套传输参数。协议名称本身不代表内容已经加密,实际保护方式取决于搭配的安全机制;导入后不要自行把安全选项改成看似相近的值。

协议

Trojan

Trojan 通常结合 TLS 使用,认证密码、端口和服务器名称都可能影响连接结果。证书验证失败时,应检查设备时间、服务器名称与证书是否匹配,而不是把关闭验证当作常规处理;参数来源以用户已有服务器信息为准。

协议

Hysteria2

Hysteria2 基于 QUIC,连接依赖相应的 UDP 通信条件,并涉及认证与 TLS 参数。普通网页可打开,不代表同一网络允许所需的 UDP 通信;排查时应分别检查本地网络、服务器监听和配置内容,不根据协议名预判传输表现。

协议

WireGuard

WireGuard 是使用公私钥识别对端的隧道协议,密钥、对端地址、隧道地址及路由范围需要相互对应。建立握手与目标地址可达是不同检查点;私钥属于敏感信息,公开排查材料时应删除,不能把整份配置直接发布。

协议

HTTP

HTTP 作为服务器类型时表示 HTTP 代理,不是要求把目标网页地址填入服务器地址栏。是否需要用户名、密码及 TLS 取决于该代理的实际设置;目标网页使用 HTTPS,也不等于客户端到代理这一段必然使用 TLS。

协议

SOCKS5

SOCKS5 是一种通用代理协议,可根据服务器配置使用用户名和密码认证,但协议本身不提供内容加密。UDP 能否使用还取决于两端实现和网络条件;TCP 请求可用时,不能据此认定所有依赖 UDP 的请求也可用。

03 / 规则关键字

匹配对象与书写范围

规则从上往下检查,首条命中决定动作。示例使用保留域名与文档地址,仅用于说明格式。

规则关键字

DOMAIN

DOMAIN 精确匹配指定域名,例如 DOMAIN,example.com,DIRECT。这条规则不会自动覆盖 www.example.com;需要覆盖子域名时,应检查是否更适合使用 DOMAIN-SUFFIX,而不是逐字猜测匹配范围。

规则关键字

DOMAIN-SUFFIX

DOMAIN-SUFFIX 匹配指定域名及其子域名,例如 DOMAIN-SUFFIX,example.com,PROXY 同时覆盖该域名与其下级域名。它按域名边界判断,不会因为其他域名中含有相似字符串就命中,适合表达同一域名体系的共同动作。

规则关键字

DOMAIN-KEYWORD

DOMAIN-KEYWORD 检查域名是否包含指定字符串,例如 DOMAIN-KEYWORD,ads,REJECT。它不要求完整域名或域名后缀相同,因此短关键词可能误伤正常请求;添加前应核对连接记录中的完整域名。

规则关键字

GEOIP

GEOIP 根据 IP 地理数据库分类匹配目标地址,例如 GEOIP,CN,DIRECT。数据库结果不是对运营主体或用户所在地的判断;同一网站使用多个地址时,分类也可能不同,应结合实际目标地址核对。

规则关键字

IP-CIDR / IP-CIDR6

IP-CIDR 按 IPv4 网段匹配,IP-CIDR6 用于 IPv6,斜杠后的前缀长度决定覆盖范围。IP-CIDR,192.0.2.0/24,DIRECT 是文档地址示例;规则针对目标地址,不是按网页名称匹配,修改前缀长度会改变影响范围。

规则关键字

FINAL

FINAL 处理前面规则均未命中的连接,例如 FINAL,PROXY 指定兜底动作。它通常位于规则列表末尾;如果提前出现,后续规则可能没有机会处理连接,因此排查顺序时不仅要看规则内容,也要看位置。

04 / 策略动作

命中后的连接处理

实心点、空心圈、斜线圈分别标记三种动作。符号只是本站的阅读标记,不是应用内状态指示。

策略动作

PROXY

PROXY 是规则中的代理动作,命中后按当前代理选择处理该连接。它不会自动提供服务器,也不保证所选服务器可达;看到规则命中但请求失败时,还要检查已有服务器条目、认证参数和连接状态。

策略动作

DIRECT

DIRECT 表示匹配连接不经代理服务器,使用本地网络直接访问目标。直连仍可能遇到 DNS、路由或目标服务故障,不能等同于“必定成功”;它是单条规则的动作,与 Global Routing 中的 Direct 姿态应分开理解。

策略动作

REJECT

REJECT 用于拒绝命中的连接,常见检查点是匹配条件是否过宽,以及是否位于更具体规则之前。页面内容缺失或应用部分功能失败时,可先在记录中确认是否命中该动作,再修改对应条件,避免一次停用全部规则。

05 / 订阅与配置

条目、配置与恢复

订阅负责更新条目,配置负责组织处理规则,购买记录负责找回应用。三者不能互相替代。

订阅与配置

Subscribe

Subscribe 通过用户已有的订阅地址获取或更新服务器条目,地址从用户自己的服务商处获取。更新可能改变条目内容与数量,手动修改也可能被覆盖;订阅地址可能携带访问凭据,应避免放入公开截图、日志或共享文档。

订阅与配置

SERVER

SERVER 表示服务器相关条目或信息,通常包含地址、端口、协议和认证参数。服务器条目主要回答“如何连接”,不等同于含 DNS、规则与其他设置的完整配置;导入一条服务器信息后,不应假定分流规则也随之建立。

订阅与配置

Config

Config 既可表示配置文件管理入口,也出现在 Global Routing 的配置姿态名称中,需根据所在位置判断。导入文件与选中启用是两个操作;调整前先备份当前文件,再核对实际生效项,避免把导入成功误认为已切换完成。

订阅与配置

iCloud 同步

iCloud 同步是在支持该功能的设备与设置条件下同步相关数据的方式,实际范围以应用和系统中的可用选项为准。同步不等于独立备份,删除或修改也可能同步到其他设备;迁移前应核对内容,并单独保留所需配置导出文件。

订阅与配置

已购项目

已购项目是 App Store 中查找同一购买账户历史应用的入口,找回应用不等于自动恢复配置。iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费;重新获取应用与恢复服务器服务是两回事。