OFFICIAL MANUAL · GLOSSARY

Shadowrocket
概念与规则速查

先辨认术语属于哪一层,再修改对应设置。本页按英文界面词、协议名与规则关键字解释含义;需要连续操作时,转到使用说明。

UI · 界面层 RULE · 规则层

注意大小写:Proxy 是界面姿态,PROXY 是规则策略;不要把两者当成同一处设置。

01 / INTERFACE & SWITCHES

界面与开关

界面入口用于组织操作,Global Routing 用于决定整体处理姿态。先确认入口与姿态,再讨论具体规则是否命中。

UI

Home

Home 是查看服务器条目与连接状态的起点。连接前先确认当前选中的条目,再检查 Global Routing;仅看到条目存在,并不代表它已经通过认证或可用。需要添加信息时,从 Add Server 或已有订阅导入流程继续。

UI

Global Routing

Global Routing 决定整体流量处理方式,三种姿态为 Config(配置)、Proxy(代理)、Direct(直连)。Config 依据当前配置判断去向;另外两种姿态用于选择整体代理或直连路径。排查前应记录当前姿态,避免把姿态变化误认为规则变化。

UI

Config

Config 既可指配置管理界面,也可指 Global Routing 中按配置处理的姿态,需结合所在位置理解。选择该姿态后,流量去向由当前生效配置决定。导入一份文件并不等于已经启用它,应再核对当前配置及 Rule 内容。

UI

Proxy

Proxy 是 Global Routing 中使用代理路径的姿态,可用于检查当前服务器连接是否正常。若 Proxy 下能访问、Config 下异常,应进一步检查规则与解析设置。它不是规则行中的大写 PROXY,测试完成后应恢复原本需要的姿态。

UI

Direct

Direct 是 Global Routing 中使用直连路径的姿态,可用来观察当前网络的直接访问表现。它不会删除已保存的服务器或配置,也不等同于关闭系统 VPN 状态。诊断时要分别记录路由姿态、连接开关与目标访问结果。

UI

On Demand

On Demand 根据设定条件触发连接行为,可涉及 Wi-Fi、蜂窝网络或域名等条件。若手动断开后又出现连接,先检查是否仍有触发条件成立。调整时逐条确认条件与顺序,并在实际网络切换后验证,不要只观察开关外观。

UI

Settings

Settings 是管理应用相关设置的入口,具体选项应以当前应用内文案为准。遇到故障时先记录原值,再一次修改一个变量,避免同时改变多处后失去判断依据。配置文件中的同类设置也应一起核对,不能仅凭入口名称判断最终行为。

UI

Data

Data 用于查看流量与请求相关记录,适合作为实际访问后的核对入口。流量数值增长只能说明发生了活动,不能单独证明请求走了预期策略。排查时结合目标域名、命中规则与连接结果阅读,分享记录前先清理敏感信息。

02 / PROTOCOLS

协议

协议决定两端如何建立连接与交换数据。类型选择必须与已有服务器信息一致,名称相近或字段相似并不代表参数可以互用。

PROTOCOL

Shadowsocks

Shadowsocks 是需要两端使用一致加密方法与凭据的代理协议。填写时核对地址、端口、密码及服务端要求的附加参数,不要只检查密码。导入后若不能连接,应回到原始资料逐项比对,而不是任意更换加密方法。

PROTOCOL

VMess

VMess 使用身份信息进行认证,传输方式与 TLS 设置也会影响连接建立。服务器地址、用户标识、路径及服务器名称可能分别承担不同作用,不能互相替代。认证信息正确但连接失败时,还需检查设备时间及对应传输参数。

PROTOCOL

VLESS

VLESS 将身份认证与传输安全配置分别处理,用户标识本身不代表链路已经得到完整保护。添加条目时应同时核对传输类型、TLS 及服务端指定参数。不要直接沿用另一种协议的配置,即使两份资料使用相同地址和端口。

PROTOCOL

Trojan

Trojan 通常结合 TLS 与密码认证建立代理连接,证书验证是检查链路身份的重要环节。除地址、端口和密码外,还应核对服务器名称与传输设置。出现证书错误时先确认名称、时间和配置来源,不应把跳过验证作为常规修复方法。

PROTOCOL

HTTP

HTTP 作为服务器类型时指 HTTP 代理,不是让用户在地址栏输入网页链接。服务器字段通常填写主机名或 IP,端口与认证信息分别设置。代理连接是否使用 TLS,与目标网站是否使用 HTTPS 是不同问题,应按已有配置分别核对。

PROTOCOL

SOCKS5

SOCKS5 通过代理服务器转发连接,并可根据服务器设置使用用户名与密码认证。协议名称本身不表示链路已加密,UDP 支持也需要两端及网络条件配合。填写资料时应确认认证要求,不能把空密码当作所有服务器都适用的默认值。

PROTOCOL

Hysteria2

Hysteria2 基于 QUIC,使用 UDP 承载连接,因此网络对 UDP 的可用性会影响握手与传输。检查时先核对地址、认证和 TLS 参数,再观察网络条件。仅有某个 TCP 测试成功,不能证明这一协议的连接路径也正常。

PROTOCOL

WireGuard

WireGuard 使用公私钥与对等端配置建立隧道,不采用普通用户名密码的填写方式。接口地址、私钥、对等端公钥及相关路由参数需要配套核对。私钥属于敏感凭据,提交诊断信息或分享配置时应移除,不能把整份配置公开展示。

03 / RULE KEYWORDS

规则关键字

规则把“匹配什么”与“匹配后怎么处理”写在同一行。以下语句只用于说明语法,不是一份可直接替代现有设置的完整配置。

RULE

Rule

Rule 是配置中决定流量去向的匹配规则,通常按从上到下的顺序判断。较具体的条件应放在较宽泛条件之前,兜底规则放在末尾。新增规则后,要结合实际请求记录确认命中结果,不能仅凭语句看起来正确就结束验证。

RULE

DOMAIN

DOMAIN 按完整域名匹配,适合只处理某个明确主机名。它不会自动把该域名的所有子域名都纳入同一条件。域名字段不应带网址协议、路径或查询参数,例如下面一行只针对指定域名。

DOMAIN,example.com,PROXY
RULE

DOMAIN-SUFFIX

DOMAIN-SUFFIX 按域名后缀匹配,可覆盖指定域名及其子域名。它比单个 DOMAIN 条件覆盖范围更大,适合需要统一处理一组相关域名的情况。修改前应确认子域名是否也需要相同策略,避免将例外请求一起匹配。

DOMAIN-SUFFIX,example.com,PROXY
RULE

DOMAIN-KEYWORD

DOMAIN-KEYWORD 按域名中包含的关键词匹配,不要求关键词位于固定后缀位置。它可能覆盖名称相近但并不相关的域名,使用范围应保持克制。若能明确写出完整域名或后缀,通常更便于检查匹配边界。

DOMAIN-KEYWORD,adservice,REJECT
RULE

IP-CIDR

IP-CIDR 按 IPv4 网段匹配,斜杠后的前缀长度决定地址范围大小。示例中的网段用于说明局域网地址的直连规则,不能照搬为所有网络的设置。IPv6 地址应使用对应的 IP-CIDR6 规则,修改前先确认目标地址类型。

IP-CIDR,192.168.0.0/16,DIRECT
RULE

GEOIP

GEOIP 根据 IP 地理数据库的归类结果匹配目标地址,不是根据网页语言或用户所在地判断。数据库归类与实际服务部署可能存在差异,因此不能将它当作网站身份的证明。出现分流偏差时,应对照实际解析地址与规则顺序检查。

RULE

FINAL

FINAL 处理前面规则尚未匹配的流量,是配置中的兜底规则。它通常位于规则末尾,策略选择会影响所有遗漏条件的请求。若大量流量落到 FINAL,应先检查前面的条件是否过窄或缺失,而不是立即更换服务器。

FINAL,PROXY
POLICY

PROXY / DIRECT / REJECT

这三个大写名称是规则命中后的处理策略:PROXY 使用代理路径,DIRECT 直连,REJECT 拒绝请求。它们并不负责定义匹配条件,也不同于 Global Routing 的界面姿态。判断一条规则时,应同时阅读关键字、匹配内容与末尾策略。

04 / SUBSCRIPTION & CONFIGURATION

订阅与配置

服务器条目保存连接参数,配置文件组织处理规则,购买记录确认应用获取资格。三者需要分别管理,不能相互替代。

INPUT

Add Server

Add Server 用于手动添加用户已有的服务器信息,第一步是选择与资料一致的协议类型。随后分别填写地址、端口、认证与传输参数,注意额外空格及字符大小写。保存后还要测试连接;保存成功只说明条目已写入,不表示远端验证通过。

INPUT

Subscribe

Subscribe 用于导入并更新用户已有的服务器条目,订阅链接从你的服务商处获取。更新条目不等于自动选中其中某一项,也不代表所有条目都可用。链接可能包含身份凭据,应避免公开展示;更新失败时先保留原有可用信息,再检查原始链接。

CONFIG

.conf

.conf 是组织配置内容的文件形式,可包含 General、Rule、Host 等分段。不同段落分别处理全局行为、规则与映射,并不等同于服务器订阅。导入前先阅读内容并保留原配置,导入后再确认启用状态;完整结构见系统教程。

CONFIG

URL Rewrite

URL Rewrite 按匹配条件改写或处理请求 URL,与决定连接走向的 Rule 作用层次不同。排查目标地址变化时,应同时检查是否存在相关改写条件。它不是修复所有访问失败的通用选项,不理解的规则应先核对用途,再决定是否启用。

SYNC

iCloud 同步

iCloud 同步是在适用设置与权限下,通过 iCloud 同步相关应用数据的机制,具体范围以应用内选项为准。同步不等于购买恢复,也不会改变服务器服务的有效性。迁移前先确认同步已完成,并另行保留重要配置,避免把单次同步当作完整备份。

APP STORE

已购项目

已购项目是 App Store 中查找已购买应用的入口,换机或重装时应先确认使用原购买账号。恢复应用不等于恢复全部本地配置,服务器信息仍需单独核对。系统要求及购买适用范围以 App Store 页面标注为准,操作见已购恢复说明。

05 / CONNECTION & DIAGNOSTICS

连接与诊断

将故障拆成解析、连接、认证、规则与实际访问几个阶段。某一步成功只是局部证据,不代表整条访问链路已完成验证。

DIAGNOSTICS

DNS

DNS 将域名解析为 IP 地址,是许多连接建立前的步骤。域名解析成功但访问失败,问题可能位于后续连接或认证阶段;解析失败也不能直接归因于服务器不可用。修改 DNS 设置时先记录原值,再结合请求记录检查,避免同时改动规则与服务器。

DIAGNOSTICS

Connectivity Test

Connectivity Test 用于检查条目在指定测试方式与目标下的连通性,结果只对应当次测试条件。测试成功不能保证所有目标服务均能访问,失败也需要结合协议与网络环境判断。完成测试后仍应访问实际目标,并核对 Global Routing 与命中策略。

DIAGNOSTICS

延迟

延迟是特定测试方式下测得的响应时间,不是下载带宽,也不直接表示长时间连接的稳定性。不同测试目标、接入网络和测量时刻会产生差异,不能混在一起简单排序。比较时保持测试条件一致,并结合实际请求是否成功来判断。

SYSTEM

VPN 配置授权

VPN 配置授权是系统允许应用创建相应网络配置的步骤,首次连接时可能需要用户确认并完成设备验证。授权后出现连接状态,不代表远端服务器一定可达。若无法开始连接,先检查系统授权;若已连接但访问异常,再排查服务器、解析与规则。

CONNECTION

服务器

服务器条目保存远端地址、协议及认证参数,用户也常将单个连接条目称为节点。条目名称只是便于识别的标签,不能证明实际地址、能力或状态。排查时按原始资料核对参数,并分别验证连通性、认证和目标访问,不要只依据名称或一次延迟结果。