Clash Verge Rev Hysteria2 配置：从导入节点到连接排查
简答：Clash Verge Rev 内置 Mihomo 内核，可以导入包含 Hysteria2 的订阅，也能通过 URI 或独立 YAML 添加节点。优先用订阅导入；连接失败时先核对 UDP、端口、密码、SNI 和内核日志，再处理 TUN、DNS 与 MTU。
定义：Hysteria2 是基于 QUIC/UDP 的代理协议，在 Clash Verge Rev 中通常由内置的 Mihomo 内核负责解析和连接。
先试这一步：确认内核、导入订阅并选择节点
Clash Verge Rev 是基于 Tauri 的桌面客户端，官方文档说明它内置 Clash.Meta（mihomo）内核，并支持 Windows、macOS 和 Linux。它与早期 Clash Verge 的关系，可以理解为延续其图形界面和配置管理思路的 Rev 项目；官方 README 同时列出原 Clash Verge 与 mihomo 作为相关来源和内核项目。Clash Verge Rev 官方 README
截至 2026-10-24，Releases 标记为 Latest 的是 v2.5.8。不同系统的菜单名称可能略有变化，但基本流程仍是“添加订阅—更新订阅—打开代理页面—选择节点—开启系统代理”。Clash Verge Rev Releases
- 打开 Clash Verge Rev，进入“订阅”或“配置”页面，粘贴你的订阅地址并保存。
- 点击更新订阅，等待配置下载完成；如果订阅本身含有 Hysteria2 节点，节点列表中通常会显示对应节点名称。
- 进入“代理”页面，确认代理组里能看到目标节点。先手动选中该节点，不要一开始就开启自动测速或复杂规则。
- 先开启“系统代理”测试浏览器或单个应用，再根据需要启用 TUN。端口常见默认为 7897 或 7890，以设置页显示为准。
- 验证时观察连接日志中是否命中了目标策略组，或对比开启代理前后的出口 IP；只看到节点延迟不代表实际业务流量已经经过该节点。
如果订阅更新成功但节点列表没有 Hysteria2，先检查订阅内容和服务端提供的协议类型；不要直接把其他协议的字段复制到 Hysteria2 节点中。
三种配置方式怎么选
| 方式 | 适用情况 | 操作重点 | 常见问题 |
|---|---|---|---|
| 订阅导入 | 已有订阅地址，节点由订阅端维护 | 添加订阅、更新、在代理组中选择节点 | 订阅没有节点、更新失败或代理组没有引用节点 |
| URI 导入 | 只有一条 hysteria2:// 或 hy2:// 节点链接 | 使用客户端支持的节点导入入口，或先转换为配置 | 特殊字符未编码、参数名称不兼容、密码被截断 |
| 独立 YAML | 需要手动核对每个字段 | 作为完整配置导入，不要直接覆盖现有订阅 | 缺少代理组、规则或模式设置，导致节点存在但流量不经过它 |
Hysteria 2 官方 URI 结构为 hysteria2://[auth@]hostname[:port]/?[key=value]#name，也支持 hy2:// 别名。密码或认证信息中的特殊字符需要按 URI 规则进行百分号编码。Hysteria 2 URI Scheme
独立 YAML 模板：先用最少变量验证连接
下面是适合单独导入测试的完整配置。它不是 Extend Config 或 Merge 片段，而是一个独立配置，因此使用了顶层 proxies、proxy-groups 和 rules。如果你要把节点追加到已有订阅，不要直接把这份文件合并进去，否则可能覆盖原有节点或代理组。
mode: rule
log-level: info
mixed-port: 7890
proxies:
- name: HY2-测试
type: hysteria2
server: example.com
port: 443
password: <密码>
sni: example.com
skip-cert-verify: false
proxy-groups:
- name: HY2-选择
type: select
proxies:
- HY2-测试
- DIRECT
rules:
- MATCH,HY2-选择替换 server、port、password 和 sni 后保存并导入。sni 通常应填写证书对应的域名，即使 server 临时改成 IP 进行 DNS 排查，也要保留原证书域名，否则可能引入新的 TLS 校验错误。Mihomo 文档将 Hysteria2 节点写成代理数组，并列出密码、端口、端口跳跃、带宽、混淆等字段。Mihomo Hysteria2 配置文档
导入后在客户端中确认当前运行模式与配置一致。独立 YAML 中的 mode: rule 只是配置文件的默认值，实际仍应以客户端主界面或托盘中的模式切换为准；如果只想做最短链路测试，也可以临时在客户端切换到全局模式，再确认出口 IP 和连接日志。
字段怎么填：哪些必需，哪些先不要动
| 字段 | 作用 | 建议 |
|---|---|---|
type | 指定协议类型 | 填写 hysteria2，不要写成 hysteria。 |
server | 服务器域名或 IP | 优先使用服务端提供的地址；改成 IP 只用于临时排查解析问题。 |
port | 连接端口 | 填写节点提供的 UDP 端口；如果使用 ports 端口范围，按文档规则处理，不能把两者随意混写。 |
password | 认证密码 | 必须与服务端一致，前后空格和特殊字符都要检查。 |
sni | TLS 的服务器名称 | 通常填写证书域名；它不等同于本地节点备注。 |
skip-cert-verify | 是否跳过证书校验 | 正常证书应保持 false；不要把它当作连接失败的默认修复项。 |
up、down | Brutal 拥塞控制使用的上下行带宽提示 | 单位默认为 Mbps。带宽不确定时可以先不填，完成基础连接验证后再对比。 |
obfs、obfs-password | QUIC 混淆类型和密码 | 只有服务端明确启用时才填写；公开 Mihomo 文档列出的常用类型是 salamander。不要自行添加未在对应版本文档中确认的类型或字段。 |
tls | 部分客户端界面中的 TLS 开关或通用字段 | 不要从其他内核配置机械复制。以 Clash Verge Rev 生成的节点字段和 Mihomo Hysteria2 文档为准，Hysteria2 模板优先核对 sni、证书校验和 ALPN。 |
Hysteria2 依赖 UDP。即使节点可以导入，当前网络仍可能因为 UDP 被限制、防火墙拦截、端口未开放或 DNS 解析失败而无法建立连接。
连接失败的排查顺序：从日志关键词到网络层
- 先看内核是否启动。在 Clash Verge Rev 的内核或日志页面确认配置加载成功。日志中的具体文字会随客户端和内核版本变化，遇到 timeout、TLS handshake、authentication failed、DNS resolve failed 或 SERVFAIL 等关键词时，先把它们当作排查线索，不要假定它们就是原样报错。
- 核对地址与端口。确认
server没有多余空格，port与服务端提供的 UDP 端口一致。如果服务端提供端口跳跃，使用ports的范围格式，并确认当前客户端内核支持对应写法。 - 核对密码。认证失败优先重新复制密码，检查 URI 中的特殊字符是否经过编码，YAML 中是否被引号、冒号或井号破坏。不要把 obfs 密码误填到
password。 - 核对 SNI 和证书。
sni应保留服务端证书域名；只有在你明确知道证书校验问题来源时，才临时对比skip-cert-verify: true，测试完成后立即恢复为false。 - 排查 DNS。先用系统 DNS 解析节点域名，再在客户端日志中观察解析结果。若临时将
server改成 IP，sni仍然保留原证书域名；如果改成 IP 后仍失败，问题可能在 UDP、端口、密码或服务端状态，而不是 DNS。 - 排查 UDP 和防火墙。Windows 先检查 Clash Verge Rev 的 TUN 服务模式和防火墙放行；macOS 在“系统设置—隐私与安全性”中处理应用放行或解除隔离；Linux 检查专用用户是否有权读取配置文件，以及服务是否具备创建 TUN 设备的权限。先关闭 TUN，只开启系统代理做最小变量测试。
- 最后处理 MTU。在 Clash Verge Rev 的 Settings 或设置页进入 Tun Mode，找到 MTU 设置，从当前值逐步下调，每次只改一个变量，并使用同一目标复测。若关闭 TUN 后系统代理正常、开启 TUN 后失败，优先比较 TUN 权限、MTU、DNS 劫持和路由设置。
验证节点时，不要只看延迟测试。应同时确认代理页面中选中了正确策略组、日志显示请求命中该策略、目标应用可以建立连接，并对比代理前后的出口 IP。Mihomo API 文档也说明，节点延迟测试与当前代理组选择是不同操作，延迟通过不等于所有业务流量都已使用该节点。Mihomo API 文档
Windows、macOS、Linux 的权限差异
- Windows：只做浏览器测试时先开启系统代理；需要接管不遵循系统代理的应用，再启用 TUN。若内核启动失败或 TUN 无法创建，检查服务模式是否已安装、Windows 防火墙是否拦截，以及客户端是否以所需权限运行。
- macOS：首次运行或更新后，如果系统提示应用被阻止，在“系统设置—隐私与安全性”中允许运行；TUN 或系统扩展相关提示也要按系统弹窗完成放行。只为验证 Hysteria2 节点时，可以先关闭 TUN，避免把权限问题误判成节点问题。
- Linux：确认运行 Clash Verge Rev 的专用用户可以读取配置文件、规则文件和订阅缓存，并有创建 TUN 或访问相关网络设备的权限。若通过 systemd 启动，不要只检查图形界面状态，还要查看服务日志和实际运行用户。
三种系统都建议采用同一顺序：订阅或独立节点导入成功 → 手动选择节点 → 系统代理测试 → 查看日志与出口 IP → 最后再启用 TUN 和复杂规则。
常见误区速查
- 能导入不等于能连接：导入只说明 YAML 或 URI 被解析，真正连接还需要地址、端口、UDP、密码、SNI 和服务端状态全部匹配。
- 测速通过不等于应用可用：测速请求可能使用单独的测试地址，实际应用还会受到规则、DNS、TUN 路由和 MTU 影响。
- 不要一开始改很多字段：先保留最小模板，确认基础连接后再添加带宽、端口跳跃、混淆、DNS 覆写或 TUN 配置。
- 不要把服务端配置直接当客户端配置：服务端的 listeners、证书路径和用户列表属于入站配置，客户端只需要使用服务端提供的连接参数。
常见问题
Clash Verge Rev 支持 Hysteria2 吗？
可以。Clash Verge Rev 官方 README 说明客户端内置 Clash.Meta（mihomo）内核，而 Mihomo 文档提供了 Hysteria2 出站代理配置。实际能否连接还取决于订阅内容、节点参数、UDP 网络和服务端配置。
Hysteria2 节点能导入但一直超时怎么办？
先关闭 TUN，只开启系统代理；然后按 server、UDP 端口、password、sni、证书校验的顺序核对。若域名解析异常，再临时把 server 改成 IP 测试，但 sni 仍保留证书域名。
up 和 down 不知道怎么填，可以留空吗？
可以先留空进行基础连接验证。Mihomo 文档说明 up/down 用于 Hysteria2 的带宽设置，单位默认是 Mbps；连接稳定后再按实际可用带宽填写并对比，不要把宣传带宽直接当成本地上行或下行速度。
Hysteria2 配置里的 obfs 应该写什么？
只有服务端明确启用混淆时才填写，并确保混淆密码一致。公开的 Mihomo Hysteria2 文档列出 salamander 等字段；不要照抄其他项目或其他内核中未在当前 Mihomo 文档确认的类型和参数。
开启 TUN 后不能连接，关闭 TUN 却正常，问题在哪里？
优先检查系统权限、TUN 服务模式、DNS 劫持、路由和 MTU。Windows 检查服务和防火墙，macOS 检查隐私与安全性中的放行，Linux 检查运行用户、配置文件权限和 TUN 设备权限。每次只改一个设置后复测。