官方手册 · 概念速查

Shadowrocket
界面、协议与规则术语

先辨认界面词所在的位置,再判断它控制的是连接模式、匹配条件,还是服务器参数。同一个词出现在不同位置,含义可能不同;例如 Config 页面与 Global Routing 中的 Config 选项。

适用设备:iPhone / iPad / Mac / Windows / 安卓 / Linux。各平台的界面布局可能不同,具体入口以当前应用为准;本页解释通用概念,不替代逐步操作。

按设置位置与用途查找

英文名称保留原样。大写规则关键字与首字母大写的界面选项分别解释,避免把路由模式与规则策略混为一项。

界面与开关

连接前先确认模式与对象

页面入口决定在哪里操作;连接模式决定流量怎样处理;测试工具只提供某一时刻的检查结果。

Home
Home 是查看服务器条目、订阅分组与选择连接对象的主要页面。列表里出现服务器,只说明信息已导入,并不表示连接已经建立。开始连接前,还需要确认选中的对象与 Global Routing 模式符合预期。
Global Routing
Global Routing 决定客户端以哪种模式处理流量,常见选项为配置 Config、代理 Proxy、直连 Direct。希望按规则分流时,应选择 Config 并确认当前配置。排查规则为何没有生效时,先检查这里,避免在其他模式下反复修改规则。
Config
Config 出现在 Global Routing 中时,表示依照当前配置中的规则决定连接方式;作为页面名称时,则用于管理配置文件。两者有关联,但不是同一个操作入口。仅下载一份配置文件还不够,还要确认它已被选用,并检查末尾规则及策略引用。
Proxy / Direct
Proxy 是 Global Routing 中的代理模式,Direct 是直连模式,两者可用于对照检查连接路径。这里的界面词不要与规则行中的大写 PROXY、DIRECT 混淆。完成临时排查后,若原本需要规则分流,应恢复 Config,再验证目标请求。
On Demand
On Demand 是按需连接设置,用于根据系统支持的网络条件触发连接。它不负责更新订阅,也不会修复错误的服务器参数。手动关闭后又出现连接时,可以检查此项与系统 VPN 设置;具体条件和入口以当前平台界面为准。
Add Server
Add Server 用于手动填写用户已有的服务器信息。协议类型、服务器地址、端口、认证以及传输参数需要成套匹配,不能只填一个地址便认为配置完成。修改前应保留原始参数,尤其注意区分服务器地址与 TLS 中的服务器名称。
Connectivity Test
Connectivity Test 用于检查条目的连通情况,结果受测试方式、测试目标和当前网络状态影响。测试成功不等于所有网站或应用都能访问,也不证明每条规则都已命中。应继续通过实际请求和诊断记录确认目标连接的处理方式。
延迟
延迟表示一次测试请求取得响应所需的时间,通常以毫秒表示。数值较低不等于文件下载更快,因为吞吐量还受带宽、拥塞与远端负载影响。比较结果时应尽量使用相同网络、相同测试方式与相近时间,超时则需进一步分辨原因。
代理协议

协议、传输与安全层分开核对

协议名称不是完整连接参数。以下只解释技术用途,实际填写应以用户已有服务器的配置为准。

Shadowsocks
Shadowsocks 是一种代理协议,连接通常需要服务器地址、端口、密码和加密方法。加密方法属于双方必须一致的参数,不能随意更换为看似更新的选项。导入后若无法连接,应先核对这些基础字段,再检查网络是否能到达远端端口。
VMess
VMess 使用 UUID 等参数识别用户,并需要匹配服务器端的相关配置。协议之外还可能涉及传输方式、路径、Host 与 TLS,具体取决于原始连接信息。UUID 正确但传输设置不一致时,仍可能无法连接,应逐项对照而不是只检查认证字段。
VLESS
VLESS 使用 UUID 等信息进行认证,协议本身不提供载荷加密,需要结合实际部署理解安全层与传输方式。它不是把 VMess 条目改一个类型就一定能使用的替代选项。添加时应完整核对服务器提供的参数,不根据名称猜测 TLS 或其他字段。
Trojan
Trojan 通常结合 TLS 与密码认证建立代理连接。服务器地址、端口、密码以及服务器名称等设置需与远端一致,证书验证失败也可能导致连接中断。排查时应先检查参数与设备时间,不应把关闭证书验证作为默认处理方式。
Hysteria2
Hysteria2 是基于 QUIC 的代理协议,对所在网络的 UDP 连通条件有要求。认证、TLS 与其他连接参数应按服务器配置填写,不能仅凭协议名称推断。若同一条目换网络后结果不同,应把 UDP 可达性与网络限制纳入排查,而非反复更换密码。
WireGuard
WireGuard 使用密钥对与隧道参数建立连接,常见信息包含对端地址、公钥和隧道地址。它的密钥不是普通密码,公钥与私钥的用途也不同。导入和备份时应保护私钥,并检查地址范围及相关路由设置,避免只核对对端地址。
HTTP / SOCKS5
HTTP 与 SOCKS5 是两类代理协议,连接协商与认证方式有所不同。协议名称本身不保证客户端到代理服务器之间的链路已经加密,应另外确认实际使用的安全设置。目标网站使用 HTTPS 与代理链路是否加密,是两个需要分别理解的问题。
TLS
TLS 是用于连接加密与身份验证的安全层,不是 Global Routing 模式。连接地址、服务器名称与证书上的身份信息可能分别填写,但必须符合服务端部署。遇到握手错误时,应检查设备时间、名称与证书相关参数,再判断是否为网络连通问题。
规则关键字

先匹配条件,再执行策略

规则通常从上到下检查。宽泛规则放得过早,会让后面的具体规则没有机会生效。

规则
一条规则通常包含匹配类型、匹配值与处理策略,用来判断某个请求应怎样连接。规则一般按顺序检查,首先命中的条目决定处理结果。排查时应同时查看规则内容、排列位置和当前路由模式,而不是只搜索目标域名是否出现在文件里。
DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD
DOMAIN 用于域名精确匹配,DOMAIN-SUFFIX 用于域名后缀匹配,DOMAIN-KEYWORD 用于域名关键词匹配。后缀规则可覆盖相应域名及其子域名,关键词匹配的范围则可能更宽。填写匹配值时只写所需域名或关键词,不把完整网页路径当作域名。
GEOIP
GEOIP 根据目标 IP 在地域数据库中的归属进行匹配,不是判断网页语言或用户当前位置。数据库与目标地址变化都可能影响结果,使用域名访问时还需要考虑解析得到的地址。若某个域名必须固定处理,应评估是否需要更靠前的精确域名规则。
IP-CIDR / IP-CIDR6
IP-CIDR 匹配 IPv4 地址段,IP-CIDR6 匹配 IPv6 地址段,斜杠后的前缀长度决定地址范围。前缀长度写错可能把范围扩大或缩小,不能当作普通端口号理解。排查双栈连接时,需要分别检查 IPv4 与 IPv6 的规则覆盖情况。
FINAL
FINAL 是前面的规则均未命中时使用的最终规则,通常置于规则列表末尾。它仍然需要指定处理策略,例如交给 PROXY 处理。配置能否按预期兜底,应结合前序规则判断;把 FINAL 放在过早的位置会影响后续匹配。
PROXY / DIRECT / REJECT
这些大写关键字表示规则命中后的处理策略:PROXY 交给代理处理,DIRECT 直接连接,REJECT 拒绝连接。它们不描述匹配条件,也不是协议名称。若配置使用自定义策略组,还需要检查组内实际选中的对象,不能仅凭规则末尾的名称判断最终路径。
DNS
DNS 负责把域名解析为 IP 地址,是建立许多连接之前的一步。解析失败与代理握手失败属于不同阶段;解析所走的路径也不应直接等同于之后业务连接的路径。遇到部分域名异常时,应结合解析结果、缓存和规则记录逐项检查。
URL Rewrite
URL Rewrite 根据匹配条件改写请求 URL,例如把符合条件的地址重定向到另一地址。它与选择代理或直连的路由规则作用不同,也不代表可以任意修改加密请求内容。仅需要规则分流时,不必额外加入来源不明的改写配置。
订阅与配置

分清服务器列表与本地设置

订阅解决信息更新,配置决定流量处理。同步、购买恢复与订阅更新分别处理不同的数据。

订阅 / Subscribe
订阅是取得并更新一组服务器信息的入口,地址应来自用户自己的服务商。它常包含用于识别账户的敏感参数,不应公开截图或粘贴到讨论区。添加成功后需要确认列表是否非空,并核对条目是否符合预期;订阅本身不等同于完整规则配置。
服务器 / SERVER
服务器条目是一组连接参数,通常包含地址、端口、协议、认证及可选的传输设置。列表中的显示名称只是便于辨认的标签,修改名称不会改变远端地址或连接能力。手动添加与订阅导入都可以形成条目,但后续维护和更新方式可能不同。
配置文件
配置文件可以保存规则、DNS、策略以及其他相关设置,和主要提供服务器列表的订阅用途不同。导入文件后应检查是否已选用,以及其中的策略名称能否对应实际对象。替换配置前建议保留当前可用副本,以便出现异常时恢复原来的设置。
订阅更新
订阅更新会重新读取同一个地址,将服务商提供的最新信息同步到本地。订阅条目的手动修改可能在后续更新时被替换,因此修改前应确认自己是在维护独立条目还是订阅内容。更新失败时先检查网络、地址完整性与服务端状态,不要连续重复导入制造多个分组。
Scan QR Code
Scan QR Code 用于读取二维码承载的连接信息,二维码可能表示单个服务器,也可能表示其他受支持内容。识别成功只表示内容能够读取,不等于参数正确或服务器可用。导入前后都应核对类型和字段,并把包含认证信息的二维码视为敏感资料。
iCloud 同步
iCloud 同步是 Apple 设备之间同步受支持数据的机制,通常需要使用相同 Apple 账号并开启相应权限。它不等于刷新订阅,也不会替代 App Store 的已购项目记录。换机前应分别确认购买账号、可同步内容和本地备份,不要假设所有连接状态都会自动恢复。
商店与账号

应用获取与连接服务分开理解

本组商店术语主要适用于 iPhone / iPad。其他平台的 Shadowrocket 获取入口统一在本站下载页。

App Store 店面与账号地区
App Store 店面受购买所用 Apple 账号地区影响,决定应用可见性、显示货币与可用购买方式。它与设备语言、当前所在地或代理出口不是同一个概念,切换网络也不等于更改店面。系统要求以 App Store 页面标注为准;搜不到应用时应先核对商店地区与产品信息。
正版核验
iPhone / iPad 在 App Store 核对开发者 Shadow Launch Technology Limited、官方图标与应用 ID 932747118。名称相近不代表是同一个产品,三项信息应结合核对。Mac、Windows、安卓与 Linux 则从本站下载页获取指向 /dl/shadowrocket/ 的安装包,并按该页说明处理系统放行。
一次性买断
iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费;各店面实际金额以商店页面为准。客户端一次性买断 ≠ 线路套餐,购买应用不会自动取得可用服务器或订阅。iPhone 与 iPad 的购买恢复应使用原购买账号,连接信息则需要另外导入或恢复。
已购项目
已购项目是 App Store 中与购买账号关联的应用记录,可用于换机或重新下载时查找已购买的 Shadowrocket。它保存的是获取应用的记录,不是服务器列表、订阅地址或规则配置。若找不到记录,应先核对是否使用原购买账号,再按商店界面检查购买历史和相关显示设置。

需要核对商店地区、购买记录或换机恢复步骤,可继续查阅 App Store 指南。已有条目无法连接时,先按 常见问题 区分导入、解析、握手与规则匹配阶段。

返回分类目录 ↑