ビルド

Linux

必要なもの

• Git
• CMake 3.10+
• Make（GNU Make）
• GCC または Clang（C11）
• libevent 2.x

INFO

初回ビルド時に BoringSSL のソースを GitHub からクローンするため、インターネット接続が必要です。

クイックビルド

./build.sh            # BoringSSL、xquic、mqvpn をビルド
./build.sh --clean    # フルリビルド

手動ビルド手順

1. BoringSSL のビルド

cd third_party/xquic/third_party/boringssl
mkdir -p build && cd build
cmake -DBUILD_SHARED_LIBS=0 -DCMAKE_C_FLAGS="-fPIC" -DCMAKE_CXX_FLAGS="-fPIC" ..
make -j$(nproc) ssl crypto
cd ../../../../..

2. xquic のビルド

cd third_party/xquic
mkdir -p build && cd build
cmake -DCMAKE_BUILD_TYPE=Release -DSSL_TYPE=boringssl \
      -DSSL_PATH=../third_party/boringssl \
      -DXQC_ENABLE_BBR2=ON ..
make -j$(nproc)
cd ../../..

3. mqvpn のビルド

mkdir -p build && cd build
cmake -DCMAKE_BUILD_TYPE=Release \
      -DXQUIC_BUILD_DIR=../third_party/xquic/build ..
make -j$(nproc)

テスト

ctest --test-dir build --output-on-failure  # C ライブラリユニットテスト
sudo ./scripts/ci_e2e/run_test.sh           # E2E（netns、root 権限必要）
sudo ./scripts/run_multipath_test.sh        # マルチパスフェイルオーバー
(cd android && ./gradlew test)              # Android SDK ユニットテスト

Windows (MSVC x64)

INFO

Windows ではクライアントのみサポートされています。サーバーは Linux 専用です。

前提条件

ツール	用途	インストール
Visual Studio 2022 Build Tools	C/C++ コンパイラ (MSVC)	winget install Microsoft.VisualStudio.2022.BuildTools（C++ ワークロードを選択）
CMake >= 3.10	ビルドシステム	winget install Kitware.CMake
Go	BoringSSL に必要	winget install GoLang.Go
NASM	BoringSSL に必要（アセンブリ）	winget install NASM.NASM
Perl (Strawberry Perl)	BoringSSL に必要	winget install StrawberryPerl.StrawberryPerl
vcpkg	libevent のインストール	git clone https://github.com/microsoft/vcpkg && .\vcpkg\bootstrap-vcpkg.bat
Git	ソース取得	winget install Git.Git

Wintun

TUN デバイスは Wintun によって提供されます。wintun.dll は Windows 実行時の必須依存です。

mqvpn 実行前に、wintun.dll を必ず配置してください：

1. Wintun 公式サイトから配布パッケージをダウンロードする
2. 展開し、x64 用の wintun.dll を mqvpn 実行ファイルのあるディレクトリ（例: build\Release\）に配置する
   または PATH に含まれるディレクトリへ配置する
3. build\Release\wintun.dll の存在、または where wintun.dll で参照できることを確認する

wintun.dll は実行時に動的ロードされるため、ビルド自体は通りますが、DLL がない状態では mqvpn クライアントは起動できません。

ビルド手順

すべてのコマンドは Developer Command Prompt for VS 2022 から実行してください：

call "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Auxiliary\Build\vcvars64.bat"

1. libevent のインストール

vcpkg install libevent:x64-windows-static

2. BoringSSL のビルド

cd third_party\xquic\third_party
git clone https://github.com/google/boringssl.git
cd boringssl
git checkout 9c95ec797c65fde9e8ddffc3888f0b8c1460fe4c

mkdir build && cd build
cmake -G "Visual Studio 17 2022" -A x64 -DBUILD_SHARED_LIBS=0 ..
cmake --build . --target ssl --config Release
cmake --build . --target crypto --config Release

3. xquic のビルド

cd third_party\xquic
mkdir build && cd build
cmake -G "Visual Studio 17 2022" -A x64 ^
  -DCMAKE_BUILD_TYPE=Release ^
  -DSSL_TYPE=boringssl ^
  -DSSL_PATH=%cd%\..\..\xquic\third_party\boringssl ^
  -DXQC_ENABLE_BBR2=ON ..
cmake --build . --config Release

4. mqvpn のビルド

VCPKG_ROOT を vcpkg のクローン先パスに置き換えてください。

mkdir build && cd build
cmake -G "Visual Studio 17 2022" -A x64 ^
  -DCMAKE_BUILD_TYPE=Release ^
  -DXQUIC_BUILD_DIR=..\third_party\xquic\build\Release ^
  -DBORINGSSL_BUILD_DIR=..\third_party\xquic\third_party\boringssl\build\Release ^
  -DCMAKE_TOOLCHAIN_FILE=%VCPKG_ROOT%\scripts\buildsystems\vcpkg.cmake ^
  -DVCPKG_TARGET_TRIPLET=x64-windows-static ..
cmake --build . --config Release

バイナリは build\Release\mqvpn.exe に生成されます。

Android

前提条件

• Android SDK（SDK コマンドラインツール、および Gradle が利用する platform/build-tools を含む）
• Android NDK（NDK r27d 以降推奨）
• JDK 17
• CMake と Ninja（または GNU Make）
• サブモジュール込みのチェックアウト（--recurse-submodules）
• third_party/xquic/third_party/boringssl に BoringSSL ソースがあること

ビルド

# 事前にシェルのプロファイル（例: ~/.bashrc）で設定
export ANDROID_HOME=/path/to/android-sdk
export ANDROID_NDK_HOME=/path/to/android-ndk
export ANDROID_NDK="$ANDROID_NDK_HOME"

# サブモジュールを取得
git submodule update --init --recursive

# BoringSSL ソースの準備
git clone https://github.com/google/boringssl.git third_party/xquic/third_party/boringssl

# ネイティブライブラリをクロスコンパイル（arm64-v8a）
scripts/build_android.sh --abi arm64-v8a

# SDK モジュール + デモアプリをビルド
(cd android && ./gradlew assembleDebug --no-daemon --stacktrace)

# Android ユニットテスト
(cd android && ./gradlew test --no-daemon --stacktrace)

モジュール構成

android/
├── sdk-native/    # JNI ブリッジ → libmqvpn_jni.so
├── sdk-runtime/   # MqvpnPoller（tick ループ）
├── sdk-network/   # NetworkMonitor、PathBinder
├── sdk-core/      # MqvpnVpnService、MqvpnManager、TunnelBridge
└── app/           # デモアプリ（Jetpack Compose）

ビルドのテストははじめにを参照してください。