はじめに
WSL2のDev Container環境でVPNに接続中 mvn install を実行したら、プライベートMavenリポジトリへの接続がタイムアウト。
結論から言うと、MTU（Maximum Transmission Unit）の問題でした。
同じ沼にハマっている人の助けになればと思い、原因の切り分けから解決までの流れを残しておきます。
環境
- ホストOS：Windows（VPNはWindows側で接続）
- WSL2：Ubuntu 22.04
- Docker：28.x（WSL2内で稼働）
- IDE：Cursor（Dev Containers拡張でコンテナ起動）
症状
Dev Container内でMaven Installを実行すると、プライベートリポジトリへの接続でタイムアウトが発生。
[FATAL] Non-resolvable parent POM:
Could not transfer artifact from/to private-maven-repo
(https://private-gitlab.example.com/...):
Connect to private-gitlab.example.com:443 failed: Read timed out
原因の切り分け
ここからが本題です。VPNなしでコンテナを起動し、後からWindows側でVPN接続した状態で確認していきます。
Step 1：コンテナ内から疎通確認
$ curl -v --connect-timeout 5 https://private-gitlab.example.com
* Trying 203.0.113.10:443...
* TLSv1.3 (OUT), TLS handshake, Client hello (1):
* Connection timed out after 5000 milliseconds
TLS Client Helloを送った後にタイムアウト。接続自体はできていない。
Step 2：WSL側（コンテナの外）から確認
$ curl -v --connect-timeout 5 https://private-gitlab.example.com
* Connected to private-gitlab.example.com (203.0.113.10) port 443 (#0)
* TLSv1.3 (OUT), TLS handshake, Client hello (1):
* SSL connection timeout
TCP接続は成功しているのに、TLSハンドシェイクでタイムアウト。これがヒントでした。
Step 3：MTUの確認
# WSL側
$ ip link show eth0
2: eth0: ... mtu 1400 ...
# コンテナ側
$ docker exec <container> cat /sys/class/net/eth0/mtu
1500
VPNはパケットを暗号化のために追加ヘッダーで包むので、実際に流れるパケットサイズが元より大きくなります。MTUが大きいままだとこのオーバーヘッド分だけサイズ超過してパケットがドロップされる、というのが原因でした。
解決手順
WSL2・Docker・コンテナのMTUをすべて1200に下げることで解決しました。
VPNなしでDev Containerを起動した後、Windows側でVPN接続してから以下を実行します。すべてWSL側（コンテナの外）で実行します。
1. WSL2のMTUを下げる
sudo ip link set eth0 mtu 1200
この時点でWSLからの疎通を確認：
curl -v --connect-timeout 10 https://private-gitlab.example.com
# → TLSハンドシェイクが通るようになる！
2. DockerブリッジのMTUを下げる
sudo ip link set docker0 mtu 1200
3. コンテナを再起動する
docker restart <container-name>
4. コンテナ内のMTUを下げる
コンテナ内に ip コマンドがない場合は、nsenter でホスト側から変更できます。
PID=$(docker inspect -f '{{.State.Pid}}' <container-name>)
sudo nsenter -t $PID -n ip link set eth0 mtu 1200
5. 疎通確認
docker exec <container> curl -vk --connect-timeout 10 https://private-gitlab.example.com
# → HTTP 302が返ってくれば成功！
6. ビルド実行
docker exec -it <container> bash
cd /workspace
./mvnw install -s ./settings.xml -Dmaven.test.skip=true
# → 成功！
注意点
MTU設定は永続化されない
ip link set によるMTU変更は一時的なもののようで、以下のタイミングでリセットされるみたいです：
- WSLの再起動（
wsl --shutdown） - コンテナの再作成（Rebuild Container）
VPN経由のビルドが必要になるたびに、手順1〜4を再実行してください。
（毎回打つのは面倒なので、スクリプト化しておくと便利です。）
おしまい！