WSL on ポンコツ地方エンジニアの技術ブログ

VS Code で WSL 上の SSH の設定を使って Remote SSH で接続する

Wed, 03 Jun 2026 00:00:00 +0900

以下に Windows の bat ファイルを使って WSL の SSH クライアントを呼び出す方法が書いてあったので、やり方をまとめてみました。

https://github.com/microsoft/vscode-remote-release/issues/937#issuecomment-578416517

尚、上記のやり方だと Windows 側の設定が使えなくなります。私はそれで問題ありませんが、併用したいという場合の解決策は以下で提示されていました。

https://zenn.dev/kurusugawa/articles/vscode-remote-ssh-with-wsl

概要

VS Codeの「Remote - SSH」拡張機能はデフォルトでWindows側のOpenSSH（またはGit for WindowsのSSH）を使用するため、WSL（Linux）側に設定した ~/.ssh/config や鍵、ControlMasterなどの機能を利用することができません。

解決策は、「Windows側でダミーのバッチファイル（.bat）を作成し、その中からWSLの ssh コマンドを呼び出すようにVS Codeに設定する」という方法です。

設定手順

1. バッチファイル（`ssh.bat`）の作成

Windows　側の適当なフォルダ（例: C:\Users\ユーザー名\ssh.bat など）に ssh.bat という名前のファイルを作成し、以下の内容を記述します。

※バッチファイルを作成する際は、文字コード（エンコーディング）を 「ANSI」または「UTF-8」 で保存してください。（UTF-16だと正しく動作しない場合があります）

@echo off
C:\Windows\System32\wsl.exe bash -ic "ssh %*"

2. VS Code（Windows側）の `settings.json` の編集

次に、VS Codeが標準の SSH ではなく、今作成したバッチファイルを使用するように設定します。

Windows側でVS Codeを開きます。
Ctrl + , で設定を開き、画面右上の「設定(JSON)を開く」アイコンをクリックして settings.json を開きます。
以下の2つの設定項目を追加（または既存のものを修正）します。

{
 // 1で作成したバッチファイルの「絶対パス」を指定（バックスラッシュは2つ重ねる）
 "remote.SSH.path": "C:\\Users\\あなたのユーザー名\\bin\\ssh.bat",
 // ローカル（Windows）側での不要なサーバープロセスの立ち上げを抑制する
 "remote.SSH.useLocalServer": false
}

3. リモート接続を実行する

設定が完了したら、実際に接続を行います。

設定を確実に反映させるため、VS Codeを一度完全に閉じて再起動します。
左下の緑色のリモート接続アイコン（または F1 キーを押して Remote-SSH: Connect to Host…）をクリックします。
WSL（Linux）側の ~/.ssh/config に記載されているホスト名（例: oci-ubuntu）を選択します。
初回接続時のみ「接続先のOSプラットフォーム（Linux / Windows / macOS）」を聞かれるので、Linux を選択します。

WSL で使用しているディスクスペースを解放する

Tue, 20 Feb 2024 00:00:00 +0900

WSL 上の Ubuntu で docker を使っていたのですが、ストレージの空き容量が少なくなってきたので docker イメージを削除しても空き容量が変化しませんでした。

調べてみたところ、どうやら仮想ディスクの最適化まで行わないとディスクスペースは解放されないようです。

ただ、私の PC はストレージ容量が少なく、頻繁に Docker イメージを消して容量を確保しているため、都度コマンドを打つのは面倒ということで、スクリプト化しました。

コマンドとしては、diskpart を使う方法と、Optimize-VHD を使う方法があるみたいですが、Optimize-VHD は Hyper-V を有効化する必要があり、Windows Home では使えないということで、今回は diskpart を使うことにしました。

diskpart でスクリプトを実行する方法は以下に記載されています。

https://learn.microsoft.com/ja-jp/windows-server/administration/windows-commands/diskpart-scripts-and-examples

サンプル

まずは diskpart で実行するスクリプトを作成します（ここでは sample.txt としました）。

select vdisk file="%USERPROFILE%\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu22.04LTS_79rhkp1fndgsc\LocalState\ext4.vhdx"
attach vdisk readonly
compact vdisk
detach vdisk

file のパスは環境によって異なると思うので、以下を参考に調べてください。

https://01futabato10.hateblo.jp/entry/2022/12/02/095031

そのうえで、以下のバッチファイルを作成します。

wsl --shutdown
diskpart /s sample.txt

あとはこのバッチファイルを実行するだけで OK です。

参考 URL

WSL でディストリビューションを削除して再インストール後に起動エラーになる

Fri, 14 Jul 2023 00:00:00 +0900

スタートメニューから Ubuntu 20.04 をアンインストールして、再度 MS ストアからインストールして起動しようとしたら以下のエラーが表示されました。

Error code: Wsl/Service/CreateInstance/MountVhd/ERROR_FILE_NOT_FOUND

まず、インストールされているディストリビューションを確認します。

> wsl -l
Linux 用 Windows サブシステム ディストリビューション:
Ubuntu-20.04 (既定)

アンインストールしたはずのディストリビューションが残っていると思うので、以下のコマンドで登録を解除します。

> wsl --unregister Ubuntu-20.04

これで、再度ディストリビューションを起動すれば OK です。

参考 URL

https://www.techgaku.com/fix-ubuntu-boot-error-on-wsl-after-reinstall/

Microsoft ストア版の WSL をインストールする

Thu, 06 Jul 2023 00:00:00 +0900

WSL について、Windows のコンポーネント（組み込み）として提供されているものと、Microsoft Store で提供されているものがあるのを知りました。

きっかけは、WSL2 上の Ubuntu で systemd を使おうとしたら使えなかったことで、調べていくと WSL 自体のバージョンが 0.67.6 以降だと systemd が使えることがわかりました。

WSL 自体のバージョンは以下のコマンドで確認できるらしいのですが、

> wsl --version

私の環境ではバージョンが表示されず、コマンドの説明が表示されてしまいました。

これは、どうやら WSL のバージョンが古いのが原因らしく、最新版は Microsoft Store からインストールできるらしいと。
ここで、2022年11月に正式版としてリリースされたストア版の WSL を知り、自分が使っていたのは「Windows の機能の有効化または無効化」からインストールしたコンポーネント版で、古いプレビュー版の WSL だということを知りました。

https://qiita.com/omu_kato/items/f9a6b5a02e25f5f2a487

ストア版の WSL は普通に Microsoft Store で検索すれば見つかるので、そこでインストールするだけです。

尚、既にコンポーネント版を使っていてもストア版をインストールして使えるようですが、私の環境では Ubuntu 22.04 を起動しようとすると Error code: Wsl/Service/CreateInstance/MountVhd/ERROR_FILE_NOT_FOUND のエラーが出てしまいました。

これについては、以下を参考に WSL から Ubuntu 22.04 の登録を解除すれば直りました。

https://www.techgaku.com/fix-ubuntu-boot-error-on-wsl-after-reinstall/

参考 URL

WSL2 上の Docker コンテナに外部からアクセスする

Fri, 29 Jul 2022 00:00:00 +0900

Ubuntu で Docker を使っている場合はホストとコンテナのポートマッピングさえ行えば外部からアクセスできました。
しかし、WSL2 を使っている場合は Windows と WSL2(Ubuntu) のポートフォワーディングの設定を行わないと外部からはアクセスできません。

尚、タイトルには「Docker コンテナに外部からアクセス」と書きましたが、Windows と WSL2 の話なので、Docker は関係ありません。

環境

ホスト: Windows 10
WSL2: Ubuntu 20.04

設定方法

WSL2 の IP アドレスを調べる

まずは WSL2 上で以下のコマンドを実行し、eth0 の IP アドレスを調べます。

$ ip addr show dev eth0

または hostname -I でも調べられます。

Windows と WSL2 のポートフォワーディング設定

コマンドプロンプトまたは PowerShell で以下のコマンドを実行します。

> netsh interface portproxy add v4tov4 listenport=<ポート> connectaddress=<WSL2のIPアドレス>

これで外部からアクセス可能になります。
設定ができているか確認したい場合は以下のコマンドを実行します。

> netsh interface portproxy show v4tov4

ipv4 をリッスンする: ipv4 に接続する:

Address Port Address Port
--------------- ---------- --------------- ----------
* 5001 172.20.93.38 5001

設定を削除したい場合は以下のコマンドを実行します。

> netsh interface portproxy delete v4tov4 listenport=<ポート>

設定の自動化

WSL2 の IP アドレスは起動の度に変わるので、Windows 起動時に自動で設定するようにします。

Windows 上で WSL2 の IP アドレスを取得

PowerShell で以下を実行します。

> $IP = wsl -d Ubuntu-20.04 exec hostname -I

しかし、私の環境では複数の IP アドレスが表示されてしまいました。

> $IP
172.20.93.38 172.17.0.1 172.18.0.1

なので、以下のようにスペースで区切って最初の IP アドレスだけを取得できるようにしました。

> $IP = (wsl -d Ubuntu-20.04 exec hostname -I).split(" ")[0]

スクリプトファイルの作成と実行

以上を踏まえ、以下のようなスクリプトファイルを作成します。

$IP = (wsl -d Ubuntu-20.04 exec hostname -I).split(" ")[0]
netsh interface portproxy delete v4tov4 listenport=<ポート>
netsh interface portproxy add v4tov4 listenport=<ポート> connectaddress=$IP

あとはこれをタスクスケジューラーでログオン時に実行するようにすれば OK です。

参考 URL

WSL2 の Ubuntu で Docker を動かす

Thu, 20 Jan 2022 00:00:00 +0900

DockerDesktop が有償になったので、WSL2 の Ubuntu に Docker をインストールして動かすようにしてみました、

環境

Windows 10
Ubuntu 20.04

WSL2 および Ubuntu はインストール済みの前提です。
以下のページに書いてあるので、まだの場合は参考にしてください。

https://kuttsun.blogspot.com/2022/01/wsl2.html

プロキシ設定

環境に応じてプロキシの設定を行っておきます。

.bashrc をエディタで開き、最後に以下を追記します。

export http_proxy=http://example.com:8080
export https_proxy=http://example.com:8080
export no_proxy=任意のIPアドレス

apt のプロキシ設定

/etc/apt/apt.conf を作成して以下のように記述します。

Acquire::http::proxy "http://example.com:8080/";
Acquire::https::proxy "https://example.com:8080/";

再起動します。

$ exit

Docker のインストール

公式ドキュメントに沿ってインストールします。

$ sudo apt-get remove docker docker-engine docker.io containerd runc
$ sudo apt-get update
$ sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-release
$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
$ echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
$ sudo apt-get update
$ sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose

ユーザーを docker グループに追加

$ sudo gpasswd -a $(whoami) docker

これで docker コマンド実行時に sudo が不要になります。

docker のプロキシ設定

/etc/default/docker をエディタで開いて以下を追加します。

export http_proxy=http://example.com:8080
export https_proxy=http://example.com:8080

また、~/.docker/config.json に以下を記述します。

{
 "proxies": {
 "default": {
 "httpProxy": "http://example.com:8080",
 "httpsProxy": "http://example.com:8080"
 }
 }
}

再起動します。

$ exit

docker デーモンの起動

$ sudo service docker start

動作確認

$ docker info
$ docker run hello-world

すると、私の場合以下のエラーが表示されました。

docker: Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?.

docker デーモンが起動しているか確認します。

$ sudo service docker status
* Docker is not running

原因がわからず悩んでいたところ、以下の記事を見つけました。

https://qiita.com/neight0903/items/ef0e2170b712b194c3fc

私の場合、既に DockerDesktop はアンインストールしていました。
もともとは DockerDesktop と WSL2 を使って動かしていたのですが、今回 DockerDesktop なしで動くようにしようとしているところで、 DockerDesktop だけでなく WSL2 も一度アンインストールして最初からやり直すと上手く行きました。

docker デーモンの自動起動

このままでは WSL を起動する度に docker デーモンを手動で起動する必要がありますが、以下のページに自動起動させる方法があります。

まずは sudo service docker start をパスワードなしで実行できるように設定します。

$ sudo visudo

以下を追記します。

ユーザー名 ALL=(ALL:ALL) NOPASSWD: /usr/sbin/service docker start

あとは .bashrc に以下を追記します。

$ nano .bashrc

if [ $(service docker status | awk '{print $4}') = "not" ]; then
 sudo service docker start > /dev/null
fi

Windows と WSL2 のポートフォワーディングの設定

WSL2 上の Docker コンテナに外部からアクセスしたい場合、Windows と WSL2 のポートフォワーディングの設定が必要です。
詳細は以下の記事を参照してください。

https://kuttsun.blogspot.com/2022/07/wsl2-docker.html

参考 URL

WSL2 で GUI を表示する

Sun, 16 Jan 2022 00:00:00 +0900

Windows に Xサーバーをインストールし、WSL2 上で実行した GUI アプリを表示できるようにする方法です。

環境

Windows 10
WSL2:Ubuntu 20.04

Xサーバーのインストール

Windows にXサーバーをインストールします。私は以下のページを参考に VcXsrv を入れました。

https://rin-ka.net/windows-x-server/

他には MobaXterm も良さそうですね。

あとは、ファイアウォールの設定も許可する必要があります。
設定完了後、VcXsrv 起動時に許可を求める画面が表示されるので、そこで全て許可しました。

WSL2 側の設定

Linux ではおなじみの export DISPLAY=:0 では駄目なようで、IPアドレスを指定する必要があるみたいです。

https://odaryo.hatenablog.com/entry/2020/01/08/114846

以下のようにすれば IP アドレスを読み込んで環境変数をセットしてくれるようです。

export DISPLAY=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):0

これを毎回入力するのも面倒なので、.bashrc に書いておけば、WSL2 起動時に自動でセットされるようです。

動作確認

VcXsrv を、Disable access control にチェックを入れて起動し、WSL2 上で以下のコマンドを実行して確認します。

$ xeyes

VSCode + Remote-Containers を使う場合

WSL2 上で VSCode を実行して Remote-Containers を使う場合、WSL2 の DISPLAY の値を Retemo-Containers 側にも引き継げば、Retemo-Containers でも GUI の表示が可能です。

https://qiita.com/y-na-biz/items/af0137532e6e22802f25#%E5%8F%82%E8%80%83devcontainerjson%E8%A8%AD%E5%AE%9A%E4%B8%80%E8%A6%A7

{
	"runArgs": [
		"-e", "DISPLAY=${env:DISPLAY}",
	],

	"mounts": [
		"source=/tmp/.X11-unix/,target=/tmp/.X11-unix/,type=bind",
	],
}

参考 URL

WSL2 のインストール

Sat, 15 Jan 2022 00:00:00 +0900

WSL2 をインストールし、WSL2 上で Ubuntu を動かす方法です。

環境

Windows 10 Pro OSビルド 19042.1466

WSL2 のインストール

公式ドキュメントは以下です。

WSL のインストール

PowerShell を起動し、以下のコマンドを入力します。

> wsl --install

WSL2 にアップデート

以下にアクセスし、wsl_update_x64.msiをダウンロードしてインストールします。

https://aka.ms/wsl2kernel

WSL2 をデフォルトにする

> wsl --set-default-version 2

Ubuntu のインストール

MS Store から Ubuntu で検索してインストールするだけです。

WSL2 で動作しているか確認

> wsl --list --verbose
 NAME STATE VERSION
* Ubuntu Running 2

* が付いているのがデフォルトのディストリビューションです。 VERSION が 2 になっているので、WSL2 で動作しています。

デフォルトのディストリビューションを変更する場合は、以下のように変更します。

> wsl --set-default Ubuntu

WSL のバージョンが2でない場合、以下のようにして設定します。

> wsl --set-version Ubuntu 2

WSL on ポンコツ地方エンジニアの技術ブログ

VS Code で WSL 上の SSH の設定を使って Remote SSH で接続する

概要

設定手順

1. バッチファイル（ssh.bat）の作成

2. VS Code（Windows側）の settings.json の編集

3. リモート接続を実行する

WSL で使用しているディスクスペースを解放する

サンプル

参考 URL

WSL でディストリビューションを削除して再インストール後に起動エラーになる

参考 URL

Microsoft ストア版の WSL をインストールする

参考 URL

WSL2 上の Docker コンテナに外部からアクセスする

環境

設定方法

WSL2 の IP アドレスを調べる

Windows と WSL2 のポートフォワーディング設定

設定の自動化

Windows 上で WSL2 の IP アドレスを取得

スクリプトファイルの作成と実行

参考 URL

WSL2 の Ubuntu で Docker を動かす

環境

プロキシ設定

apt のプロキシ設定

Docker のインストール

ユーザーを docker グループに追加

docker のプロキシ設定

docker デーモンの起動

動作確認

docker デーモンの自動起動

Windows と WSL2 のポートフォワーディングの設定

参考 URL

WSL2 で GUI を表示する

環境

Xサーバーのインストール

WSL2 側の設定

動作確認

VSCode + Remote-Containers を使う場合

参考 URL

WSL2 のインストール

環境

WSL2 のインストール

WSL のインストール

WSL2 にアップデート

WSL2 をデフォルトにする

Ubuntu のインストール

WSL2 で動作しているか確認

参考 URL

1. バッチファイル（`ssh.bat`）の作成

2. VS Code（Windows側）の `settings.json` の編集