Hysteria2 客户端配置：导入节点与常见填写项
梯子岛编辑部 · 更新于 Hysteria2 节点跑在 UDP 上，客户端侧要对准的是服务器地址、认证密码、服务器名称，以及节点有没有启用混淆。导入前先确认客户端支持，连不上时先排除网络是否放行 UDP。
Hysteria2 节点的字段比大多数协议少，出问题的方式却很有特点：填得都对，就是连不上，换个网络又好了。这篇 Hysteria2 配置教程把客户端侧要做的事排成四步：认清链接里有什么，确认客户端支持，按字段填写，再用对照法验证。服务端怎么搭，不在讨论范围内。
先读懂 hysteria2节点链接：每一段在说什么
官方文档里有专门的链接格式说明，具体参数以那一页为准。读者在实际链接里最常碰到的是这几类信息：
| 链接里的信息 | 在客户端里对应什么 | 填错的后果 |
|---|---|---|
| 开头的一段身份信息 | 认证密码 | 认证失败，连接被拒 |
| 服务器地址与端口 | 要连接的目标 | 连不上，或连到别处 |
| 服务器名称参数 | 握手时声明的域名 | 证书校验失败 |
| 混淆相关参数 | 是否启用混淆及其密码 | 两端不一致就无法通信 |
| 是否允许不安全的参数 | 跳过证书校验 | 开了会降低安全性 |
注意最后一行。它是链接里会带的一个选项，而不是你应该主动打开的开关。逐段拆开一条链接的方法见 节点链接怎么读，也可以用本机的 节点解析工具 看清楚每个字段，不要把含密码的完整链接发给别人。
动手之前：先确认客户端认不认 Hysteria2
Hysteria2 是较新的协议，并不是每个客户端都认。先查表，别装完再失望：
| 查询方式 | 能得到什么 |
|---|---|
| 协议支持矩阵 | 按协议列出哪些客户端写明支持，空格就是资料待核实 |
| 客户端档案 | 单个客户端的内核与协议登记 |
| 内核文档 | sing-box 与 Mihomo 都有 Hysteria2 的配置说明 |
内核有类型，不等于你装的客户端界面开放了它；界面里有入口，也要看版本够不够新。协议本身的原理和边界另见 Hysteria2 协议。
hysteria2 v2rayn：图形客户端里的导入流程
按档案登记，v2rayN 的协议清单里有 Hysteria2，另外可选独立内核。大致流程：
- 复制服务提供方给的节点链接。
- 在 v2rayN 里从剪贴板导入，节点出现在列表中。
- 检查节点类型是否显示为 Hysteria2，而不是别的类型。
- 选中节点，启动，按本文末尾的方法验证。
具体菜单位置随版本变化，以官方仓库和 Wiki 为准，另见 v2rayN 使用教程。如果你的客户端基于 Mihomo 或 sing-box，也可以走各自的导入流程，思路相同。
Hysteria2 配置里几个要认真对待的字段
认证密码：必须和服务提供方给的一致，粘贴时留意前后空格。
服务器名称与证书：节点给了就照填。证书类报错的排查顺序是服务器名称、系统时间、再问提供方，见 证书与时间问题。
混淆：有些节点启用了混淆，会带一个混淆类型和密码。启用与否由节点决定，客户端必须与之一致。官方文档对混淆的描述以其页面为准，梯子岛不给任何效果结论。
带宽相关设置：官方文档提到客户端可以设置收发速率。没有明确要求时，不要凭感觉填一个很大的数字，具体含义和影响以官方文档为准。
为什么要关心 UDP：连不上时最先要排除的原因
Hysteria2 基于 QUIC，数据承载在 UDP 上。这带来一个很实际的结果：网络路径上只要有一环不放行 UDP，节点就可能连不上。区分是节点问题还是网络问题，最省事的办法是换网络对比，比如在家里宽带和手机热点之间切换。
这里再区分两种常见误判：
- “换了网络就好了”不代表节点本身有问题，更可能是原来的网络不放行 UDP。
- “所有网络都不行”才更可能是配置字段或节点本身的问题。
QUIC 和 UDP 的基本概念可看词典里的 QUIC。
验证一条 Hysteria2 节点是否真的可用
- 列表里节点类型正确，没有被客户端转换。
- 启动后客户端没有立刻报错或频繁重连。
- 用 IP 与 DNS 检测 看出口地址是否变化。
- 访问你实际要用的网站或应用，不要只测一个页面。
- 换一条网络再测一次，用来区分网络和配置的问题。
梯子岛没有各线路的测速数据，所以这里只教方法。验证不过，再按 梯子连不上怎么办 排查。
要转成 Clash 配置时，先核对什么
有些人想把 Hysteria2 节点放进 Clash 系客户端。可行性取决于你用的内核是否支持，以及转换后的字段是否对得上。具体做法见 Hysteria2 转 Clash，转换的字段核对清单在那一篇里。转换尽量在本机完成，不要把含密码的链接交给来路不明的在线转换站。
导入后列表里没有节点或类型异常：三个常见原因
- 链接被聊天软件截断或自动换行，复制到的不是完整的一条。重新从原处复制，并确认以协议开头的前缀完整。
- 客户端不认识这种节点类型，导入时被直接忽略，没有任何提示。这时先查矩阵，再查客户端版本。
- 订阅返回的内容里混了多种协议，其中只有一部分被识别。对照订阅原文看节点数量是否一致。
处理的原则始终一样：先弄清楚是“没导入进来”还是“导入了但连不上”，两种情况的排查方向完全不同。
下一步：先查矩阵，再导入，再验证
照这篇 Hysteria2 配置教程走一遍：查 协议支持矩阵 确认客户端，导入节点，逐项核对字段，换网络做对照。想和同类协议比较，读 Hysteria2 与 TUIC 的区别；想看更多教程，去 教程栏目。
这篇没有覆盖的
- 本文不涉及服务端搭建，也不评价哪条 Hysteria2 节点可靠或速度如何。
- 链接参数的完整清单以官方文档为准，这里只讲读者最常碰到的几个。
- 哪款客户端支持 Hysteria2 会随版本变化，请以协议矩阵和客户端档案当前显示为准。
本文引用的官方来源
- Hysteria 2 官方文档（v2.hysteria.network）
- Hysteria 2 与 Hysteria 1 的区别（v2.hysteria.network）
- sing-box 文档：Hysteria2（sing-box.sagernet.org）
- Mihomo 文档：Hysteria2（wiki.metacubex.one）
- v2rayN 官方仓库（github.com）
以上链接均为官方页面，梯子岛在 2026-10-10 核对过；个别网站会拦截自动化访问，用浏览器直接打开即可。平台规则可能随时调整，以官方页面当前内容为准。
Hysteria2 配置常见问题
Hysteria2 节点导入后显示不支持怎么办？
多半是客户端或内核版本太旧，不认识这种节点类型。先到协议支持矩阵和该客户端的档案里核对，再看客户端的版本动态，必要时换一款写明支持的客户端。不要把节点硬改成别的协议，字段对不上也连不上。
为什么同一个节点换网络就能连上了？
Hysteria2 基于 QUIC，数据走 UDP。如果当前网络路径上有环节限制或丢弃 UDP，节点就会连不上或很不稳定，换一条网络通常会有变化。这是定位问题的有效对照，不一定说明节点坏了。
链接里的服务器名称和证书校验是什么关系？
服务器名称用于握手时告诉对方你要访问哪个域名，证书校验确认对方身份是否可信。节点给了名称就照填，别随手勾选跳过证书校验，那会让你失去对服务器身份的检查。证书类报错应优先查名称与系统时间。
Hysteria2 和 Hysteria 1 的节点能互换着用吗？
不能。官方对比页写明两者不兼容，客户端与服务端必须同为 1.x 或同为 2.x。拿到节点先弄清它属于哪条版本线，再确认客户端支持的是同一条，否则字段填得再对也连不上。
v2rayN 里怎么添加 Hysteria2 节点？
v2rayN 的档案登记支持 Hysteria2，另有独立内核选项，具体由所选内核决定。常见做法是复制节点链接后从剪贴板导入，再检查列表里节点类型是否识别正确。菜单位置随版本变化，以官方 Wiki 和软件内说明为准。
接着读
- 协议 · Hysteria2 协议是什么？基于 QUIC 的节点怎么用
- 教程 · hysteria2 转 Clash：什么时候转得了、什么时候转不了
- 对比 · Hysteria2 与 TUIC 的区别：两种 QUIC 系协议
- 术语 · QUIC是什么意思
- 术语 · TLS是什么意思
- 教程 · sing-box 配置文件入门：JSON 结构与最小可用配置