WSL Manager へようこそ 👋

English | 简体中文 | 繁體中文 | Deutsch | Español | 日本語 | Magyar | Português | Türkçe

_{画面は Windows 版 · 同じアプリが macOS ではネイティブ VM を動かします — 下の macOS での画面 を開いてください}

WSL Distro Manager は、Windows Subsystem for Linux のための、そして macOS ではネイティブな Linux VM のための、無料でオープンソースの GUI です。wsl.exe のオプションを 1 つも覚えることなく、WSL ディストリビューションのインストール、 コピー、名前変更、移動、バックアップ、削除ができます。さらにテンプレート、保存 したコマンドスニペット、ディスクのマウント、.wslconfig の編集、SSH 経由の リモート WSL、そして AI エージェントに WSL 環境を操作させる MCP サーバーも備え ています。Mac ではまったく同じアプリが、代わりに Apple の Virtualization フレームワークで仮想マシンを管理します。

🚀 機能

ディストリビューションの管理

• 組み込みのカタログからインストール、または自前の rootfs を持ち込み
• インスタンスのコピー、名前変更、別ドライブへの移動、バックアップ、削除
• すべてのインスタンスを 1 つのフォルダーにバックアップし（内容の一覧付き）、別の PC で復元
• 仮想ディスクを圧縮し、WSL が決して返さない領域を取り戻す
• インスタンスが今使っているもの（CPU 時間・メモリ・スワップ）をライブグラフで確認
• Ubuntu、Debian、Alpine、Kali Linux、openSUSE、SLES など、WSL が受け付けるものすべてに対応

インスタンスをより速く動かす

• 任意の Docker イメージをディストリビューションとして利用 —— Docker 自体は不要
• 設定済みのディストリビューションを、どのマシンにでもインストールできる可搬な .wsl ファイルとしてパッケージ化（テンプレートはこれに置き換えられ非推奨）
• Turnkey Linux やその他の LXC コンテナ（実験的）
• スニペット: セットアップ用のコマンドをアプリ内に保存し、任意のインスタンスで実行
• 自分の rootfs イメージリポジトリをアプリに指定
• ディストロのファイルを一覧し、選んだものを別のインスタンスにコピー — 共有もマウントもエクスプローラーも不要

ファイルを手で編集せずに設定

• ディストリビューションごとの systemd、automount、既定ユーザー、起動コマンド、起動パス
• メモリ、プロセッサ、スワップ、ネットワークモード、DNS など .wslconfig の設定一式
• 物理ディスクや VHD を WSL にマウント（パーティションとファイルシステムも指定可能）
• ホストのフォルダーを任意のマウントポイントでディストロや VM に共有（読み取り専用も可）— AI Workspace でも利用可能

いつものやり方のままで

• Windows ターミナル、VS Code、エクスプローラーをディストリビューション内で直接開く
• すべてのインスタンスを Windows ターミナルのメニューに表示し、アプリの実行中は最新に保つ — 専用のフラグメントとして追加されるため、ターミナルの設定は変更されません
• 別の Windows マシン上の WSL を SSH 経由で管理
• ネットワーク上の 2 台のマシン間でディストリビューションを同期
• インスタンスに名前で接続: ホスト名が hosts ファイルに保たれるので、再起動後も ssh ubuntu.wsl が使えます
• 自動で最新に保つ: ウェブサイト版と GitHub 版は新しいリリースを自分でダウンロードしてインストールする（ストア版はストアが更新）
• ダーク／ライトテーマ、9 言語に対応

macOS では: ネイティブな仮想マシン (ベータ)

• 同じアプリが WSL の代わりに Apple の Virtualization フレームワークで VM を管理
• インストーラー ISO、クラウドイメージ、エクスポートしたテンプレートから Linux VM を作成
• リストアイメージから macOS ゲスト VM を作成（Apple シリコン）
• ディストリビューションと同じように VM を起動、停止、複製、エクスポート／インポート、テンプレート化
• 自動プロビジョニングされた SSH（cloud-init）経由で、GUI・AI チャット・MCP クライアントから VM 内のコマンドを実行
• 一覧の行からどの VM でも端末を開ける: Linux でも macOS ゲストでも SSH セッション、Linux で接続先がないときはシリアルコンソール
• 自分の ~/.ssh 鍵がすべての Linux VM で許可される（鍵がなければ作成される）ので、素の ssh user@vm-ip も使える
• どの VM にもログインパスワードが割り当てられ、その行から読み出せる。VM 自身の画面でサインインするために使う
• すべての SSH 経路がどのアカウントでサインインするかを同じ行から設定できる。macOS ゲストの名前は設定アシスタントで入力され、アプリからは見えないため
• scripts/build_macos.sh でビルド —— 署名済みの vmctl ヘルパーを同梱する

Pro （買い切り: Windows は Microsoft Store、macOS とストア外インストールは wslmanager.com/buy のライセンスキー —— サブスクリプションではありません）

• AI Workspace —— 専用に隔離された WSL ディストリビューションで Hermes Agent、OpenClaw、Open WebUI、OpenCode を実行
• すべての AI ツールに共通のモデルとエンドポイント —— 設定にあるアシスタントの API エンドポイント、キー、モデルを OpenCode、OpenClaw、Hermes もそのまま使う。一度設定するだけで、後からインストールしたツールにも引き継がれる
• ツールを持つ AI アシスタント —— 組み込みチャットが実際に WSL を操作できる。MCP サーバーが公開するのと同じツールを使って、ディストリビューションの一覧表示と調査、コマンド実行、設定の編集、スニペットの作成、ディスクのマウント、パッケージ化を行う
• インスタンスを変更した AI の実行はすべてスニペットとして保存 —— 実行したコマンドと各ツールの報告内容を記録し、チャットからリンクされるので、後から確認したり、新しいインスタンスで再実行したり、共有したりできる
• サンドボックス AI —— 使い捨ての Ubuntu ディストリビューションを立ち上げ、AI チャットにそのサンドボックスの内側だけへのアクセスを与える
• タスクキュー —— やることリストを渡せば、アシスタントが順に片付けてチェックを付けていく
• MCP サーバー —— Claude Desktop、Claude Code、opencode などの MCP クライアントに WSL を公開
• Web ダッシュボード —— スマートフォンや別のコンピューターからすべてを管理。QR コードを読み取ればブラウザーでアプリ全体が使え、必要なら Cloudflare トンネルでネットワークの外にも公開できる

AI 機能はあなた自身が用意した資格情報 —— あなた自身の OpenAI 互換 API キー —— で動きます。AI サービスをホストすることも同梱することもなく、利用枠もなく、 リクエストが誰かのサーバーを経由することもありません。Pro が解除するのはアプリ 内の機能であって、AI のクレジットを買うものではありません。 Free vs Pro を ご覧ください。

そもそもなぜ有料版があるのか？ WSL Manager は 2021 年から続く、一人が余暇に 作っているプロジェクトで、上に挙げた機能は —— 無料のものも含めて —— すべて夜と 週末に書かれました。ディストリビューションと VM の管理は無料で、これからも無料 です。アプリ全体もオープンソースのままです。Pro はその上に乗る AI レイヤーであり、 そこから得られるものが、保守と新機能を「余った時間でやること」から「計画された 定期的な仕事」へと変えてくれます。一度買えばずっと使えて、次のリリースを直接 支えることになります。

🤖 AI アシスタントと MCP (Pro)

このセクションの内容はすべて Pro のものです。無料版にはひとつも含まれません。

AI アシスタントは単なるチャット欄ではなくエージェントです。MCP サーバーが公開 するのと同じツール一式を渡されているので、「どんなディストリビューションがある？」 「Ubuntu を入れて既定ユーザーを設定して」と頼めば、推測ではなく実際のツールを あなたの WSL に対して呼び出します。ツール呼び出しは作業中にその場で表示されます。

プロバイダーの設定は 設定 → Bring Your Own AI Key で行います。OpenAI 互換の エンドポイントであれば何でも使えます（OpenAI、Azure、LiteLLM プロキシ、Ollama、 LM Studio など）。ベース URL、キー、モデルを入力してください。モデル一覧を読み込む ボタンはプロバイダーの /models からオートコンプリートを埋め、接続テストは チャットを開く前に資格情報が有効であることを確かめます。

どれも要らない場合は 設定 → Bring Your Own AI Key → AI 機能 をオフにしてください。アシスタント、エラー診断、AI Workspace が無効になり、AI 関連のものは何も表示されず、ワークスペース環境も自動では用意されません。回答するまではオフのままで、WSL Manager はインストールまたは更新後の最初の起動時に一度だけ確認します。それまでは AI 関連のものは何も動きません。

サンドボックス（AI Workspace → サンドボックスディストリビューションを追加）は、 任意のカタログイメージ（既定では最新の Ubuntu）から使い捨てのインスタンスを作ります。 Windows では WSL ディストリビューション、macOS ではクラウドイメージを元にした Linux VM が、作成され起動されます。そのチャットに渡されるのは sandbox_* ツールだけで、 これらはその 1 つのインスタンスに固定されています —— モデルはサンドボックスの内側 では何でもできますが、ホストや他のインスタンスを見ることは決してできません。正直に 言えば 1 つだけ注意があります: サンドボックス自体は、他のディストリビューションや VM と同様に通常どおり外向きのインターネット接続を持ちます。サンドボックスのチャットは アシスタントと同じドッキングパネル（タスクキューを含む）を使い、その履歴は保存され、 チャットヘッダーの履歴ボタンでアシスタントと各サンドボックスセッションを切り替えられ ます。

タスクキュー —— チャット上部のタスクセクションを開き、項目を追加して ▶ を押します。 アシスタントはツールを使って順に処理し、終わるたびにチェックを付けます。実行中でも タスクを追加できます。

外部 AI クライアントの接続（MCP）

設定 → MCP サーバー（Pro）をオンにします。http://127.0.0.1:59133/mcp で MCP プロトコルを提供し、ループバック専用で、同じパネルに表示されるベアラートークンで保護 されます。ツールはライフサイクル全体をカバーします —— ディストリビューションの作成、 インポート、設定、実行、パッケージ化、そして（確認フラグ付きで）登録解除に加え、 スニペット、ディスクのマウント、永続的なターミナルセッションです。

Claude Desktop —— MCP パネルの Claude Desktop に接続 をクリックします。下の エントリを claude_desktop_config.json に書き込んでくれます（Node.js が必要）。その後 Claude Desktop を再起動してください。手動で行う場合や、他の stdio MCP クライアントの 場合は、mcp-remote で HTTP エンドポイント をブリッジします:

// claude_desktop_config.json  (%APPDATA%\Claude\)
{
  "mcpServers": {
    "wsl-manager": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "http://127.0.0.1:59133/mcp",
        "--header", "Authorization:${AUTH_HEADER}"
      ],
      "env": { "AUTH_HEADER": "Bearer <TOKEN FROM THE MCP PANEL>" }
    }
  }
}

Claude Code —— 同じブリッジを、コマンド 1 つで:

claude mcp add wsl-manager -- npx -y mcp-remote http://127.0.0.1:59133/mcp \
  --header "Authorization: Bearer <TOKEN>"

opencode —— opencode.json（または ~/.config/opencode/opencode.json）の mcp の下に追加します:

{
  "mcp": {
    "wsl-manager": {
      "type": "local",
      "command": ["npx", "-y", "mcp-remote", "http://127.0.0.1:59133/mcp",
                  "--header", "Authorization: Bearer <TOKEN>"]
    }
  }
}

ストリーミング HTTP を話す MCP クライアントであれば、mcp-remote を挟まずに Authorization: Bearer <TOKEN> ヘッダーを付けてエンドポイントへ直接つなぐこともできます。 別のマシンから到達したい場合は、同じパネルで組み込みの Cloudflare トンネル を有効に して、表示された公開 URL を使ってください。

📱 Web ダッシュボード (Pro)

設定 → Web ダッシュボード（Pro）をオンにすると、アプリはネットワーク上のあらゆる デバイス向けに、ポート 59134 でブラウザーダッシュボードを提供します —— Windows でも macOS でも同じです。パネルに表示される QR コードをスマートフォンで読み取る（またはリンク をコピーする）と、ブラウザーでアプリ全体が使えます: インスタンスの起動・停止・複製・削除、 コマンドの実行、永続的なターミナルセッションの利用、保存したスニペットの実行、そして 生成されたフォームによるその他すべてのツール（インポート、エクスポート、パッケージ化、 .wslconfig、ディスク、VM 作成）の操作です。AI アシスタントや MCP サーバーが使うのと 同じツール一式です。

アクセスはリンクに含まれるトークン（?token=…）で守られているため、QR コードを読み取る だけでデバイスは接続できます。パネルでトークンを再生成すれば、それまでに配ったリンクは すべて無効になります。ダッシュボードは意図してすべてのインターフェースで待ち受けます。 外出先で必要なときは、同じパネルの Cloudflare トンネルで公開 を切り替えると、一時的な 公開 HTTPS リンクが得られます（QR コードもそちらに切り替わります）。公開したあとは、 コマンドを実行できる画面を守るのはトークンだけになるので、そのリンクの共有には注意して ください。

📦 インストール

brew install --cask wsl-manager

winget install Bostrot.WSLManager

scoop install extras/wsl2-distro-manager

choco install wsl2-distro-manager

⚙️ ビルド

flutter がインストールされていることを確認してください。

Windows

flutter config --enable-windows-desktop
flutter upgrade

flutter build windows # build it
flutter run -d windows # run it

macOS

VM を作るのは Flutter アプリ本体ではなく、Virtualization.framework を操作する小さな Swift ヘルパー vmctl です。このフレームワークは com.apple.security.virtualization の entitlement を持つプロセスにしか応答せず、swift build はそれを付けません。 つまり アプリが VM を起動できるようになる前に、ヘルパーをビルドして署名しておく 必要があります:

flutter config --enable-macos-desktop

# Build + sign vmctl and install it for dev runs. Re-run after any change
# under macos/vmctl/ — `flutter run` never rebuilds the helper.
VMCTL_ONLY=1 scripts/build_macos.sh

flutter run -d macos

この手順を飛ばしてもアプリ自体は問題なく起動しますが、VM の起動は次のエラーで失敗します:

VM failed to start: Error Domain=VZErrorDomain Code=2 "The process doesn't
have the "com.apple.security.virtualization" entitlement."

entitlement が足りないのはアプリではなくヘルパーです —— Runner 自身の entitlement はすでに正しく設定されています。署名済みのヘルパーは ~/Library/Application Support/WSLManager/bin/vmctl にインストールされ、デバッグ実行は そこを見ます。これがないと macos/vmctl/.build/ にある未署名の swift build の出力に フォールバックし、上のエラーが出ます。

VMCTL_ONLY なしで scripts/build_macos.sh を実行すると、同じ署名を行ったうえで リリース版アプリをビルドし、署名済みヘルパーをバンドルの Contents/Resources/ に同梱 します。アプリ自体のビルドには完全版の Xcode が必要です。

著者

👤 Eric Trenkel

• ウェブサイト: erictrenkel.com
• GitHub: @bostrot
• LinkedIn: @erictrenkel

👥 コントリビューター

🤝 コントリビューション

コントリビューション、Issue、機能リクエストを歓迎します！
Issue ページもぜひご覧ください。 コントリビューションガイドも参考になります。

サポートを示す

このプロジェクトが役に立ったら ⭐️ をお願いします！

📝 ライセンス

Copyright © 2026 Eric Trenkel.
このプロジェクトは GPL-3.0 ライセンスです。

お探しのものが見つかりませんでしたか？ Wiki をご覧ください