【WSL】WSL2 ~ WSLのネットワーク設定 ~

◾️はじめに

https://dk521123.hatenablog.com/entry/2025/04/30/223554

の続き。

networkingMode=bridgedを設定したら、非推奨って言われたので
対象方法も含めて調べてみた

目次

【1】エラー「ブリッジ ネットワーク モードは非推奨になりました」が表示
 1)エラー内容
 2)対応案
【2】.wslconfig
 1)networkingMode=mirrored
 2)ignoredPorts
 3)localhostForwarding
 4)dnsTunneling

【1】エラー「ブリッジ ネットワーク モードは非推奨になりました」が表示

 WSL で開発環境を作成している際に

https://zenn.dev/euxn23/articles/7b83df39720ccb
https://qiita.com/hatt_takumi/items/0890e0103a3753a8d325

などで、以下のように設定すると、
「1)エラー内容」のように表示されて設定できない
 => ブリッジネットワークモードは将来削除されるとして
 2.4.5(24年12月リリース)から非推奨なったらしい

C:¥Users¥[UserName]¥.wslconfig

[wsl2]
networkingMode=bridged
vmSwitch=External
dhcp=true

1)エラー内容

wsl: ブリッジ ネットワーク モードは非推奨になりました。
サポートされているネットワーク モードの詳細については、
https:://aka.ms/wslnetworking を参照してください

2)対応案

* 代わりに「networkingMode=mirrored」を使う
 => 詳細は、「【2】.wslconfig」の
  「1)networkingMode=mirrored」を参照の事

【2】.wslconfig

* .wslconfig に関して、以下の公式ドキュメントを参照

https://learn.microsoft.com/ja-jp/windows/wsl/wsl-config#wslconfig

* 以下の公式ドキュメントを参考にするといいかも

https://learn.microsoft.com/ja-jp/windows/wsl/networking

1)networkingMode=mirrored

* Windows側のipアドレスと、WSL2側のipアドレスを一致させるモード

https://learn.microsoft.com/ja-jp/windows/wsl/networking#mirrored-mode-networking

C:¥Users¥[UserName]¥.wslconfig

[wsl2]
networkingMode=mirrored

2)ignoredPorts

* フォワーディングを無視する(フォワーディングしない)
* wsl2.networkingMode が mirrored に設定されている場合にのみ適用可能

C:¥Users¥[UserName]¥.wslconfig

[wsl2]
networkingMode=mirrored

[experimental]
ignoredPorts=8080,18080

3)localhostForwarding

* WSL 2 VM でワイルドカードまたは localhost にバインドされたポートに、
 localhost:port 経由でホストから接続できるかどうかを指定するブール値
* Default: true

4)dnsTunneling

* WSL から Windows への DNS 要求のプロキシ方法を変更
* Default: true

参考文献

https://zenn.dev/roymccrain/articles/5d22f968088312
https://zenn.dev/tazzae999jp/articles/64218cb9c75b27

関連記事

WSL2 ~ 基本編 ~
https://dk521123.hatenablog.com/entry/2023/01/29/000000
WSL2 ~ Docker-CE / 環境構築編 ~
https://dk521123.hatenablog.com/entry/2021/11/14/224428
WSL ~ Docker-CE + Genie / 環境構築編 ~
https://dk521123.hatenablog.com/entry/2021/11/03/003836
Terminal ~ Cmder ~
https://dk521123.hatenablog.com/entry/2023/12/27/002919