适用范围与准备
适用于Hysteria 2原生客户端在连接阶段超时或认证失败。准备当前客户端版本、提供方给出的有效参数和本轮错误;本文以普通UDP传输及Salamander配置为例,第三方客户端字段需按其文档映射。
先区分原因
连接需要到达正确对端、使用匹配的混淆方式、完成TLS与认证。官方明确说明混淆密码错误也会表现为超时,看起来像服务未运行;因此超时既不能直接证明UDP被封,也不能直接证明认证密码错误。
按顺序操作
- 保留原配置副本,确认实际加载的是Hysteria 2配置。核对服务器地址、端口和当前网络,记录一次失败时间与原始错误。端口必须对应服务端;网页能打开或TCP端口可连,不等于该UDP入口可用。
- 核对双方是否启用混淆,以及混淆类型和对应密码。Salamander的密码属于obfs.salamander.password,不是客户端auth。仅一方启用、类型不匹配或值错误都要先向提供方确认;不要自己在客户端换类型后期待服务端自动匹配。
- 出现明确认证错误时,核对原生客户端auth。服务端使用userpass方式时,官方要求该值采用username:password格式;不要把本机SOCKS入口的用户名密码填到远端认证字段中。不同字段即使碰巧同值,也仍是不同用途。
- 出现证书错误时核对设备时间、服务器名称、SNI及提供方的可信证书设置。原生tls.insecure保持false,不把关闭验证当作修复。使用hysteria2 URI提供连接参数时,先按官方说明确认参数来源,避免又在独立字段重复指定URI已包含的设置。
- 参数核对后仍超时,可在获准的另一网络用同一配置进行一次对照;有服务端权限者再查看同一时刻的监听、防火墙与日志。没有服务端证据时记录“尚未定位”,不要同时改带宽、MTU、混淆和认证来碰运气。
| 参数或证据 | 用途 | 常见误判 |
|---|---|---|
| obfs及其password | 双方混淆配置 | 把超时直接判为UDP封锁 |
| auth | 远端认证 | 误填本地SOCKS凭据 |
| tls.sni / tls.insecure | 名称与证书验证 | 关闭验证后宣称已修复 |
| 同配置跨网络对照 | 缩小路径问题范围 | 一次成功代表永久稳定 |
怎样确认有效
确认原生客户端完成连接,再从实际代理入口发起原业务请求。错误从超时变为认证失败只是定位推进;握手成功也不能替代目标访问。若应用需要UDP转发,还应另外验证实际业务,不能用网页成功代表UDP业务通过。
无效时恢复与下一步
每次对照无效就恢复该项,保留原可用配置。反馈只包含版本、时间、失败阶段和脱敏后的字段用途,不发送真实密码、URI或订阅二维码。本文未运行客户端连接真实节点,也未给出Hysteria 2更快的测量结论;带宽设置另见关联教程。