[2026] MacからWindows上のWSL 2にVS Code (Remote SSH)で接続する方法
Jarvis 8月 30, 2026
TL;DR
- WSL2は仮想マシンであり、「ターミナル上のLinux」ではありません — 独自の仮想NIC、NATネットワーク、動的IPを持ちます。Macから直接SSH接続することはできません。これはバグではなく仕様です。
- ポートフォワーディング(netsh portproxy)が現在最も信頼性の高い方法です — Win10 + Win11の全ユーザー層をカバーし、NVIDIAの公式ドキュメントもこの方法を使用しています。ミラードモードは公式に推奨されていますが、インバウンドTCP/UDPに関する既知のバグ(#10535/#12065)があり、「Mac → WSL2」のユースケースでは信頼性に欠けます。
- このガイドを読み終える頃には、10分以内にMacからWSL2へSSH接続できるようになります — ステップバイステップの手順、自動起動スクリプト、レイヤー別の
connection refusedトラブルシューティングフローも完備しています。
概要
対象読者: Windowsデスクトップ(Win10またはWin11)を使用しており、日常的にはMacBookを使っている開発者で、MacからWindowsマシン上のWSL2にSSH接続してコーディングやサービスの実行を行いたい方。
「WindowsとWSL2は同じマシン上にあるのだから、SSHが動いていれば接続できるはず」と思い込んで、connection refusedに打ちのめされた人は多いでしょう。この記事は「なぜWSL2を使うのか」についてではありません。ただ一点だけに焦点を当てています: Macからどうやって接続するか、そしてオンラインで見つけたチュートリアルがなぜうまくいかなかったのか。
読み終える頃には、Shell:Startupにそのまま入れられるPowerShellの自動フォワードスクリプトを手に入れられます。これで再起動後のWSL2のIP変更に悩まされることもなくなります。