Shadowrocket 官方手册 · 术语参考

Shadowrocket 名词解释

按界面位置与配置用途查词。先区分连接模式、服务器协议与规则策略,再调整对应设置;同一个英文词出现在不同位置时,作用可能不同。

本页解释名词,不代替操作步骤。首次使用可查阅教程,获取客户端请前往下载指南。

01 · 界面与开关

页面入口与连接模式

界面选项使用首字母大写写法;规则中的策略关键字使用全大写。不要仅凭名称相近就认为两者作用相同。

界面与开关

Home

Home 是查看服务器列表、确认默认服务器和控制连接的主要页面。导入信息后,应先点选要使用的服务器,确认选中标记,再打开连接开关。列表中存在服务器不代表已经选中,也不代表连接已经建立。

界面与开关

Config

作为页面名称时,Config 用于管理和选择配置文件;作为 Global Routing 的选项时,Config 表示依据配置规则处理流量。这两个位置关联但不相同:有配置文件,还需要确认已启用正确文件并选择相应模式。排查规则未生效时,应同时检查这两处。

界面与开关

Global Routing

Global Routing 决定整体采用哪一种路由模式,三种姿态为配置 Config、代理 Proxy、直连 Direct。需要按域名或 IP 分流时,通常应检查 Config,而不是只改服务器。修改此处会改变受接管流量的处理方式,测试结束后应恢复预期模式。

界面与开关

Proxy

Proxy 是 Global Routing 中的代理模式,用于让受接管流量采用代理路径,可帮助判断问题是否与分流规则有关。它不等同于某条规则结尾的 PROXY:前者是整体模式,后者是单条规则的处理策略。采用 Proxy 也不会修复失效的服务器参数或不可达的远端服务。

界面与开关

Direct

Direct 是 Global Routing 中的直连模式,用于让受接管流量采用直连路径。它可以作为对照,检查目标在本地网络中是否能够访问,但不表示客户端连接开关已经关闭。若要恢复配置规则分流,需要重新选择 Config。

界面与开关

On Demand

On Demand 按设置的网络条件触发连接,解决的是何时尝试连接,而不是流量命中哪条规则。需要自动连接时,应检查 Settings 中对应条件与当前网络是否一致。手动断开后再次出现连接,应先检查这里的触发设置,而不是立即删除配置。

界面与开关

Connectivity Test

Connectivity Test 用于检查连接可达性,适合在选中默认服务器并打开连接后运行。测试成功说明该次测试路径能够完成请求,不代表所有网站和应用都具有相同结果。测试失败时,应结合本地网络、服务器参数、DNS 与当前路由模式继续定位。

02 · 协议

服务器类型与传输条件

协议类型必须与已有服务器资料一致。协议名称不能代替完整参数,也不能单独说明连接速度。

协议

Shadowsocks

Shadowsocks 是一种代理协议,常见必要参数包括服务器地址、端口、加密方法和密码。客户端与服务器的加密方法需要一致,不能只核对地址与密码。若资料还包含额外传输选项,也应按原始信息逐项确认。

协议

VMess

VMess 是带身份验证的代理协议,用户标识与传输设置共同决定连接能否建立。导入后应核对服务器地址、端口、用户标识,以及资料中提供的 TLS、Host 或路径等项目。连接失败不能仅凭协议名判断原因,系统时间异常也值得检查。

协议

VLESS

VLESS 是一种代理协议,其身份参数与传输层配置需要分别核对。选择 VLESS 并不等于所有加密与证书选项已经自动配置完成;TLS 等保护取决于具体连接方式。填写时应以已有服务器资料为准,不把其他协议的参数直接套用。

协议

Trojan

Trojan 通常结合 TLS 使用,连接需要正确的服务器地址、端口和密码。涉及证书验证时,还应核对服务器名称等相关设置是否与服务端一致。不应把关闭证书验证作为常规修复步骤,应先排除名称错误、系统时间和证书配置问题。

协议

Hysteria2

Hysteria2 是基于 QUIC 的代理协议,其连接依赖相应的 UDP 网络条件。即使地址和认证信息正确,本地网络限制 UDP 也可能导致连接失败。带宽相关选项应结合实际线路能力设置,填写更大的数值不代表实际速度会提高。

协议

WireGuard

WireGuard 是基于密钥的隧道协议,配置通常涉及密钥、端点、接口地址和路由范围。路由范围决定哪些目标进入隧道,不只是填写服务器地址即可完成设置。私钥属于敏感信息,排查或分享截图前应移除,不能公开完整配置。

协议

HTTP

HTTP 作为服务器类型时,指的是 HTTP 代理,不是简单判断目标网站网址是否以 HTTP 开头。此类代理可通过 CONNECT 处理相应的隧道请求,具体支持范围取决于服务端。若服务器要求认证,应同时填写正确的用户名与密码。

协议

SOCKS5

SOCKS5 是一种通用代理协议,服务器可能要求用户名与密码,也可能采用其他访问限制。能否处理 UDP 等流量取决于服务器能力与客户端配置,不能从名称直接推断。SOCKS5 本身不等于传输内容已经加密,仍需区分代理协议与应用自身的加密连接。

03 · 规则关键字

匹配条件与处理策略

先看规则匹配什么,再看结尾使用什么策略。示例中的 example.com 仅用于解释语法,不表示服务推荐。

规则关键字

规则

规则是依据域名、IP 或其他条件选择处理方式的配置条目,通常由上向下匹配,命中后采用相应策略。具体条件宜放在宽泛条件前面,避免被前面的规则提前覆盖。规则分流需要在 Global Routing 使用 Config,并确认启用的是预期配置文件。

规则关键字

DOMAIN

DOMAIN 精确匹配指定域名,不自动包含所有子域名。例如针对 example.com 的条目不等于同时覆盖 api.example.com。需要明确控制一个主机名时可使用它,填写内容应是域名,不是带路径的完整网址。

规则关键字

DOMAIN-SUFFIX

DOMAIN-SUFFIX 匹配指定域名及其子域名,适合把同一域名下的一组服务交给相同策略。例如 example.com 可覆盖 api.example.com,但不表示任意包含 example 字符的域名都会命中。若某个子域名需要例外处理,应把更具体的规则放在前面。

规则关键字

DOMAIN-KEYWORD

DOMAIN-KEYWORD 根据域名中是否包含指定关键词进行匹配,覆盖范围通常比 DOMAIN-SUFFIX 更宽。关键词过短容易影响原本无关的域名,因此不适合仅凭猜测大量添加。出现误分流时,应先检查是否有宽泛关键词规则排在前面。

规则关键字

GEOIP

GEOIP 根据 IP 数据库的地区分类进行匹配,不是判断域名使用哪种语言,也不代表精确物理位置。内容分发网络与数据库变化可能使同一域名在不同时间得到不同结果。排查时应结合实际解析到的 IP 与规则命中情况,不只依据网站名称判断。

规则关键字

IP-CIDR

IP-CIDR 用于匹配 IPv4 地址段,地址后的前缀长度表示网络范围。例如 192.168.0.0/16 描述一个私有地址段,而不是单个设备地址。面向域名的请求是否涉及解析,还与配置选项有关,不能用地址段规则替代所有域名判断。

规则关键字

IP-CIDR6

IP-CIDR6 用于匹配 IPv6 地址段,其前缀写法与 IPv4 的 IP-CIDR 对应,但地址格式不同。只编写 IPv4 规则不代表已经覆盖同一服务的 IPv6 连接。设备使用双栈网络时,应分别检查解析结果与两类地址的处理策略。

规则关键字

FINAL

FINAL 是前面的规则均未命中时采用的兜底规则,通常放在规则列表末尾。它决定未被明确列出的目标如何处理,不是额外运行一次完整匹配。修改 FINAL 会影响大量未分类请求,因此应先确认具体规则是否缺失,再调整兜底策略。

规则关键字

PROXY / DIRECT / REJECT

PROXY 表示使用代理路径,DIRECT 表示直连,REJECT 表示拒绝请求;它们回答的是匹配之后怎么处理。三者不是服务器协议,也不应与 Global Routing 中的 Proxy、Direct 界面选项混写。本站以蓝、绿、橙状态点区分三种策略,实际配置仍需使用英文关键字。

04 · 订阅与配置

导入入口与文件用途

服务器条目决定连接到哪里,配置文件决定怎样处理流量。导入其中一种,不代表另一种也已完成。

订阅与配置

Subscribe

Subscribe 是添加或管理已有订阅的相关入口,用于获取及更新服务器条目。应使用用户从自己的服务商处取得的有效链接,并在更新后检查条目是否正常出现。订阅更新不应被理解为自动替换所有规则与 DNS 设置,需确认导入内容的实际类型。

订阅与配置

Add Server

Add Server 是添加服务器信息的入口,需要先按已有资料选择正确类型,再填写地址、端口与认证参数。不同协议显示的字段可能不同,缺少的参数应向原信息提供方核实。保存后还要回到 Home 选中服务器,单纯保存条目不会完成连接验证。

订阅与配置

订阅

订阅是可供客户端读取并更新服务器列表的数据来源,不是客户端本身的购买凭证。订阅链接可能包含个人访问凭据,不应公开发布或完整贴进求助截图。更新失败时,应先核对链接有效性、当前网络和返回内容,而不是反复修改所有服务器参数。

订阅与配置

配置文件

配置文件用于组织规则、DNS 与其他连接选项,与只更新服务器列表的订阅用途不同。导入文件后,应确认启用对象,再检查 Global Routing 是否为 Config。替换前宜保留原有可用文件,避免排查时同时改变服务器、规则和 DNS 而失去对照。

05 · DNS 与网络

解析、响应时间与请求处理

连接可达、域名可解析、页面能打开和下载速度正常是不同观察结果,应分别验证。

DNS 与网络

DNS

DNS 将域名解析为 IP 地址,是访问多数网络服务的前置环节。解析结果会影响实际目标地址,也可能影响基于 IP 的规则匹配。出现域名打不开但已知地址可达的情况时,可优先检查解析路径,同时注意缓存可能让设置修改后的结果暂时保持不变。

DNS 与网络

DNS over HTTPS

DNS over HTTPS 通过 HTTPS 传输 DNS 查询,常缩写为 DoH。它改变的是查询传输方式,不是让全部应用流量自动采用代理,也不能单独修复服务器故障。设置前应确认解析服务地址和可达性,并与原有 DNS 方案做单变量对照测试。

DNS 与网络

延迟

延迟是特定测试方式与目标下得到的响应时间,不能直接等同于下载速度。较低的测试数值不保证大文件吞吐量更高,超时也需要结合测试目标是否可达分析。比较不同结果时,应尽量保持本地网络、测试方法和目标一致,避免把条件变化误认为服务器变化。

DNS 与网络

URL Rewrite

URL Rewrite 按表达式处理匹配到的 URL,与为连接选择出口的规则分流不是同一功能。规则是否生效取决于匹配范围及请求是否具备可处理条件,不能只凭域名相同判断。涉及 HTTPS 内容处理时,还应单独理解证书与信任设置的影响,不宜在不了解用途时直接启用整组条目。

按问题继续查阅

若问题是“已导入但无法连接”,先按 Home、Add Server、Connectivity Test 的顺序检查;若问题是“某个目标走错路径”,先确认 Global Routing,再检查具体规则与 FINAL。每次只修改一个相关项目,并记录修改前后的现象。

iPhone / iPad 的系统要求以 App Store 页面标注为准。界面项目的具体位置可能随设备与应用调整而变化,查词时应同时核对所在页面和字段上下文。