環境
- Linux(CachyOS 6.18.2-3-cachyos)
- Docker 29.1.3
- VSCode 1.107.1
- ルーター：OPNsense 25.7.6 (上位ルーターあり)
- DNS：OPNsense内のUnbound DNS
- VXLAN利用により実効MTU1450
発生した現象
- Dev Containers内にだけVSCode拡張機能のインストールが失敗する
- GUIで具体的なエラーなどは出ずに拡張機能のインストールの終わらない状態が続く
一方で、以下の場合では成功
- ホスト側の通常VSCode
- Wi-Fi接続の場合 (上位ルーター直)
- 別PC Windows+VPN+OPNsense内Unbound DNS
切り分け
最初はDNS、ファイアウォールやIPv6を疑いましたが、Windows + VPNでも成功するためDNS や OPNsense 自体は原因ではないと判断しました。
失敗するのは 「Linux + Docker + Dev Containers + 特定ネットワーク経路」だけという点に注目しました。
原因
DockerブリッジのMTUを確認したところ1500でした。そのため、ネットワークの実効MTUとの不整合によりDev Containerの通信のみが失敗していたようです。
$ ip link show
# 該当出力
4: docker0: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc noqueue state DOWN mode DEFAULT group default
解決策
ネットワークに合わせてMTUを1450にすることで正常に拡張機能のインストールが完了するようになりました。
/etc/docker/daemon.json (デフォルトでは存在しないため新規作成)
{
"mtu": 1450
}
Docker再起動
sudo systemctl restart docker.service
確認
MTUが1450になっていれば設定変更が成功しています。
$ ip link show
# 該当出力
4: docker0: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1450 qdisc noqueue state DOWN mode DEFAULT group default
この状態でDev Containerに接続し、拡張機能が正常にインストールされれば完了です。
おわりに
何らかの理由でMTUを変更している場合には同じ問題にハマる可能性がありそうです。あまり多くはないパターンかもしれませんが、Dev Containersだけ通信が不安定な場合、DNSやFirewallを疑う前にDockerブリッジのMTUを確認する価値がありそうです。