悲しいことにlocalhostが壊れてしまいました。
VPNに繋がないとlocalhostにアクセスできない謎の現象に悩まされてました。
発生するバグの再現手順と症状
以下の手順を踏むと、確定でDockerのlocalhostが壊れます。(わざと壊して検証済み)
-
.wslconfigでnetworkingMode=mirroredがオンになっている。 - この状態で
docker compose up等でコンテナを起動する。 - Windows側でL2TP VPNをオンにする。
- その後、L2TP VPNをオフにする。
その結果VPNオフ状態では、localhostと127.0.0.1にアクセスが不可能になります。
解決策:mirrored networking を無効化して再起動する
このバグに遭遇した場合、.wslconfig の mirrored設定をオフにしてNATに戻し、再起動するのが一番簡単です。
手順1. .wslconfig の修正
Windows側の C:\Users\<ユーザー名>\.wslconfig を開き、mirrored をコメントアウトしましょう
[wsl2]
# networkingMode=mirrored
手順2. PCを再起動
設定を変更したら、Windowsを再起動してください。
VS Code や Docker Desktop が裏で WSL を掴んだままになっていると設定が完全に反映されないため、PCごと再起動してしまうのが最も確実で手っ取り早いです。
手順3. コンテナの再起動
再起動後、Docker Desktop が立ち上がったら、再度コンテナを起動します。
docker compose up -d --build
これで、VPNのオンオフに関わらず localhost 経由のアクセスが正常に行えるようになります。
まとめ
- WSL2 の
mirroredモード有効時に L2TP VPN のオン/オフを行うと、docker経由のlocalhostが完全に壊れる。 - 壊れるとVPNオフ状態ではlocalhost(v4/v6両方) にアクセス不能になる。
- 確実な解決策は
networkingMode=mirroredをやめて、素直にPCを再起動すること。
Docker環境でVPN使用後に突然ローカルサーバーに繋がらなくなった方は、まず.wslconfigの設定を疑ってみてください。
ちなみに、mirroredオプションをオフの状態でL2TP VPNのオンオフを繰り返してもlocalhostが壊れることはありませんでした。
mirroredオプション、WindowsとWSLのIPを統一できて便利なんですけどまだ不安定ですね...
