文档 配置 MASQUE

MASQUE

基于 QUIC MASQUE 标准的代理协议,常见于配合 usque 工具接入某些运营商网络,支持 quic/h2/h3-l4proxy 三种网络模式。

配置示例

config.yaml YAML
proxies:
  - name: "masque"
    type: masque
    server: server.com
    port: 443
    private-key: BASE64_ENCODED_PRIVATE_KEY
    public-key: BASE64_ENCODED_PUBLIC_KEY
    ip: 172.16.0.2/32
    ipv6: fd00::2/128
    mtu: 1280
    udp: true
    # congestion-controller: bbr

配置文件里需要的密钥对,可以用社区工具 usque 生成。

字段说明

private-key / public-key必须

base64 编码的 ECDSA 私钥/公钥(公钥是服务器一侧的)。注意要去掉 PEM 头尾标识符(如 -----BEGIN PUBLIC KEY-----)和其中的换行符。

ip / ipv6可选

本地虚拟网卡的 IPv4/IPv6 地址,CIDR 格式。

mtu默认 1280

TUN 设备的 MTU 大小。

network默认 quic

三种模式:默认走原生 quic;设为 h2 对应 masque-h2;设为 h3-l4proxy 走 h3-l4proxy 模式(该模式暂不支持 UDP)。

remote-dns-resolve / dns可选

开启后强制通过 MASQUE 隧道做远程 DNS 解析,dns 字段指定解析用的服务器列表。

congestion-controller / handshake-timeout可选

congestion-controller 默认不开启,可选 bbrhandshake-timeout 握手超时时间(秒),默认 0 表示只用外层连接超时。