官方手册 · 技术参考

Shadowrocket 协议详解

protocol-reference

按已有服务器选择协议类型,再核对传输、认证与加密参数。协议名称不是速度排名。

本页用于系统查阅,重点解释协议为什么这样设计,以及配置不一致时会发生什么。首次添加已有订阅、开启连接与检查结果,请先阅读使用说明;完成上手后,可回到本页核对字段和处理边界情况。

Shadowsocks VMess / VLESS Trojan HTTP / SOCKS5 WireGuard Hysteria2

以下均以用户已有自己的订阅或服务器信息为前提。Shadowrocket 提供全平台客户端;本文的操作观察主要围绕 iPhone / iPad,具体选项以设备上的实际界面与服务端配置为准。

先区分协议、传输与分流

layers

一次连接涉及多个独立决定

在 Shadowrocket 中,选择服务器的协议类型,只是在确定客户端与服务端使用哪一种通信约定。应用发出的原始连接、客户端封装后的连接、服务端向目标站点发出的连接,是相互关联但并不相同的几段路径。打开网页时发生的域名解析、建立连接、认证和数据传输,也不能被一个协议名称全部概括。理解这些层次,才能判断应该修改哪一个设置,而不是连接失败后不断更换类型。

可以先把配置拆为四层:协议规定认证与数据封装;传输决定封装后的数据如何在两端之间承载;TLS 负责相应连接的加密与身份验证;规则决定某条目标连接是否使用这个服务器。并非每种协议都同时暴露这四层选项。例如 WireGuard 自带专门的加密与握手机制,不应照搬基于 TLS 的服务器字段;VLESS 则需要特别关注外层采用的安全机制。某个面板没有同名字段,不等于遗漏了必要的安全功能。

速度、电量与协议没有固定对应表

协议的诞生背景往往对应不同需求:精简的应用代理、灵活的认证与传输组合、通用代理协商、网络层隧道,或面向高时延与丢包链路的数据承载。这些目标并不互相替代。低开销协议在拥堵线路上仍可能很慢;结构较复杂的协议,在服务器位置更近、网络更稳定时反而可能响应更快。因此,比较时必须固定服务器位置、本地网络、目标资源与观察时段,否则测到的大多是线路差异。

在 iOS 上,电量影响不仅来自加解密计算,还包括无线模块保持活跃、握手重试、后台保活、域名查询和连接频繁重建。短时间大量失败连接,可能比一条持续传输的连接更耗电。系统显示的 VPN 状态仅说明隧道接口正在工作,不能证明某个远端服务器认证成功,也不能证明所有流量正在经过代理。应结合目标请求、连接记录和实际命中的规则来观察,避免把图标当成完整的连通性报告。

层次需要回答的问题常见核对项
协议两端如何认证、封装数据Type、密码、UUID、密钥
传输协议数据通过什么承载TCP、UDP、WebSocket、路径
安全如何加密及验证对端身份TLS、Server Name、证书
分流哪些目标使用该服务器Global Routing、规则顺序

先确认服务端能力,再讨论选择

在 Add Server(添加服务器)里切换 Type(类型),不会让已有服务端自动改用另一种协议。协议类型、端口和凭据必须组成服务端实际支持的一套配置。即使地址相同,不同端口也可能连接到完全不同的服务。订阅导入后若出现陌生类型,应先查阅已有服务的参数说明,不要根据名称相似程度猜选项。手工修改前保存原始配置,并记录改动原因,方便恢复到可以验证的起点。

本文的选型指的是:在用户已经具备的可用配置之间,依据用途选择,并识别哪些字段不能混用。客户端一次性买断 ≠ 线路套餐。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费;客户端费用不包含远端服务器服务。获取入口见全平台下载页,本页不提供或推荐订阅与节点。

Shadowsocks:精简封装与参数一致性

shadowsocks

设计重点是代理数据的加密传递

Shadowsocks 的基础思路是把应用代理请求加密后交给远端服务器处理,核心配置通常围绕地址、端口、加密方法与密码展开。与需要较多外层协商选项的组合相比,它的基础结构比较精简,适合理解代理协议最基本的两端关系。但精简不代表所有标有 Shadowsocks 的配置可以互换:具体加密方法、协议代际、附加扩展和服务端实现,都会影响客户端是否能够正确解析与通信。

现代配置通常采用 AEAD(带关联数据的认证加密)方法,同时保护机密性并检测数据被篡改的情况。加密方法不是可随意调节的“速度档位”,必须与服务端完全一致。若服务端使用某种方法,客户端改成另一种,即使密码相同也不能正常通信。不同设备对不同算法的计算效率可能不同,但应在服务端明确支持多个配置时分别测试,而不是在一个配置里任意更换算法。

密码、端口与扩展分别核对

手工添加时,先确认 Type 为 Shadowsocks,再逐项核对服务器地址、端口、加密方法与密码。密码中的大小写、符号、前后空格都会参与认证相关计算,复制时尤其要留意换行和全角符号。某些较新的配置使用有特定编码与长度要求的密钥材料,不能换成自己容易记忆的短句,也不能因为外观像普通密码就删去末尾字符。应保留服务商原样给出的完整内容。

端口只是服务器上服务的入口编号,并不天然代表使用哪一种协议或是否启用 TLS。配置使用常见网页端口,也不意味着应该额外开启 TLS。若已有配置包含扩展或额外传输参数,还要确认客户端能识别这些参数及其语义。导入后只看到地址和密码,不能据此认定全部信息都已保留;应与原始说明对照,尤其检查那些在折叠设置中才出现的选项。

TCP 正常不代表 UDP 也正常

Shadowsocks 可以用于承载不同类型的流量,但 UDP 是否实际可用,取决于服务端是否启用、网络是否允许以及客户端对应选项。网页可以打开而某个实时应用异常,可能是两者对传输的需求不同。反过来,打开 UDP 相关选项也不能让只提供 TCP 服务的端口获得 UDP 能力。需要先确认已有配置的支持范围,再通过具体应用或受控请求验证,而不是只看列表中的一次测试结果。

在 iPhone 上,基础 Shadowsocks 连接的封装开销通常较直接,但实际耗电仍可能被重连与弱信号放大。如果从 Wi-Fi 切换到蜂窝网络后应用暂停响应,应先观察连接是否重新建立、远端地址是否可达,再判断协议参数。不要仅凭“刚切换协议后恢复”就得出另一协议更省电的结论,因为切换动作本身也会清除旧连接状态,触发一次新的域名解析与握手。

把可恢复的基线保留下来

订阅中的 Shadowsocks 条目若能正常连接,可将其作为后续排查的基线,但不要在订阅管理项里随意改写核心字段。订阅更新可能覆盖手工修改,造成今天可用、下次更新又恢复原值的现象。需要比较参数时,可以在明确理解凭据用途的前提下建立独立测试条目,并给它写明用途。分享排查信息时隐藏密码、密钥及完整订阅地址,只保留协议类型、字段名称和错误发生阶段。

选择 Shadowsocks 的合理前提,是手头已有参数完整且服务端支持的配置,并且所需的 TCP、UDP 能力都已确认。它不是因为选项少就必然更适合所有场景,也不是因为没有一整组 TLS 字段就应该手工补上。先验证基础连接,再检查规则、目标应用与网络切换行为,可以避免把分流错误误判为协议本身的问题。

VMess 与 VLESS:认证和外层安全

vmess-vless

名称相近,安全职责不同

VMess 把用户认证和数据保护等功能纳入自己的协议设计,常见配置通过 UUID 标识用户,并搭配具体传输方式工作。VLESS 则采用更精简的协议层设计,本身不提供与 VMess 相同的负载加密机制,通常依靠外层安全机制保护传输。两者不是把同一个开关换个名字,也不能因为服务器地址与 UUID 看起来一样,就直接在 Type 里互相替换。

VLESS 的精简主要是在协议职责上做减法,不代表整条链路必然更轻,也不代表默认获得加密保护。如果外层使用 TLS,仍需执行相应握手与证书验证;如果服务端采用其他支持的安全组合,则应按该组合完整填写。不能看到某个加密字段显示为 none 就认定连接一定以明文传输,也不能反过来认为选择 VLESS 就自然安全,必须把协议层与外层一起检查。

UUID 不是服务器地址,也不是证书名称

UUID 是用户身份相关字段,应完整保留连字符和所有字符。它通常与服务端用户配置对应,不应填进密码、路径或 Host 字段。服务器地址解决的是连接去哪里,UUID 解决的是以哪个用户身份通信;TLS 的 Server Name 则参与对端身份验证及服务选择。三个字段即使都由一份订阅提供,也分别承担不同任务,互相替换不会起到“兼容”作用。

VMess 的认证机制对时间有要求。如果设备时间明显不正确,地址和 UUID 都正确也可能失败。检查时应先让系统使用准确的日期与时区,而不是盲目修改服务端字段。历史配置中还可能出现额外的认证参数,其适用性取决于两端实际支持情况。不要套用旧教程中的固定数值;已有订阅能完整表达的参数,优先按原始配置导入并保留。

检查对象VMessVLESS
身份信息核对 UUID 与认证相关设置核对 UUID 及服务端要求的附加项
协议层加密具有自身的数据保护机制不承担同样的负载加密职责
外层参数按实际传输与安全配置填写必须确认外层安全组合
迁移条件服务端实际提供对应入口,不能仅修改客户端 Type

WebSocket 路径与 TLS 名称分开看

若配置使用 WebSocket,路径通常要包含正确的前导斜杠,并与服务端路由要求相符。路径不是任意备注,随意改动可能把请求送到另一个处理入口。Host 是应用层请求中的主机信息;Server Name 是 TLS 握手中的名称相关设置。两者有时相同,有时由服务端部署方式决定而不同。应分别核对,不能用“都像域名”作为合并填写的依据。

连接地址可以是域名,也可能是 IP 地址。使用 IP 连接并不意味着证书应当按该 IP 验证;如果证书对应一个域名,通常仍需提供与部署相符的 Server Name。出现证书名称错误时,正确处理是核对名称、证书有效期与系统时间,而不是长期关闭验证。关闭验证会改变信任边界,却不能修复错误的 UUID、WebSocket 路径或服务端路由。

性能比较必须保留完整组合

在 iOS 上比较 VMess 与 VLESS,应写下完整组合,例如协议、传输、安全方式和服务器位置,而不是只记录两个名称。一次打开网页的时间可能主要消耗在 DNS 与 TLS 握手,持续下载则更受带宽和拥塞影响。频繁短连接、长连接和网络切换是不同负载,结论不必一致。只有已有服务提供可对照的入口时,才适合做控制变量测试。

需要进一步理解字段差异,可阅读VMess 与 VLESS 的加密、开销与参数说明。实际选用时,完整可验证的配置比理论上更精简的名称更重要。若导入条目出现无法识别的附加参数,应先确认当前客户端与服务端的支持范围,不要删掉陌生字段后把剩余内容当作等价配置。

Trojan、HTTP 与 SOCKS5:不同的代理边界

proxy-boundary

Trojan 把 TLS 作为关键组成部分

Trojan 的常见设计将代理协议置于 TLS 连接之内,并使用密码进行身份认证。理解它时,应同时关注外层 TLS 是否正常,以及内层认证信息是否匹配。服务端地址可达,只能说明能够尝试建立连接;证书验证成功,也不代表密码一定正确。这种分层关系让错误可能表现为握手失败、认证后中断或特定目标不可达,排查时需要区分发生在哪一个阶段。

手工配置 Trojan 时,地址、端口、密码和 Server Name 都可能是必要信息。服务端证书应处于有效期内,名称应与预期身份匹配,设备系统时间也应正确。密码中的特殊符号应原样保留,不能用 UUID 代替。若服务商还提供了传输扩展参数,要确认当前入口确实要求这些内容,不能把另一套服务器的 WebSocket 路径复制过来,仅因为两者都使用 TLS。

HTTP 代理的能力由入口实现决定

HTTP 代理通过 HTTP 语义处理请求,常见的 CONNECT 方法用于建立面向目标地址的隧道。这里要区分“通过代理访问 HTTPS 网站”和“客户端到代理入口自身使用 TLS”两件事:前者描述目标连接,后者描述代理这一跳。一个普通 HTTP 代理可以转发 HTTPS 的 CONNECT 请求,但不等于到代理入口的认证信息与协商内容自动受到 TLS 保护。

因此,在已有服务要求使用受 TLS 保护的代理入口时,要按客户端对应类型及安全选项填写,不能因为目标网站是 HTTPS 就省略入口安全设置。用户名与密码也属于代理认证字段,而不是目标网站的登录信息。常规 HTTP CONNECT 主要面向 TCP 隧道,不应默认它能够承载所有 UDP 应用。某个网页正常,只证明那次请求所需的能力已满足。

SOCKS5 是协商协议,不自带传输加密

SOCKS5 定义了客户端向代理服务器请求连接的协商过程,可以涉及用户名密码认证,也定义了 UDP 关联机制。但协议本身并不负责把整条代理链路加密。是否有额外保护,取决于它运行的网络环境或外层通道。把 SOCKS5 用户名密码配置完成,只能说明认证方式有了对应参数,不能据此推导出认证与负载在网络上传输时一定受到加密保护。

UDP 关联能否工作,还受服务端实现、防火墙和地址可达性影响。即便 SOCKS5 规范包含这项能力,实际入口也可能没有启用。域名在哪里解析同样需要检查:客户端可能先把域名转成 IP 再请求代理,也可能把域名交给远端处理,具体受配置和请求路径影响。解析结果不同会改变目标地址,最终影响访问行为,不能简单归因为 SOCKS5 比其他协议慢。

类型重点字段不能默认成立的结论
Trojan密码、TLS、Server Name证书通过就等于认证成功
HTTP入口地址、认证、入口安全方式访问 HTTPS 就等于代理这一跳加密
SOCKS5认证、UDP 支持、解析路径存在密码就自带传输加密

在可控环境里选择通用代理

HTTP 与 SOCKS5 常见于组织内部代理、测试环境或用户自己维护的服务。若已有环境明确规定入口类型,Shadowrocket 的任务是正确表达该入口,而不是把它改成名称更复杂的协议。在不受信任的网络上传递敏感认证信息前,应确认代理这一跳具有什么保护。应用与目标网站之间的端到端 TLS 仍然重要,它与代理入口安全共同构成不同层面的保护。

对 iPhone 的速度和电量而言,Trojan 的 TLS 握手、连接复用情况,以及通用代理的响应质量都可能产生影响,但不能据此给三者作固定排名。若需求涉及实时音视频或其他 UDP 应用,应先确认完整通路的支持情况。若只是组织指定的 TCP 代理访问,则优先保持配置简洁、身份验证清楚、证书验证完整,避免为不存在的能力反复调整参数。

WireGuard:密钥、地址与隧道范围

wireguard

从网络层隧道理解配置

WireGuard 的出发点是建立加密的 IP 隧道,而不是只为某一个应用连接定义代理请求。因此,它的配置会出现接口地址、对端公钥、Endpoint 和路由范围等网络层概念。它与 Shadowsocks、Trojan 的字段布局不同是正常现象,不应把私钥填成普通密码,也不能把接口地址当作服务器地址。先分清本地接口、远端对端和隧道内目的地址,才有可能正确理解流量如何走。

WireGuard 使用固定的现代密码学组合,减少了需要双方协商的算法选项。用户通常不需要在客户端挑选一长串加密算法,但仍必须正确管理密钥。Private Key 是本端私钥,应只用于对应设备或配置;Peer 的 Public Key 用于识别对端,不是自己的公钥。若配置包含 Preshared Key,则需要两端一致。它是额外的共享材料,不是用来替代公私钥关系的通用密码。

Endpoint 与接口地址不能互换

Endpoint 描述如何在当前网络上找到远端,通常包含主机名或 IP 地址与端口。接口地址则是隧道内部本端使用的地址,往往带有前缀长度。把内部地址填到 Endpoint,可能导致客户端尝试连接一个在隧道建立前根本不可达的目标。若配置同时包含 IPv4 与 IPv6,还要确认当前网络和服务端都具备对应能力,不能仅凭其中一种地址存在就推断另一种也可用。

Allowed IPs 在 WireGuard 语境里与路由选择及对端允许的地址范围有关,不是网站白名单的简单同义词。当 WireGuard 作为 Shadowrocket 中的一个出站类型使用时,还必须区分它的隧道地址范围和客户端外部的规则系统:外层规则先决定某条连接是否选择这个出站,出站内部再受自身能力与配置约束。不要未经确认就把完整隧道配置里的路由结论照搬到整个客户端。

保活与 MTU 解决不同问题

移动网络经常通过 NAT 维护地址映射。Persistent Keepalive 用于在需要时通过周期性数据维持映射,但它不是越频繁越好。没有必要的保活会增加无线活动,影响待机电量;过于稀疏则可能无法满足特定网络的映射保持需求。应依据服务端与网络实际要求设置,而不是照抄某个固定秒数。若仅在长时间闲置后首次请求失败,才值得重点检查映射、保活与重新握手过程。

MTU 决定隧道内可承载的数据包大小边界。隧道会增加封装开销,路径上的限制处理不当时,可能出现小请求正常、大资源卡住的现象。此时降低 MTU 可能有帮助,但不能把所有慢速问题都归结为 MTU。应先确认故障是否与报文大小或特定目标相关,再做单变量调整。把 MTU 任意调得很小会增加包数量与开销,不一定提升实际吞吐或降低耗电。

移动切网时观察握手与路由

WireGuard 对对端地址变化有相应机制,但在 iOS 上的实际恢复仍依赖当前网络能否发送 UDP、客户端隧道状态以及服务端响应。Wi-Fi 正常、蜂窝网络失败时,先比较 UDP 可达性与地址族,不应直接重新生成密钥。密钥错误通常不会只在一种本地网络下出现。若连接建立但内部资源不可达,则应继续核对隧道地址、允许范围、服务端转发和返回路径。

它适合用户已经掌握完整 WireGuard 配置、需要访问自己维护的网络或已有隧道服务的场景。配置文件能被导入不等于所有网络层条件都已满足,尤其是服务端转发与内部 DNS。电量表现也应按真实用途评估:持续传输与长时间待机是不同测试。记录网络类型、保活设置和重连现象,比仅比较客户端运行时长更有意义。

Hysteria2:QUIC、拥塞与带宽预期

hysteria2

围绕 UDP 上的数据传输设计

Hysteria2 基于 QUIC 相关机制构建代理传输,设计中重点考虑高时延、丢包等链路条件下的数据承载。QUIC 运行于 UDP 之上,但这并不意味着应用数据没有可靠性保障,也不意味着所有流量都按普通实时数据报处理。可靠传输、流控制和加密可以在这套机制中完成。用户需要区分底层使用 UDP,与目标应用原本使用 TCP 还是 UDP 这两个不同问题。

这类设计可能改善某些链路下的体验,但收益取决于服务端能力、路径条件与网络政策。如果当前网络对 UDP 不通,协议再适合高丢包环境也无法凭空建立连接。即使 UDP 可达,路径限速、设备资源与服务端带宽仍然构成上限。因此,不应把 Hysteria2 理解为一个勾选后就能提升速度的开关,也不应把一次较快的下载当作对所有网络有效的结论。

认证与 TLS 字段仍要完整

手工填写时,应核对协议类型、服务器地址、端口、认证信息以及 Server Name。Hysteria2 与名称相近的其他协议配置不能视为相同格式,导入时要确认客户端识别出的类型正确。证书校验仍承担确认对端身份的职责;连接超时与证书错误属于不同排查方向。前者优先检查网络可达性和端口,后者应核对名称、证书链、有效期与设备时间。

若已有配置包含混淆相关参数,必须与服务端设置一致,包括是否启用及对应的认证材料。混淆不是加密强度滑块,也不是每个入口都需要。随意增加会让两端无法理解对方的数据。已有订阅能够导入时,应优先保持完整参数;手工重建时则先整理字段清单,对每一个非默认选项确认来源,不要把网络文章中的示例值当成当前服务器的要求。

带宽字段不是测速结果

某些配置会涉及上行、下行带宽预期,它们可能参与拥塞控制方式或发送行为的选择,具体取决于两端配置。填写更大的数字不会增加运营商带宽,反而可能导致排队、丢包或对同网络其他业务的影响。上行与下行也不能互换:家庭网络常见的上下行能力并不对称,应按当前链路的可持续能力理解,而不是照抄服务器标称端口速率。

若客户端界面或已有配置使用带宽数值,应首先确认单位,区分每秒比特与每秒字节。还要确认服务端是否接受客户端的带宽提示,以及当前组合实际采用的拥塞控制行为。网络类型变化时,原先适合 Wi-Fi 的预期未必适合蜂窝网络。没有测量依据时,优先保留服务商给出的配置或受支持的默认行为,不为了追求列表中的数字而频繁上调。

iOS 上同时看吞吐与无线活动

在 iPhone 上,高吞吐意味着更多数据处理和无线传输,不能因为完成下载更快就直接断言更耗电或更省电。应考虑完成同一任务的总耗时、总传输量、是否频繁重试以及设备信号状况。连续测速本身就会制造显著负载,不适合拿来推断待机表现。测试时保持屏幕亮度、网络与资源一致,并避免其他应用同时大量传输。

对视频通话、游戏与文件下载,评价指标也不同:持续下载关注吞吐,实时互动更关注时延波动和丢包后的恢复。一个擅长占满链路的设置,可能让同网络中的互动请求排队。若下载时网页与通话明显变差,应检查发送预期是否过激、上行是否已被占满,而不是只看下载速度。有关分层检查,可继续阅读速度慢时的本地网络、协议与线路排查。

把协议参数与规则分流接起来

fields-and-rules

地址、名称、路径与凭据各司其职

跨协议最常见的问题,不是忘记某个高级开关,而是把不同层的字段填到了同一个位置。服务器地址用于找到远端入口,端口用于选中服务;Server Name 参与 TLS 的名称协商和身份验证;Host 可能属于特定应用层传输;Path 则指向某个传输处理路径。它们可以碰巧使用相同文本,但语义并不相同。出现错误时,应先用字段含义解释配置,而不是按外观复制。

凭据也有不同类别:密码、UUID、Private Key 与 Public Key 不能混用。订阅链接本身可能含有访问凭据,应像密码一样保管,不能贴进公开截图或排查记录。导入时出现部分字段空白,可能是源格式、编码或客户端支持范围的问题,不能立即用另一条服务器的值补齐。应与自己已有的原始信息对照,确认是否导入了完整条目,必要时重新获取同一配置的正确表达形式。

Global Routing 决定协议是否被使用

Global Routing(全局路由)中的 Config(配置)、Proxy(代理)、Direct(直连)是客户端处理流量的姿态,不是三种服务器协议。Config 按配置文件规则决定处理方式,Proxy 以代理姿态处理连接,Direct 以直连姿态处理连接。因此,一条协议配置测试正常,但目标应用在 Direct 下仍不会按预想使用代理。相反,切到 Proxy 后恢复,也可能只是绕过了错误规则,而非修好了协议。

界面选项处理思路排查意义
Config按当前配置规则选择策略观察目标命中哪条规则
Proxy使用代理姿态处理连接对照规则是否导致差异
Direct使用直连姿态处理连接对照本地网络基础可达性

规则从上到下匹配,首条命中即止

下面是用于解释顺序的 Shadowrocket .conf 规则片段,不含服务器信息,也不能单独构成可用代理配置。DOMAIN-SUFFIX 按域名后缀匹配,IP-CIDR 按地址网段匹配,GEOIP 根据地址地理数据库判断,FINAL 接住前面未命中的连接。PROXY 表示代理策略,DIRECT 表示直连策略。示例中的 example.com 只是保留示例域名,不代表需要访问或配置的真实服务。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY

如果更宽泛的规则放在前面,后面的具体规则可能永远没有机会命中。比如前面已经匹配了目标所在的地址范围,再增加一条靠后的域名规则,未必改变结果。域名规则还依赖客户端在处理时掌握域名信息;只有 IP 信息的连接,不一定能够按预期命中域名后缀。GEOIP 依赖目标 IP 与本地数据库的匹配结果,并不用于识别访问者身份。

DNS 与 UDP 要独立验证

DNS 决定域名解析得到哪些地址,而协议决定选中的连接如何到达远端,两者相互影响但不能等同。目标域名解析失败时,更换 UUID 通常不会解决问题;错误解析到不可达地址时,服务器握手正常也可能打不开网页。排查时分别记录解析是否成功、得到哪种地址族、该连接最终命中什么策略,避免把所有现象统一写成“节点不通”。

UDP 支持也要从应用、客户端、出站协议、服务端与路径连续检查,不能只看一处开关。On Demand(按需连接)控制何时按条件建立或保持客户端连接,不会改变服务器的协议类型,也不能修复认证参数。若问题仅发生在自动连接或网络切换时,应把触发条件与协议握手分开观察。三种姿态的具体日常用法见Global Routing 说明,规则关键字可查术语表。

按已有条件选型,再分层排查

decision-and-check

先列出约束,而不是先给协议排序

选择从已有可用配置开始。先写清楚当前网络是否允许 UDP、服务端提供哪些协议与传输组合、目标应用是否需要 UDP,以及更关注持续下载、互动响应还是待机恢复。若只有一套明确可用的服务端配置,正确选择就是与它一致的客户端类型;没有必要为了某个协议名称重新拼凑字段。若已有多套入口,则应先排除当前网络根本无法承载的组合,再比较实际任务表现。

需要访问自己维护的内部网络,且已经具备完整地址与密钥配置时,可以研究 WireGuard 的路由与接口范围;已有精简的加密代理配置,可以先确认 Shadowsocks 的方法与 UDP 能力;依赖特定传输部署时,关注 VMess、VLESS 的完整外层组合;已有 TLS 代理入口时,核对 Trojan 的证书与密码;组织指定通用代理时,则按 HTTP 或 SOCKS5 的真实能力使用。Hysteria2 的前提之一是当前路径能够正常承载所需 UDP 通信。

把“连不上”拆成可以观察的阶段

第一步确认本地网络基础可用,并选定一个自己能够验证的目标请求。第二步核对服务器域名能否解析、地址族是否合适,以及入口端口与传输是否相符。第三步检查握手:涉及 TLS 的配置看名称、证书与系统时间;涉及密钥或 UUID 的配置看凭据是否完整。第四步在认证成立后观察目标请求是否成功,以及规则是否真的选择了该出站。每一步只改一个变量,保留失败现象。

Connectivity Test(连通性测试)可以作为线索,但一次结果不能替代完整应用验证。测试可能只覆盖某种请求、某个目标或某段连接过程。列表中能得到响应,不等于目标视频、UDP 应用和内部域名都正常;测试失败也不必然说明所有业务都无法建立。应尽量使用与实际故障一致的目标和流量类型,并记录失败是立即发生、等待超时,还是传输开始后才中断。

现象优先检查暂不急于修改
始终无法开始握手地址、端口、TCP / UDP 可达性规则细节、吞吐预期
证书验证失败Server Name、时间、证书链UUID、规则顺序
网页正常,实时应用异常UDP 完整通路、目标规则全部重建服务器条目
仅大资源卡住路径、丢包、MTU 相关迹象任意替换认证信息
只在 Config 下异常规则命中、策略、DNS协议类型

速度与电量做两个独立记录

速度测试应固定目标资源、本地网络和服务器入口,分别观察首次响应与持续传输,避免把缓存命中误认为协议改进。电量测试则应固定任务量、屏幕使用和信号条件,注意待机期间是否反复重连。系统电池统计反映一段时间的综合活动,无法直接分离每次协议握手的成本。不要用几分钟内的百分比变化作精确排名,也不要为排查待机耗电连续运行高负载测速。

切换网络后才出现的问题,要单独记录 Wi-Fi 与蜂窝网络的差异,包括地址族、UDP 可达性和闲置后恢复。只有某个目标异常时,应优先检查该目标的 DNS、路由与服务状态,不要立即更换整个协议。若多个配置在同一本地网络下同时失败,而换网络后恢复,则本地路径比凭据同时失效更值得优先调查。这样的分支判断可以减少没有依据的配置改动。

保留原始配置与可复现步骤

订阅更新后出现变化,应先比较条目是否被替换、传输字段是否改变,以及手工编辑是否被覆盖。不要把旧配置的凭据直接拼到新入口上。记录最小复现步骤时,只需要设备网络、协议组合、错误阶段、目标类型和已经验证的对照结果,隐藏完整订阅地址与凭据。已有订阅导入为空的检查方法见订阅导入自查,其他常见现象见常见问题。

完成测试后,恢复日常使用的 Global Routing 姿态,并撤销临时放宽的设置。可用、完整、可以解释的配置,比无法复现的单次速度结果更适合作为长期选择依据。需要重新按步骤检查导入和连接时,返回使用说明;需要获取客户端时,使用全平台下载页。iPhone / iPad 的系统要求以 App Store 页面标注为准,本页不根据协议名称推断设备兼容性。