官方手册 / 名称与含义

Shadowrocket 术语表

按分类查找界面词、协议名和规则关键字。每个条目保留英文原文,先解释含义,再说明使用时应核对的项目;条目链接可直接定位到对应说明。

本文面向 iPhone 与 iPad 上的 Shadowrocket。系统要求以 App Store 页面标注为准。需要连续操作步骤时,阅读入门指南;需要配置上下文时,阅读使用手册。

01 / 界面与开关

页面入口与检查工具

先确认所在页面,再查具体项目。连接开关、测试结果和流量读数分别回答不同的问题,不能相互替代。

界面与开关

Home 主页面

Home(主页面)用于查看服务器列表、选择默认服务器并操作连接开关。导入后先在列表中点选所需服务器左侧的圆点,再开始连接。开关处于开启状态只说明连接流程已启动,仍需结合测试与实际访问确认结果。

界面与开关

Add Server 添加服务器

Add Server(添加服务器)是填写单个服务器资料的入口,Type(类型)决定后续需要哪些字段。按用户已有的服务资料填写 Address(地址)、Port(端口)和认证参数,不要根据名称猜测协议。保存后返回 Home 选择该条目;保存成功本身不验证远端是否可达。

界面与开关

Settings 设置页面

Settings(设置页面)集中放置应用行为及相关选项,不同选项可能影响测试、连接或数据管理。修改前先记录原值,每次只调整一个与问题直接相关的项目。若同时修改多个开关,即使现象改变,也难以确认是哪一项起作用。

界面与开关

Data 流量统计

Data(流量统计)用于观察应用记录的上传、下载与累计数据,阅读时先确认当前视图、统计范围和清零时间。应用记录与运营商计费的统计口径可能不同,不能直接把两个数字等同。出现异常增长时,应结合连接记录检查对应请求,而不是只看累计总量。

界面与开关

Connectivity Test 连通性测试

Connectivity Test(连通性测试)用于检查测试目标在当前连接条件下是否可访问。先选默认服务器并建立连接,再执行测试,避免把未连接时的结果当作代理结果。测试成功只覆盖该目标和当时的网络条件;个别网站仍打不开时,继续检查规则、DNS 和目标服务本身。

界面与开关

DNS 域名解析

DNS(域名系统)负责把域名解析为可连接的地址,是访问网站前的一个环节。解析失败与代理服务器连接失败不是同一个问题,排查时应分别验证。修改 DNS 设置后,旧缓存或已有连接可能暂时保留原结果,应在明确测试条件后重试,不要反复叠加多个改动。

02 / 连接姿态与路由

先选姿态,再查流量去向

常用三姿态为 Config(配置)、Proxy(代理)、Direct(直连)。修改规则前先检查 Global Routing,避免在不使用规则的姿态下反复编辑配置。

连接姿态与路由

Global Routing 全局路由

Global Routing(全局路由)决定当前采用哪种路由姿态,常用取值是 Config、Proxy、Direct。它与服务器选择是两个独立维度:前者决定怎样处理连接,后者提供代理转发的远端。遇到“规则写了却没生效”,先看此处是否选择 Config,再查当前配置文件。

连接姿态与路由

Config 按配置分流

Config(配置姿态)出现在 Global Routing 中时,表示按当前启用配置的规则处理连接。配置管理页面也叫 Config,但打开该页面不等于已经切换路由姿态。需要指定网站走代理时,既要确认配置启用正确,也要确认 Global Routing 选中 Config。

连接姿态与路由

Proxy 代理姿态

Proxy(代理姿态)使由客户端处理的连接按代理方式转发,适合与 Config 的结果进行对照排查。它不表示当前服务器已经通过认证,也不保证所有目标均能访问。若 Proxy 可用而 Config 下某个域名失败,应进一步检查该域名命中的规则及对应策略。

连接姿态与路由

Direct 直连姿态

Direct(直连姿态)不通过代理服务器转发相关连接,可用于观察本地网络直接访问的结果。它是 Global Routing 的界面取值,与规则中的大写 DIRECT 应分别理解。切换到 Direct 后,即使服务器列表仍保留选中项,也不能据此认定访问正在经过该服务器。

连接姿态与路由

On Demand 按需连接

On Demand(按需连接)根据已设置的条件触发系统 VPN 连接行为,不等于每条请求都会重新选择服务器。开启前先确认手动连接已经可用,再逐项检查触发条件。它不会修复过期的订阅、错误的认证资料或不可达的远端;异常自动连接时,应同时核对系统 VPN 状态。

连接姿态与路由

Latency 延迟

Latency(延迟)通常以毫秒表示某种测试方法下的响应往返时间,阅读数字前应先确认测试方式。较小的结果不等于更大的带宽,也不代表持续传输稳定。比较用户已有服务器时,尽量在相同网络和相近时间测试,再结合真实页面访问判断,而不是只依据列表中的一个数字。

03 / 协议

协议类型与参数对应

协议名说明连接采用的技术方式,不代表服务可用性。添加时以用户已有服务器资料为准,认证字段、传输设置与 TLS 设置不能随意互换。

协议

Shadowsocks

Shadowsocks 是加密代理协议,常见必填资料包括服务器地址、端口、加密方法与密码。加密方法必须与服务端一致,不能因为某种名称较新就自行替换。导入后若无法连接,先按原始资料核对字段和额外传输要求,再判断远端或当前网络是否异常。

协议

VMess

VMess 是使用用户标识等参数进行认证的代理协议,具体连接还取决于配套的传输方式。用户标识、传输路径、主机名和 TLS 设置属于不同字段,不能只填地址与端口。认证或握手异常时,也应检查设备时间是否准确,再逐项比对服务资料。

协议

VLESS

VLESS 是一种代理协议,协议名称本身并不包含完整的传输与安全配置。使用时应按已有资料填写用户标识、传输方式及对应的安全参数。不要把其他协议条目的字段直接复制过来;即使地址和端口相同,认证与握手要求也可能不同。

协议

Trojan

Trojan 是通常配合 TLS 使用的代理协议,密码认证与 TLS 握手都需要正确。连接地址与 TLS 验证使用的服务器名称可能不同,应按服务资料分别填写。遇到证书错误时先检查名称、设备时间和服务端证书,不要把关闭验证当作默认处理方法。

协议

Hysteria2

Hysteria2 是基于 QUIC 的代理协议,底层使用 UDP,实际表现受链路丢包、网络限制及服务端设置影响。若当前网络无法正常承载 UDP,可能在连接阶段就失败,不能仅通过改写域名规则解决。认证、TLS 及相关参数应与服务资料一致,协议名称不构成速度保证。

协议

WireGuard

WireGuard 是基于密钥认证的 VPN 协议,配置涉及私钥、对端公钥、接口地址、端点和路由范围。公钥与私钥用途不同,不能互换,也不应在截图或求助内容中公开私钥。排查时成套核对地址与路由配置,不能只看端点是否能响应。

协议

HTTP / SOCKS5

HTTP 与 SOCKS5 是两种代理协议类型,服务器端需要支持所选类型及相应认证方式。代理类型名称并不自动说明客户端到代理端之间是否有加密保护,应另查传输设置。需要处理 UDP 时,还要确认协议能力和服务端支持情况,不能只凭 TCP 连接成功推断。

04 / 规则关键字

匹配条件与规则动作

规则通常自上而下匹配,先命中的规则决定处理方式。以下域名与地址只作教学文本,不代表可用服务器,也不应原样替换已有配置。

规则关键字

DOMAIN 完整域名匹配

DOMAIN 按完整域名匹配,例如 DOMAIN,example.com,PROXY 指定该域名走代理。它不自动覆盖 www.example.com 等其他子域。只针对单个主机设置例外时可以使用;若希望覆盖整个域名及子域,应进一步了解 DOMAIN-SUFFIX。

规则关键字

DOMAIN-SUFFIX 域名后缀匹配

DOMAIN-SUFFIX 按域名后缀匹配,通常覆盖指定域名本身及其子域。示例 DOMAIN-SUFFIX,example.com,PROXY 可处理该域名范围的请求,但不会因此覆盖网页引用的所有其他域名。页面仍有部分资源失败时,应检查这些资源实际使用的主机名。

规则关键字

DOMAIN-KEYWORD 域名关键词匹配

DOMAIN-KEYWORD 检查域名是否包含指定关键词,例如 DOMAIN-KEYWORD,example,PROXY。它的范围通常比完整域名或后缀匹配更宽,可能命中原本不打算处理的域名。若目标已经明确,优先使用范围更清楚的条件,并把较具体的例外放在宽泛规则之前。

规则关键字

GEOIP 地址地域匹配

GEOIP 根据 IP 地理数据库中的分类匹配地址,不是根据网页内容、注册地或域名后缀作判断。一个网站可能使用分布在不同地区的地址,数据库归类也可能与直觉不同。域名规则与 GEOIP 规则结果不一致时,先看匹配顺序,再核对实际解析地址和数据库信息。

规则关键字

IP-CIDR / IP-CIDR6 地址段匹配

IP-CIDR 用于 IPv4 地址段,IP-CIDR6 用于 IPv6 地址段,斜杠后的前缀长度决定覆盖范围。例如 IP-CIDR,192.168.0.0/16,DIRECT 表示该 IPv4 范围直连。双栈网络中,只有 IPv4 规则不等于也覆盖 IPv6;修改前应确认请求实际使用的地址类型。

规则关键字

FINAL 兜底规则

FINAL 处理前面所有规则都没有匹配的连接,应放在规则列表末尾。FINAL,DIRECT 表示其余直连,FINAL,PROXY 表示其余走代理,两者会形成不同的默认行为。兜底规则无法覆盖前面已经命中的条目,排查时不要只改最后一行。

规则关键字

PROXY / DIRECT / REJECT 规则动作

PROXY 表示代理转发,DIRECT 表示直接连接,REJECT 表示拒绝连接,它们是规则结果而不是匹配条件。被 REJECT 命中的请求不会因为重新选择服务器就自动恢复。规则也可能引用命名策略组,阅读时应继续查找组定义,确认最终出口,而不是只看一个策略名称。

05 / 订阅与配置

区分服务器资料与配置文件

以下操作以用户已有自己的订阅或服务器信息为前提。本站是 Shadowrocket 官网与官方手册,不提供、不销售、不推荐节点、订阅或连接服务。

订阅与配置

Subscribe 订阅导入

Subscribe(订阅导入)用于从用户已有的订阅地址读取服务器列表,订阅地址由用户自己的服务商提供。地址中可能含有专属访问凭据,求助时不要公开完整链接。更新订阅会重新读取远端内容,因此更新失败、列表为空和某个服务器连不上,应作为不同问题分别检查。

订阅与配置

Server 服务器条目

Server(服务器)条目保存地址、端口、协议及认证信息,日常所说的节点通常指这类连接条目。名称和地区标签只是辨认信息,不能证明远端可用或反映实际性能。导入成功只表示资料已被读取;连接前仍需选为默认服务器,并检查资料有效性与当前网络条件。

订阅与配置

Config 配置文件

Config(配置文件)用于组织规则、DNS 及相关设置,与只列出服务器资料的订阅不是同一个概念。导入文件后,应确认当前启用的是哪一份,并在 Global Routing 中选择 Config 才按配置分流。替换或更新前先保留个人修改,避免把本地例外规则当作远端内容自动保留。

订阅与配置

iCloud 同步

iCloud 同步通过 Apple 云端账户传递应用支持同步的数据,实际范围以应用内选项为准。它与 App Store 的购买记录是两件事,恢复应用购买不代表服务器资料一定已恢复。换机前确认同步状态并妥善备份重要配置;同步冲突时先保留两端内容,再决定采用哪一份。

术语已经明确但仍无法连接时,前往FAQ按现象查找;不要同时更换服务器、DNS 与整份规则,以免丢失可对照的测试条件。