v2rayN 导入 Hysteria2 失败，别先重装客户端。先看剪贴板原文：hysteria2:// 和 hy2:// 是单条分享链接，https:// 多半是订阅 URL，{ "type": "hysteria2" } 这类内容更像 sing-box JSON。入口错了，后面的版本和日志都会被带偏。
Hysteria2 还有一个容易误判的点：导入成功只代表 v2rayN 识别了文本，不代表当前 core 能按这个字段连接。v2rayN 是 GUI，Hysteria2 连接通常要落到 sing-box 或其它支持该协议的 core 上。
链接类型和入口要分清
v2rayN 官方 wiki 写到，从剪贴板导入会按内容逐层解析：先看是否 https，再看分享内容、SIP008、自定义配置、Clash 或 Hysteria 配置，无法解析时可能生成无 core 类型的自定义配置。这个顺序解释了很多「我粘贴了但没新增节点」的问题。
| 剪贴板开头 | 更可能是什么 | 在 v2rayN 里怎么处理 | 失败时先看 |
|---|---|---|---|
hysteria2:// | Hysteria2 单条 URI | 从剪贴板导入服务器 | URI 字段、core 类型 |
hy2:// | Hysteria2 短 scheme | 从剪贴板导入服务器 | v2rayN 版本、字段是否被截断 |
https:// | 订阅 URL 或网页 | 放到订阅分组更新 | 返回内容是不是配置 |
{ "type": "hysteria2" | sing-box outbound JSON | 作为自定义配置或换 sing-box 客户端 | JSON 是否完整、core 是否匹配 |
proxies: | Clash / Mihomo YAML | 不建议当 v2rayN 单条导入 | 回订阅后台换 V2Ray / sing-box 输出 |
如果你复制的是订阅后台的一键导入按钮，不要只复制按钮文字。把真正的 URL 粘出来，看开头和字段。很多按钮会把链接包在网页跳转里，v2rayN 读到的是 HTML 或短链，不是 Hysteria2 配置。
URI 字段缺一个就像客户端坏了
Hysteria2 官方 URI 结构是 hysteria2://[auth@]hostname[:port]/?[key=value]&[key=value]...，也允许 hy2 作为 scheme。auth 放认证信息；hostname 和 port 指向服务器；query 里常见 sni、obfs、obfs-password、insecure、pinSHA256。
| 字段 | 在 URI 里的位置 | 常见问题 | v2rayN 里的表现 |
|---|---|---|---|
auth | :// 后、@ 前 | 特殊字符没编码，或 userpass 里的冒号被截断 | 导入后认证失败、日志提示 auth 或 password |
hostname / port | @ 后面 | 端口漏掉时默认可能按 443 理解 | 节点有名字但连接超时 |
sni | query 参数 | 和证书域名不一致 | TLS、certificate、handshake 错误 |
obfs | query 参数 | 服务端启用但链接里没有 | QUIC 连接阶段失败 |
obfs-password | query 参数 | 密码为空、被空格截断、未转义 | 认证或握手失败 |
insecure | query 参数 | 误把 1 / 0 写成其它值 | 证书校验行为和预期不一致 |
pinSHA256 | query 参数 | 指纹复制不完整 | 证书 pin 校验失败 |
聊天软件最容易动 #、&、空格、中文备注和冒号。把链接贴进 Notepad 或 VS Code，看每个 &key=value 是否还在同一行；如果一条 Hysteria2 URI 被自动换成两行，v2rayN 只能读到前半段。
v2rayN 版本、core 版本和 Hysteria2 是三层
官方 Release 页显示 v2rayN 7.22.3 发布于 2026-05-21。这个版本号说明 GUI 更新到了哪里，但不等于你当前运行的 sing-box、Xray-core 或其它 core 已经按同一节奏更新。
| 层级 | 你看到的名字 | 跟 Hysteria2 的关系 | 排查动作 |
|---|---|---|---|
| GUI | v2rayN 7.x | 负责导入、显示、生成配置、启动 core | 升级到官方 Release，避免旧导入逻辑 |
| core | sing-box | 常见 Hysteria2 执行层 | Hysteria2 能显示但连不上时优先测试 |
| core | Xray-core | VLESS、VMess、Trojan 更常见 | 不要默认拿它修 Hysteria2 |
| 配置 | Hysteria2 URI | 提供服务器、认证、TLS、obfs 等字段 | 对照原始链接逐项看 |
| 订阅 | 后台输出格式 | 可能给 Clash、V2Ray、sing-box 多种版本 | 取 v2rayN 或 sing-box 对应格式 |
如果你刚更新 v2rayN 后 Hysteria2 失败，日志里要同时记下两行：v2rayN 版本和 core 名称。只写「更新到最新版」没法定位，因为失败可能来自 GUI 导入、core 执行，也可能是订阅端换了字段。
sing-box 字段对照 URI
sing-box 的 Hysteria2 outbound 文档列出 server、server_port、password、obfs、tls 等字段。把它和 URI 对上，可以快速判断「链接缺字段」还是「v2rayN 没转好」。
| sing-box outbound 字段 | Hysteria2 URI 对应位置 | 空了会怎样 |
|---|---|---|
server | hostname | 找不到目标服务器 |
server_port | :port | 端口不对或落到默认值 |
password | auth | 认证失败 |
obfs.type | obfs | 服务端要求混淆时握手失败 |
obfs.password | obfs-password | 混淆密码不匹配 |
tls.server_name | sni | 证书域名不匹配 |
tls.insecure | insecure | 证书校验策略不同 |
如果订阅后台能导出 sing-box JSON，可以拿 JSON 和 URI 做一次人工对照：同一台服务器的 host、port、password、sni、obfs 是否一致。字段一致但 v2rayN 仍失败，再看 core；字段不一致，先回订阅后台重新复制。
日志读第一条真正的错误
v2rayN 的测速失败、列表红色、延迟 -1 ms 都是结果，不是原因。打开日志后，从本次启动时间往下看第一条 error 或 warning。
| 日志片段 | 更可能的位置 | 下一步 |
|---|---|---|
unsupported protocol | 当前 core 不支持 Hysteria2 | 切 sing-box 或更新 core |
unknown field | 配置字段和 core 版本不匹配 | 更新 core，或让订阅端导出旧字段 |
authentication / password | auth 或 obfs-password 错 | 回原始 URI 看编码和截断 |
certificate / tls / handshake | SNI、证书、pin 或 insecure 不一致 | 对照 sni、pinSHA256、证书设置 |
context deadline exceeded / timeout | 端口、UDP、服务器不可达或测速目标不通 | 单测该节点，不要同时换订阅 |
file not found / core executable | core 文件缺失 | 从官方 Release 或 v2rayN 内置更新修复 core |
如果日志第一条就显示 core 文件缺失，不要继续改 Hysteria2 URI。如果第一条是证书或认证错误，升级 v2rayN 通常不是主解法，应该回到 sni、auth 和 obfs 字段。
排查顺序（15 分钟内）
按下面顺序走，基本能把问题压到一个层级：
- 把链接粘到纯文本编辑器，确认开头是
hysteria2://或hy2://。 - 检查链接里有没有
@、hostname、port、sni，以及服务端要求的obfs和obfs-password。 - 更新 v2rayN 到官方 Release 的稳定版，不从聊天记录里的压缩包覆盖安装。
- 导入后打开节点详情，看类型是否真的是 Hysteria2 或自定义配置。
- 节点能显示但无法连接时，把该节点使用的 core 切到 sing-box。
- 重启 v2rayN，只测这一条节点。
- 打开日志，按第一条 error 继续处理。
多端订阅排错时，最怕后台默认给 Clash YAML，你却拿它去喂 v2rayN；或者同一账号里有人复制了 Hysteria2 单条链接，有人复制了 sing-box JSON。需要给 Clash、sing-box、V2Ray 系客户端同时分发时，用一份兼容 Clash / Singbox / V2Ray 的订阅做源头，再分别取目标客户端格式，至少能减少格式混乱。
确认修复：5 个信号
修好不只看节点变绿。至少做完这 5 个检查：
- 服务器列表里新增的是 Hysteria2 相关条目，不是无 core 类型的自定义配置。
- 节点详情里的 hostname、port、SNI、认证和 obfs 字段没有明显空值。
- v2rayN 日志里能看到当前 core 启动，且 core 名称和你预期一致。
- 单条节点延迟测试能返回数值，或日志显示已经进入实际连接阶段。
- 关闭 v2rayN 后重新打开，节点仍能连接，说明不是临时路径或残留进程造成的假恢复。
如果只在第一次导入后成功，重启就失败，优先看 core 文件路径和安全软件隔离记录。Hysteria2 本身依赖 UDP / QUIC 行为，办公电脑、受管网络和虚拟机环境可能还会额外拦截，这类问题不靠改 URI 解决。
相关阅读
边界：这些问题不归导入管
这篇只处理 v2rayN 导入 Hysteria2 / hy2 分享链接、订阅格式和 core 匹配问题。没有测试每个第三方面板的导出模板，也不判断某个服务端配置是否正确。
Hysteria2 的 Realm 模式、端口跳跃、证书 pin、obfs 实现细节会随服务端和 core 版本变化。官方 Hysteria2 文档也提醒第三方实现可以加入额外参数，但不能假设其它实现都能理解。遇到服务商自定义字段，先拿同一后台的 sing-box JSON 或官方客户端配置做对照，不要把未知参数直接当成 v2rayN bug。