先确定正在阅读哪一代协议
Hysteria / Hysteria2 在阅读时先区分代际。hysteria2是什么,可以按协议规范回答为基于 QUIC 的 TCP 与 UDP 代理;规范描述自 2.0.0 起采用的协议。这是协议的技术定位,不包含速度或适用效果判断。
相关概念可以从节点是什么意思进入;如果你面对的是字段列表,读节点参数。先确认协议与实现,再看当前资料属于哪一代,能够避免把旧文档与新字段直接拼接。
QUIC 承载中的 TCP 和 UDP 分别表达
| 阅读维度 | 官方资料给出的内容 | 接下来核对什么 |
|---|---|---|
| 协议代际 | Hysteria2 与旧代不兼容 | 两端是否属于同代 |
| 传输 | 基于 QUIC,处理 TCP 与 UDP | 所用实现参考 |
| 认证 | 官方客户端 auth | 实现字段差异 |
| 发布 | 应用标签与各来源日期 | 保留冲突来源 |
代际差异页写明 Hysteria2 与 1.x 不兼容,两端必须同为 1.x 或同为 2.x。mihomo 也将 hysteria 与 hysteria2 分页列出。配置层次可接着读clash节点,内核层次可读mihomo介绍。
认证字段按官方程序与实现分别阅读
官方客户端参考的认证字段为 auth。服务端使用 userpass 时,用户名与密码组成一段认证文字。sing-box 出站参考写明,它不提供这个别名,与官方程序配合时要把组合写入 password。
文档列出的功能也有代际范围
代际差异页说明,Hysteria2 尚未实现旧代的客户端侧 ACL 和 FakeTCP;服务端另有 ACL。这里的“客户端侧”需要与“服务端”同时保留,不能缩写成所有 ACL 都不存在。官方文档还留有旧代入口,用于阅读对应时期的资料。
发布标签的日期冲突按来源并列
给定发布 API将 app/v2.13.0 的日期记为 2026-10-05;给定发布源却将相同标签记为 2026-09-16,同时另列 extras/v2.13.0 于 2026-10-05。两项记录存在冲突,本文不选其中一个写成确定的应用发布日期。
把协议问题转成实现问题继续阅读
如果问题是两端能否匹配,先看代际;如果问题是认证字段,再看实现参考;如果问题出现在订阅内容,则进入集合格式。界面提示按报错索引保存,客户端身份由Clash 名称页继续辨认。
对于未核对的第三方应用名单、某个安装文件或没有标版本的字段,本页保持官方页面未写明。读完可以把协议规范、实现字段与发布记录分别对应起来,不把一个名称扩展成所有程序完全互通的结论。
sing-box 的字段版本与协议加入版本分开
官方客户端参考还写明,自 2.4.1 起可以在同一端口同时支持 SOCKS5 与 HTTP。这个版本条件属于官方客户端功能,不用来填补 mihomo 的版本未知项。前面列出的不同实现各有资料,同一个协议名不让版本条件自动互用。
规范页面和程序页面解决不同问题
两代协议不兼容这一条件也应原样保留,而不是只写“名称相近”。认证资料使用哪一个字段、两端属于哪一代、当前实现声明了哪些版本条件,都可以独立核对。尚未取得的第三方应用信息继续留空;这里的技术介绍止于已给定的官方资料。
同一标签的日期在来源间有差异时,标签本身仍可作为记录对象。把来源类型与各自日期附在旁边,保留冲突即可。应用标签与 extras 标签也分别记录,不因为版本数字相同,就将一个标签的日期当成另一个标签的确定发布时间。
截至 2026-10-23 的官方记录
代际条件、实现版本及日期冲突在这里分别记载,冲突来源同时留存。
-
截至 2026-10-23,官方页面显示Hysteria2 的规范描述自 2.0.0 起使用的协议,基于 QUIC 处理 TCP 与 UDP,以官方页面为准。 第二代协议规范
-
截至 2026-10-23,官方页面显示Hysteria2 与 1.x 不能互通,客户端和服务端必须同代,以官方页面为准。 两代兼容条件
-
截至 2026-10-23,官方页面显示sing-box 在 1.5.0 的变更记录中加入 Hysteria2 协议,以官方页面为准。 sing-box协议加入
-
截至 2026-10-23,官方页面显示app/v2.13.0 在 API 记录日期为 2026-10-05,在发布源日期为 2026-09-16,两项并列,以官方页面为准。 API标签日期 发布源中的同标签
| 对象 | 条件类型 | 正文记录值 |
|---|---|---|
| Hysteria2 协议规范 | 适用起点 | 2.0.0 |
| 加入版本 | 1.5.0 | |
| app/v2.13.0 | API 记录日期 | 2026-10-05 |
| app/v2.13.0 | 发布源日期 | 2026-09-16 |
来源:第二代协议规范;sing-box协议加入;API标签日期。核对日期:2026-10-23。各行保留不同条件的含义;不表示版本大小、发布时间排序或当前最新状态。