Skip to content

ネットワーク設定 ​

WSL Dashboard は、WSL 2 とホスト OS(Windows)間のネットワーク通信設定を簡素化します。ポート転送とグローバル HTTP プロキシをサポートしています。

ポート転送 (Port Forwarding) ​

WSL 2 は仮想ネットワークアダプターを使用するため、LAN 上の他のデバイスから WSL 内部のサービスにアクセスするのは通常複雑です。

  • コア機能: Windows の特定のポートを WSL インスタンス内部のポートにマッピングできます。
  • 自動ファイアウォールルール: WSL Dashboard は転送ルールの作成時に、Windows Defender ファイアウォールに必要な受信ルールを自動的に追加し、外部トラフィックが通過できるようにします。
  • 設定項目:
    • ホスト IP: 通常は 0.0.0.0(すべてのネットワークインターフェースで待ち受け)または 127.0.0.1。
    • ホストポート: Windows 側で開放するポート。
    • WSL ポート: インスタンス内部のサービスが待ち受けるポート。

グローバル HTTP プロキシ (HTTP Proxy) ​

WSL 内部でプロキシを設定する(git clone や apt install が遅い場合など)には、通常複数の設定ファイルの変更が必要です。

  • 簡単設定: WSL Dashboard はグローバルプロキシのスイッチを提供します。
  • 動作原理: 設定に基づいて、選択したインスタンスのプロキシ環境変数や関連サービスのプロキシオプションを自動的に構成し、ホスト IP を手動で取得する手間を省きます。
  • 対応プロトコル: 一般的な http:// と socks5:// プロトコルに対応。

ネットワーク状態のモニタリング ​

ネットワークパネルでは、以下をリアルタイムで確認できます:

  • WSL ホスト IP: Windows 仮想ネットワークアダプターの IP。
  • WSL インスタンス IP: インスタンス内部で実際に割り当てられたアドレス。
  • アクティブな接続: 現在有効なポート転送ルールとトラフィック状態を監視。

高度なネットワークモード (Mirrored Mode) ​

Windows 11 ユーザー向けに、WSL 2 は「ミラー」ネットワークモードをサポートしています。

  • 利点: ミラーモードでは WSL インスタンスがホスト OS のネットワークインターフェースを直接共有できるため、複雑な VPN や LAN 関連の問題の多くを解決できます。
  • 設定の提案: ミラーモードを有効にしている場合、WSL Dashboard のポート転送機能は引き続き動作しますが、ホスト IP 経由で直接サービスにアクセスする方が好ましい場合があります。

ヒント

settings.toml で auto_shutdown_distros = true を設定すると、Dashboard を閉じた後に不要なネットワーク待ち受けタスクがバックグラウンドに残らないことを保証できます。

よくある問題のトラブルシューティング ​

ポートの競合 ​

ポート転送が機能しない場合は、以下を確認してください:

  1. ホストポートが占有されていないか: netstat -ano | findstr :<ポート番号> で確認します。
  2. 管理者権限: 一部のポート(1024 未満など)は待ち受けるために管理者権限が必要な場合があります。

ファイアウォールによるブロック ​

WSL Dashboard はルールの自動設定を試みますが、サードパーティ製ファイアウォール(火绒、360 など)をインストールしている場合は、wsldashboard.exe のネットワークアクセス権限を手動で許可する必要がある場合があります。