主要页面
Home
查看连接状态、Global Routing、Connectivity Test 和 SERVER 列表的主要页面。Not Connected 表示当前尚未建立连接，不单独说明失败原因。首次连接需要按系统提示允许添加 VPN 配置，具体步骤见快速上手。
官方手册 · 对象索引
Shadowrocket 术语手册
界面名称、协议参数与规则关键字，按用途分开查阅。
英文名称对应应用界面或配置文件原文，中文解释说明其作用与边界。先确认正在调整的是整体模式、服务器条目还是规则，避免把不同层级的设置混在一起。
界面与开关
连接入口与路由姿态
先找到设置所在页面，再判断它影响的是连接状态还是流量处理方式。以下名称以应用实际显示为准。
整体路由设置
Global Routing
控制整体路由姿态，可选择配置、代理、直连，对应界面词 Config、Proxy、Direct。它不是单个网站的规则，也不是服务器协议类型。排查分流不符合预期时，应先核对这里，再查看当前配置文件及规则顺序。
三种路由姿态
Config / Proxy / Direct
Config 按当前配置中的规则处理请求；Proxy 将适用流量交给所选代理；Direct 采用直连姿态。系统绕过与其他网络设置仍可能影响实际路径，不能把模式理解为所有系统流量的绝对保证。详细区别见代理模式说明。
自动触发连接
On Demand
依据网络类型、Wi-Fi 或域名等条件控制 VPN 连接行为。它解决的是何时连接，不负责替代 Rule 决定每条请求如何分流。若手动关闭后又出现连接，应检查已启用的触发条件，以及当前网络是否满足这些条件。
服务器条目入口
Add Server
根据用户已有服务器信息手动添加连接条目的入口。应先选择正确协议，再逐项核对地址、端口、认证与传输参数；字段齐全不代表参数已经正确。已有订阅时可按导入流程操作，不必把订阅地址当作服务器地址填写。
诊断工具
Connectivity Test
按当前测试方式检查服务器条目的连通性，不同方式涉及的网络环节可能不同。显示响应结果只说明相应测试通过，不能保证 DNS、规则以及每个目标网站都正常。遇到“测试正常但网页打不开”，应继续检查解析结果与实际访问路径。
代理协议
连接格式与参数边界
协议名表示通信方式，不代表线路质量。填写参数时以用户已有服务器信息为准，不能只凭协议名称推断完整配置。
代理协议
Shadowsocks
使用约定的加密方法与凭据建立代理通信的协议。客户端的地址、端口、密码和加密方法必须与服务端一致；如配置还包含额外传输参数，也需完整保留。更换加密方法不是通用修复步骤，随意修改会使两端配置不匹配。
代理协议
VMess
需要认证信息，并可搭配不同传输设置使用的代理协议。除地址与端口外，还要核对 UUID、传输方式，以及启用安全传输时的相关字段。认证过程可能受设备时间影响，排查时可检查系统日期与时间，但不能仅凭超时就认定是时间问题。
代理协议
VLESS
将身份认证与传输安全分开处理的代理协议，名称本身不表示已经完成加密传输。使用时需要同时检查 UUID、传输方式和安全设置等字段。它与 VMess 的配置不能只替换协议名称后直接沿用，应按已有信息重新核对各项参数。
代理协议
Trojan
通常结合 TLS 与密码认证工作的代理协议。连接地址、认证密码以及用于 TLS 校验的主机名各有作用，填写时不能互相替代。出现证书或握手错误，应先核对主机名、证书有效性及系统时间，不应通过关闭校验掩盖配置错误。
代理协议
Hysteria2
基于 QUIC 的代理协议，底层依赖 UDP 通信。排查连接失败时，除了地址、端口和认证信息，还应确认当前网络允许相应 UDP 通信，并核对 TLS 参数。协议选择本身不能保证传输速度，实际表现仍受路径、拥塞与服务端资源影响。
隧道协议
WireGuard
以公钥识别通信对端的隧道协议，配置涉及本地私钥、对端公钥、地址与端点等信息。密钥不是普通显示名称，私钥也不应出现在排查截图或公开记录中。隧道连接和域名解析是不同环节，建立通信后仍需检查 DNS 与路由设置。
代理协议
HTTP / SOCKS5
两类不同的代理协议，不能因为共用地址与端口字段就认为可以互换。是否需要认证、是否支持特定流量以及传输是否受加密保护，应以实际协议和服务端配置为准。普通 HTTP 或 SOCKS5 代理的名称本身不构成传输加密保证。
规则关键字
匹配条件与执行策略
读取规则时，先看匹配什么，再看命中后如何处理。通常按从上到下的顺序判断，较具体的条件应放在宽泛条件之前。
规则段落
Rule
配置文件中的 [Rule] 段落用于定义分流条目，常见结构包含规则类型、匹配内容与策略。通常以首先命中的规则决定处理方式，因此前方的宽泛规则可能遮住后方的精确规则。修改后还需确认 Global Routing 为 Config，且正在使用相应文件。
精确域名匹配
DOMAIN
匹配指定的完整域名，适合只处理某个明确主机名的场景。例如 DOMAIN,example.com,DIRECT 不自动覆盖该域名下的所有子域名。匹配内容填写域名本身，不应把完整网页地址中的协议头、路径和查询参数一起放入。
域名后缀匹配
DOMAIN-SUFFIX
匹配指定域名及其子域名，例如 DOMAIN-SUFFIX,example.com,PROXY 可覆盖 example.com 与其下的子域名。它比 DOMAIN 的范围更宽，但不是任意文本子串匹配。若同一域名下存在例外，应把更精确的规则放在这一条之前。
域名关键词匹配
DOMAIN-KEYWORD
检查域名中是否包含指定关键词，覆盖范围可能跨越多个并不相关的域名。它匹配的是域名，不是网页正文，也不是任意 URL 路径。仅希望覆盖某个网站及其子域名时，通常应先考虑 DOMAIN-SUFFIX，减少意外匹配。
IP 归属匹配
GEOIP
根据目标 IP 在地理数据库中的归属进行匹配，不根据页面使用的语种或域名文字判断。数据库记录、域名解析结果与内容分发网络都可能影响匹配结果。它不等同于目标服务的注册地点，也不能保证同一网站的全部请求命中同一归属。
地址范围匹配
IP-CIDR / IP-CIDR6
分别使用 CIDR 表示法匹配 IPv4 与 IPv6 地址范围，例如 IP-CIDR,192.0.2.0/24,DIRECT。斜杠后的前缀长度决定网段范围，不是端口号。该示例地址用于文档说明；实际规则应依据需要匹配的目标地址编写，并注意两种地址族的差异。
兜底规则
FINAL
处理前面所有规则都未命中的请求，通常放在规则列表最后。FINAL,DIRECT 表示未命中其他规则时直连，而不是要求全部请求直连。若把 FINAL 提到前面，后续规则可能失去匹配机会，应先检查顺序再检查具体条件。
规则执行策略
PROXY / DIRECT / REJECT
PROXY 表示交由代理策略处理，DIRECT 表示直接连接目标，REJECT 表示拒绝请求。这些大写关键字是规则的处理结果，不是 Global Routing 三种姿态的简单替名。命中 PROXY 后，仍需要相应代理条目可用，才能完成后续连接。
订阅与配置文件
条目来源与文件结构
服务器条目解决连接到哪里，配置文件解决请求如何处理。订阅更新与配置切换属于不同操作，不能相互替代。
已有信息导入
Subscribe
通过用户已有订阅地址获取或更新服务器条目的方式，具体导入步骤见订阅与服务器导入。订阅内容可能在更新后变化，更新成功也不代表所有条目都可连接。地址可能包含访问凭据，排查时不要公开完整链接；订阅通常也不等于完整的分流配置文件。
服务器列表区块
SERVER
Home 中用于列出服务器条目的区块，每个条目保存相应协议、地址、端口及认证等连接参数。条目名称只是辨认标签，不能用来判断协议、实际位置或可用性。手动条目与订阅生成的条目管理方式可能不同，更新前应确认修改是否会被覆盖。
配置页面与文件
Config / .conf
Config 可指管理配置文件的页面，.conf 是常见的配置文件扩展名。文件可包含 General、Rule、Host、URL Rewrite 等段落，具体效果取决于字段及当前启用状态。保存文件不等于已切换生效，应核对当前选中的配置与 Global Routing。
通用配置段落
General
[General] 用于声明基础网络行为与通用参数，例如 DNS 设置。它与逐条匹配请求的 Rule 段落职责不同，参数是否适用还需结合当前配置与网络环境判断。修改前应保留原值，一次只调整与症状有关的项目，便于比较结果并恢复。
URL 处理段落
URL Rewrite
[URL Rewrite] 按表达式匹配 URL，并执行相应重写或重定向等操作，不是代理路由规则的替代品。匹配范围过宽可能改变不相关请求，编辑前应理解表达式与目标地址。HTTPS 请求的可见信息及可处理范围取决于连接条件，不能假定所有请求内容都可直接修改。
DNS 与网络
解析、响应与传输安全
域名解析、连接建立与实际内容传输是不同环节。测试结果应结合测试方式解读，不宜用一个数字判断全部网络状态。
域名解析机制
DNS
将域名解析为 IP 地址等记录的机制，通常是访问域名时的重要前置环节。代理服务器可连接，并不说明目标域名一定能够正确解析。若网页打不开但 Connectivity Test 有响应，应区分解析失败、解析结果不合适、规则路径错误与目标服务异常。
General 配置项
dns-server
用于在 General 中指定 DNS 解析服务器的配置项，dns-server = system 表示采用系统解析服务器设置。具体解析路径还会受到其他 DNS 配置及网络环境影响。修改前记录原值，修改后重新测试同一域名，不要同时更换多个无关参数。
静态主机映射
Host
[Host] 为指定主机名提供静态地址映射，例如 localhost = 127.0.0.1。静态映射不能自动跟随远端服务的地址变化，错误或过期记录可能导致持续访问失败。它与传输设置中的 Host 字段不是同一层级，不能只凭相同单词判断用途。
测试结果含义
Latency
指某种测试方式下的响应耗时，不等同于带宽、下载速度或持续传输稳定性。不同测试目标、网络类型与测试方法得到的结果不宜直接比较。排查时应保持测试条件一致，再结合实际网页访问和连接记录判断，单次超时也不能独立定位故障。
传输安全与主机名
TLS / SNI
TLS 用于保护传输并验证通信身份；SNI 在握手时指示预期访问的主机名，便于服务端选择相应配置与证书。连接地址可以与用于校验的名称不同，但必须符合已有服务器的实际设置。握手失败时先核对名称、证书与时间，不要把跳过校验当作常规解决方法。