MASQUE 协议

MASQUE 是基于 HTTP/3/QUIC 思路的隧道型出站,字段包含密钥、IP、MTU、DNS 和拥塞控制。

直接结论

MASQUE 是基于 HTTP/3/QUIC 思路的隧道型出站,字段包含密钥、IP、MTU、DNS 和拥塞控制。 实际使用时先以服务商订阅为准,再确认当前客户端内核是否支持这个 type。

它代表什么

在 Clash/Mihomo 配置里,masque 用来标识这个节点、策略或分组的出站类型。GUI 里的节点昵称不一定能说明真实协议,订阅输出的 YAML 字段更可靠。

常见字段

  • type: masque
  • private-key / public-key
  • ip / ipv6
  • mtu
  • remote-dns-resolve
  • dns
  • network

适合场景

  • 订阅明确提供 MASQUE。
  • 服务端和客户端都按 MASQUE 方式部署。
  • 需要 tunnel 风格出站并明确配置 DNS/MTU。

检查重点

  • 密钥字段通常是 base64 编码,复制时不要包含 PEM 标记。
  • MTU 和 remote DNS 设置不当会导致部分网站无法访问。
  • QUIC/UDP 网络被限制时可能连接失败。

最小配置形态

proxies:
- name: "masque-node"
  type: masque
  server: server.example.com
  port: 443
  private-key: BASE64_PRIVATE_KEY
  public-key: BASE64_PUBLIC_KEY
  ip: 172.16.0.2/32
  udp: true

兼容性提醒

客户端支持会随内核版本变化。维护中的 Mihomo 系客户端通常比历史 Clash 客户端支持更多现代节点类型,但移动端和 iOS 替代客户端仍要按具体 App 与版本确认。

如果订阅里有这个 type,但客户端导入后把它过滤掉,可以换兼容客户端、向服务商索要对应格式,或在理解字段变化的前提下使用订阅转换。

官方参考

Mihomo 文档中的 MASQUE