マルチパス

mqvpn は Multipath QUIC を使用して、複数のネットワークパスで同時にトラフィックを転送します。これにより以下が可能になります：

シームレスなフェイルオーバー — あるパスがダウンしても、残りのパスでトラフィックが継続します。切り替え中に短い遅延が発生する場合があります。
帯域集約 — 複数インターフェースの帯域幅を組み合わせます（例: WiFi + LTE）。複数の同時フローがある場合に最も効果的です。単一の TCP フローではフローピンにより帯域集約の効果が限定される場合があります。

マルチパスのセットアップ

CLI

--path で各ネットワークインターフェースを指定します：

bash

sudo ./build/mqvpn --mode client --server 203.0.113.1:443 \
    --auth-key <key> --path eth0 --path wlan0

設定ファイル

ini

[Multipath]
Scheduler = wlb
Path = eth0
Path = wlan0

TIP

--path フラグや Path エントリを指定しない場合、mqvpn はデフォルトインターフェースを使用します（シングルパスモード）。

スケジューラ

スケジューラはパケットをパス間でどのように分配するかを決定します。mqvpn は2つのスケジューラをサポートしています：

WLB（Weighted Load Balancing）— デフォルト

WLB は、パス重み付けとフロー考慮スケジューリングを組み合わせた方式です：

ロス率・RTT・cwnd などの実測値から各パスの推定スループットを算出し、トラフィック分配比率として使用
deficit ベースの WRR でアクティブなパスへトラフィックを分配
VPN トンネル内の並び替えを抑えるため、内部 TCP フロー（flow hash）をパスにピン留め
ピン留め先が一時的に cwnd ブロックされた場合は、恒久的な再ピン留めなしで spillover
非 Datagram 系パケットや、有効なスケジューラ対象パスがない場合は MinRTT にフォールバック

bash

--scheduler wlb

MinRTT（Minimum Round-Trip Time）

MinRTT は各パケットを現在の RTT が最も低いパスで送信します。よりシンプルですが、利用可能な帯域幅を効率的に活用できない場合があります。

レイテンシを最適化（スループットより優先）
シンプルなアルゴリズム、予測可能な動作

bash

--scheduler minrtt

どのスケジューラを使うべきか？

シナリオ	推奨
一般的な用途、帯域集約	WLB
レイテンシ重視のアプリケーション	MinRTT
非対称パス（異なる速度）	WLB
同程度の速度のパス	どちらでも可

動的パス管理

libmqvpn API では、VPN の実行中にパスを追加・削除できます。これはモバイル環境でネットワークインターフェースが動的に変化する場合に有用です（例: LTE 接続中に WiFi に接続）。

ライブラリレベルでは、プラットフォームが mqvpn_client_add_path_fd() を使用して新しい UDP ソケットをパスとして追加し、パスマネージャがライフサイクルを自動的に管理します。パスが削除される（インターフェースがダウンする）と、トラフィックは残りのパスにシームレスに移行します。

標準 CLI では、起動時に --path フラグでパスを指定する方式です（実行中のインターフェース監視による自動追加/削除は未実装）。起動時に登録済みの複数パスがある場合は、障害時に残りのパスへフェイルオーバーします。

パスの重み付け

WLB はトランスポートの実測値からパス重みを自動更新します。手動で重みを設定する必要はありません。

仕組み：

ロス率・RTT・cwnd から各パスの推定スループットを算出し、パス間のトラフィック分配比率（重み）として使用します
deficit WRR が、その重みに基づいてパケット/フローの割り当てを行います
既存の TCP フローピンは再利用され、アイドル・高ロス・パス障害時にはエントリを破棄します
ラウンド境界やパス復帰イベントで重み/deficit を更新します

これにより、非対称パス（例: 300 Mbps 有線 + 80 Mbps 無線）が手動チューニングなしで効率的に活用されます。

仕組み

┌─────────────────┐                          ┌─────────────────┐
│   Application   │                          │    Internet     │
├─────────────────┤                          ├─────────────────┤
│   TUN (mqvpn0)  │                          │   TUN (mqvpn0)  │
├─────────────────┤                          ├─────────────────┤
│  MASQUE         │    HTTP Datagrams        │  MASQUE         │
│  CONNECT-IP     │◄──(Context ID = 0)──────►│  CONNECT-IP     │
├─────────────────┤                          ├─────────────────┤
│  Multipath QUIC │◄── Path A (eth0)  ──────►│  Multipath QUIC │
│                 │◄── Path B (wlan0) ──────►│                 │
├─────────────────┤                          ├─────────────────┤
│  UDP (eth0/wlan)│                          │   UDP (eth0)    │
└─────────────────┘                          └─────────────────┘
     Client                                      Server

各パスは特定のネットワークインターフェースにバインドされた個別の UDP ソケットです。Multipath QUIC が QUIC レイヤーでパスを管理し、サーバーからは複数のパスを持つ単一の QUIC 接続として認識されます。

ベンチマーク

非対称デュアルパス環境（300 Mbps + 80 Mbps、netem によるエミュレーション）でのフェイルオーバーおよび帯域集約の計測結果は、ベンチマークレポートを参照してください。

プロトコル標準

プロトコル	仕様
MASQUE CONNECT-IP	RFC 9484
HTTP Datagrams	RFC 9297
QUIC Datagrams	RFC 9221
Multipath QUIC	draft-ietf-quic-multipath
HTTP/3	RFC 9114

マルチパス ​