hysteria2 转 Clash:什么时候转得了、什么时候转不了
hysteria2 转 clash 能否成功,取决于两件事:客户端内核是否认 hysteria2 类型,以及链接里的字段是否都被带进配置。内核不认就转不了;认的话还要核对密码、sni、混淆和端口写法,再实际验证。
hysteria2 转 clash,和前面讲过的 vmess 转 Clash、vless 转 Clash 有一个根本区别:vmess 和 vless 几乎所有 Clash 系内核都认,转换主要是核对字段;Hysteria 2 则要先过一道“认不认”的关,因为它是基于 QUIC 的协议,走的是 UDP,并不是每个内核、每个版本都内置了它。本文先讲什么条件下转得了,再讲怎么转,最后列出几种转了也用不了的情况。
第一关:内核和客户端认不认 hysteria2
不要上来就转,先查支持。判断顺序如下:
- 内核:Mihomo 文档里有 hysteria2 代理类型,并写明混淆(obfs)支持 salamander 与 gecko。基于 Mihomo 的客户端,原则上能读 hysteria2 配置。sing-box 文档里也有 Hysteria2 出站。内核太旧、版本不详时,以官方文档和发布说明为准。
- 客户端:客户端自己没有单列协议的,要看它内置的内核,再回到内核的支持情况。可以在 客户端档案 里找到内置内核的说明,再到 协议 × 客户端支持矩阵 对格子;矩阵里查不到官方出处的格子写“资料待核实”,不要当成“支持”。
- 版本线:Hysteria 2 与 Hysteria 1.x 不兼容,客户端和服务端必须同为一条版本线,这是官方对比页明确写的。链接以 hysteria:// 开头的多半是旧版本,本站工具不会转换它。
想了解 Mihomo 内核本身,读 Mihomo 内核是什么;想了解协议本身,读 Hysteria2 协议是什么。内核不认的情况下,字段再准也没用,这时候的出路是换客户端,不是继续改配置。
能转的部分:链接里的字段怎么对应
做 hysteria2 转 clash,字段对应是核心。Hysteria 2 的分享链接比 vmess 简单,用户信息和参数都写在 URL 里。本站工具能识别的字段,与 Clash(Mihomo)配置的对应关系如下:
| 链接里的信息 | 常见键名 | Clash 配置里对应的写法 |
|---|---|---|
| 认证信息 | @ 前面的部分 | password |
| 服务器地址与端口 | host、port | server、port |
| TLS 主机名 | sni | sni |
| 是否跳过证书校验 | insecure | skip-cert-verify |
| 混淆类型 | obfs | obfs |
| 混淆密码 | obfs-password | obfs-password |
| 应用层协议 | alpn | alpn |
| 证书指纹 | pinSHA256 | fingerprint |
| 节点名称 | # 后面的部分 | name |
几点说明:
- 认证信息如果写成“用户名:密码”的形式,工具会把整体当作 password。官方的 userpass 认证在 sing-box 中也是这样处理的(sing-box 文档有专门说明),Mihomo 是否一致,请以 Mihomo 文档为准,转换后用实际连接验证。
- insecure 为 1 时工具会写入 skip-cert-verify: true,等于关闭证书校验。除非提供方明确说明用的是自签证书,且你同时核对了证书指纹,否则不建议保留。
- 这些键名是社区通行写法,并非所有软件导出的链接都完全一致,以你手里那一条为准。可以先用 节点链接解析器 拆开看。
用本地工具转换:步骤
hysteria2 转 clash 的本地操作很短,节点转 Clash 工具 在浏览器里运行,不上传数据:
- 把 hysteria2:// 或 hy2:// 链接粘贴进输入框,每行一条。
- 输出格式选“Clash(Mihomo)proxies 片段”,点“转换”。
- 先读输入框下方的提示,再复制结果。
- 把片段放进 proxies 列表,并在策略组里引用节点名。
下面是一个举例,数值均为虚构,不对应任何真实节点:
proxies:
- name: 示例 Hy2 节点
type: hysteria2
server: example.com
port: 443
password: 示例认证串
sni: example.com
obfs: salamander
obfs-password: 示例混淆密码
阅读时留意两点:这里没有 udp 字段,因为 Hysteria 2 本身就同时承载 TCP 与 UDP,工具不会像 vmess 那样补 udp: true;也没有任何速率字段,原因见下一节。想看 sing-box 的写法,可以在工具里把输出格式切换为 sing-box outbounds,对照两种格式能帮你理解字段之间的对应。
转不了或转得不完整的五种情况
下表列出 hysteria2 转 clash 时最常见的五种卡点:
| 情况 | 为什么 | 怎么办 |
|---|---|---|
| 内核或客户端不认 hysteria2 类型 | 配置里的 type 无法被识别 | 换用支持的客户端,先查支持矩阵 |
| 链接是 hysteria://(1.x) | 官方说明 2 与 1.x 不兼容 | 向提供方确认版本,不要强行改成 hysteria2 |
| 使用端口跳跃 | 本站工具只按单一端口生成片段 | 对照 Mihomo 与 Hysteria 官方文档手写,或换客户端 |
| 需要设置 up、down 速率 | 工具不输出速率字段 | 查 Mihomo 文档里的字段名,按自己的带宽设置 |
| 证书相关字段较复杂 | 如自定义 CA,链接里往往不带 | 按提供方说明在文档里找对应字段 |
关于速率,官方文档写明:客户端认证时可以声明自己的最大接收速率,服务端据此决定发送速率,声明为 0 时改用 BBR 等拥塞控制算法。所以速率字段不是摆设,但填多少取决于你自己的带宽,这是本文无法替你判断的地方,也不要抄别人的数字。
还有一种很容易误会的情形:官方 CDN 页面的答复是 Hysteria 2 不能套 CDN。如果有人把 Hysteria2 节点和 CDN 绑在一起宣传,先对照官方页面再判断,别指望靠改配置去“适配”。
转对了还连不上:UDP 才是最大的变量
Hysteria 2 建立在标准 QUIC 之上,数据通过 UDP 承载。这意味着转换完全正确,节点仍可能连不上:链路上只要有一环不放行 UDP,就会超时。常见的环节有家用路由器的防火墙设置、公司或学校的网络策略、移动网络的限制等。
区分字段问题与环境问题,有一个实用的办法——同一份配置换网络试:
- 先用手机热点连一次,再用家里的宽带连一次。
- 如果一个网络能连、另一个不能,问题大概率在环境,而不是转换。
- 两个网络都不行,再回头逐项核对字段。
这种对比只能说明问题的方向,不能当作结论,也不代表哪个网络“更好”。词典里的 QUIC 讲了这类协议的基本特点,Hysteria2 客户端配置 则覆盖了导入节点时的常见填写项。
怎么验证转换后的 hysteria2 clash 配置
按下面顺序验证,每一步通过再做下一步:
- 配置能加载:客户端不报 YAML 或类型错误。若提示 type 不识别,说明内核不认,回到第一关。
- 节点出现在列表:能在节点页看到并选中。
- 延迟测试:有数值说明握手完成;超时先做上面的换网络对比。
- 出口检查:打开代理后,到 IP 与 DNS 检测导航 里的页面,看出口地区是否符合预期。
- 对照原客户端:同一链接在原来的客户端里能用,说明问题在转换,这时对比两边字段最直接。
- 留意连接稳定性:只做一次测试不够,隔一段时间再看一次。延迟数字只代表当时当地。
整体打不开的情形,用 梯子连不上怎么办 的按现象排查更系统。
下一步:决定是转,还是换客户端
- 先用 协议 × 客户端支持矩阵 和 客户端档案 查内核是否认 hysteria2;不认就别转。
- 认的话,用 节点转 Clash 工具 本地转换,逐项核对上面的字段表。
- 节点用了端口跳跃或速率限制,按官方文档手写,或者直接选一个原生支持 Hysteria 2 的客户端,例如 sing-box 系,见 sing-box 是什么。
- 遇到 VLESS 与 Reality 节点,去读 vless 转 Clash;协议之间怎么选,读 Hysteria2 与 VLESS 哪个好。
这篇没有覆盖的
- 本文没有任何节点的速度、延迟或丢包数据,也不评价 hysteria2 节点好不好用。
- 具体字段与取值以当前 Mihomo 和 Hysteria 官方文档为准,本文没有逐版本核对。
- 只讲客户端侧的转换与验证,不涉及服务端搭建,也不教任何绕过限制的做法。
本文引用的官方来源
- Hysteria 2 官方文档(v2.hysteria.network)
- Hysteria 2 与 Hysteria 1 的区别(v2.hysteria.network)
- Mihomo 文档:Hysteria2(wiki.metacubex.one)
- sing-box 文档:Hysteria2(sing-box.sagernet.org)
以上链接均为官方页面,梯子岛在 2026-10-09 核对过;个别网站会拦截自动化访问,用浏览器直接打开即可。平台规则可能随时调整,以官方页面当前内容为准。
hysteria2 转 clash常见问题
hysteria2 节点一定能转成 Clash 配置吗?
不一定。Mihomo 文档里有 hysteria2 代理类型,基于 Mihomo 内核的客户端原则上能读,但客户端用的是别的内核或版本很旧时,可能不认。先查支持矩阵和客户端档案,确认认识这个类型,再谈字段怎么转。
链接以 hy2:// 开头和 hysteria2:// 开头有区别吗?
这两种写法在社区里都常见,本站转换工具把它们都当作 Hysteria 2 处理。要注意的是 hysteria:// 开头的通常是 1.x 版本,官方说明 2 与 1.x 不兼容,工具也不会转换它,遇到这种链接要先向提供方确认版本。
转换后没有 up 和 down 速率,会有影响吗?
官方文档说明,客户端可以声明自己的最大接收速率,服务端据此决定发送速率。本站工具不输出速率字段,所以转出来的是默认写法。需要限速或调整时,到 Mihomo 官方文档查字段名,按你自己的带宽手动补充,不要照抄别人的数值。
端口跳跃的节点能转吗?
本站工具不处理端口范围写法,只按单一端口生成片段。官方文档和 sing-box 文档都提到了端口跳跃,Mihomo 是否支持、字段怎么写,以其官方文档为准。节点用了这种写法,建议手写核对,或直接换用原生支持的客户端。
转换正确却连不上,是不是 UDP 被限制了?
有这个可能。Hysteria 2 建立在 QUIC 之上,数据走 UDP,链路上任何一环不放行 UDP,节点就可能连不上。换一个网络,比如手机热点和家宽对比,是区分字段问题与环境问题的一个办法。
接着读
- 协议 · Hysteria2 协议是什么?基于 QUIC 的节点怎么用
- 术语 · QUIC是什么意思
- 教程 · Hysteria2 客户端配置:导入节点与常见填写项
- 教程 · vless 转 Clash:Reality 节点转配置时容易漏的字段
- 客户端 · sing-box 是什么?内核、官方客户端与各平台入口
- 客户端 · Mihomo 内核是什么?Clash Meta 内核与客户端的关系