WSL での詳細設定の構成

wsl.confファイルと.wslconfig ファイルは、WSL VM の起動時に適用される WSL の詳細設定を構成するために使用されます。 wsl.conf は WSL ディストリビューションごとに設定を適用するために使用され、 .wslconfig は WSL にグローバル設定を適用するために使用されます。 相違点の詳細については、以下を参照してください。

現在、すべての .wslconfig 設定は WSL 2 ディストリビューションにのみ適用されます。 実行している WSL のバージョンを確認する方法について説明します。

構成変更の 8 秒ルール

Linux ディストリビューションを実行しているサブシステムの実行が完全に停止し、構成設定の更新が表示されるまで再起動するまで待つ必要があります。 通常、これはディストリビューション シェルのすべてのインスタンスを閉じてから約 8 秒かかります。

ディストリビューション (たとえば、Ubuntu など) を起動し、構成ファイルを変更し、ディストリビューションを終了してから再起動すると、構成の変更が直ちに有効になると思われるかもしれません。 現在は、サブシステムがまだ実行されている可能性があるため、そのようにはなりません。 変更が取得されるのに十分な時間を確保するため、再起動する前に、サブシステムが停止するまで待つ必要があります。 PowerShell で wsl --list --running コマンドを使用して、閉じた後も Linux ディストリビューション (シェル) がまだ実行されているかどうかを確認できます。 ディストリビューションが実行されていない場合は、"実行中のディストリビューションがありません" という応答を受け取ります。これで、ディストリビューションを再起動して、構成の更新が適用されているのを確認できるようになります。

コマンド wsl --shutdown は WSL 2 のディストリビューションを再起動するための高速パスですが、実行中のすべてのディストリビューションがシャットダウンされるため、適切に使用してください。 wsl --terminate <distroName> を使用すると、現在実行中の特定のディストリビューションを即座に終了することもできます。

wsl.conf

WSL 1 または WSL 2 で実行されている Linux ディストリビューションごとにディストリビューション別 wsl.conf でローカル設定を構成します。

• UNIX ファイルとしてディストリビューションの /etc ディレクトリに格納されます。
• ディストリビューションごとに設定を構成するために使用されます。 このファイルで構成された設定は、このファイルが格納されているディレクトリを含む特定の Linux ディストリビューションにのみ適用されます。
• WSL 1 と WSL 2 のいずれかで実行されるディストリビューションに使用できます。
• インストール済みディストリビューションの /etc ディレクトリにアクセスするには、ディストリビューションのコマンド ラインで cd / を使ってルート ディレクトリにアクセスし、その後 ls でファイルを一覧表示するか、explorer.exe . を使って Windows ファイル エクスプローラーで表示します。 ディレクトリ パスは次のようになります: /etc/wsl.conf

wsl.conf の構成設定

wsl.conf ファイルは、ディストリビューションごとに設定を構成します。 (WSL 2 ディストリビューションのグローバル構成については、.wslconfig を参照してください。)

wsl.conf ファイルでは、4 つのセクション automount、network、interop、および user がサポートされています。 "(.ini ファイルの慣習にならい、.gitconfig ファイルのように、キーはセクションの下で宣言されています。)"wsl.conf ファイルを保存する場所についての情報は、「wsl.conf」を参照してください。

systemd 対応

多くの Linux ディストリビューションでは、既定で "systemd" が実行されます (Ubuntu を含む)。 WSL では、Microsoft Storeの WSL の最新バージョンでこのシステム/サービス マネージャーがサポートされているため、WSL はベア メタル マシンでお気に入りの Linux ディストリビューションを使用するのとさらに似ています。 wsl --versionを使用して WSL のバージョンを確認します。 更新が必要な場合は、Microsoft Store で WSL の最新バージョンを入手できます。 wsl --versionが認識されない場合は、systemd を使用する前に更新する必要がある古い受信トレイ バージョンの WSL を使用している可能性があります。

systemd を有効にするには、管理者権限で sudo を使用して wsl.conf ファイルをテキストエディターで開き、/etc/wsl.conf に次の行を追加します:

[boot]
systemd=true

その後、WSL インスタンスを再起動するには、PowerShell から wsl.exe --shutdown を使用して WSL ディストリビューションを終了する必要があります。 ディストリビューションが再起動したら、systemd が実行されているはずです。 次のコマンドを使用して確認できます: systemctl list-unit-files --type=service。これにより、サービスの状態が表示されます。

自動マウントの設定

wsl.conf セクション ラベル: [[automount]]

自動マウントオプションは、自動的にマウントされたドライブすべてのマウント オプションとして適用されます。 特定のドライブのオプションのみを変更するには、代わりに /etc/fstab ファイルを使用します。 mount バイナリが通常フラグとして解釈するオプションはサポートされていません。 これらのオプションを明示的に指定するには、指定したいすべてのドライブを /etc/fstab に含める必要があります。

自動マウント オプション

Windows ドライブ (DrvFs) にさまざまなマウント オプションを設定すると、Windows ファイルのファイルのアクセス許可を計算する方法を制御できます。 次のオプションを選択できます。

既定では、WSL は uid と gid を既定のユーザーの値に設定します。 たとえば、Ubuntu では、既定のユーザーはuid=1000gid=1000。 この値を使用して別の gid または uid オプションを指定すると、既定のユーザー値が上書きされます。 それ以外の場合は、既定値が常に追加されます。

上記の umask、fmask などのオプションは、Windows ドライブがメタデータと共にマウントされている場合にのみ適用されます。 既定では、メタデータは有効になっていません。 詳細については、 こちらをご覧ください。

DrvFs とは?

DrvFs は、WSL と Windows ファイルシステム間の相互運用をサポートするように設計された WSL へのファイルシステム プラグインです。 DrvFs を使用すると、WSL は /mnt の下にサポートされているファイル システムでドライブをマウントできるようになります (/mnt/c、/mnt/d など)。Windows または Linux ドライブまたはディレクトリをマウントするときの既定の大文字と小文字の区別の動作の指定の詳細については、大文字と小文字の区別に関するページを参照してください。

ネットワーク設定

wsl.conf セクション ラベル: [[automount]]

相互運用性の設定

wsl.conf セクション ラベル: [[automount]]

これらのオプションは、Windows 10 バージョン 1809 (ビルド 17763) 以降で使用できます。

ユーザー設定

wsl.conf セクション ラベル: [[automount]]

次のオプションは、ビルド 18980 以降で使用できます。

ブート設定

ブート設定は、Windows 11 および Server 2022 でのみ使用できます。

wsl.conf セクション ラベル: [[automount]]

GPU 設定

wsl.conf セクション ラベル: [[automount]]

時刻の設定

wsl.conf セクション ラベル: [[automount]]

wsl.conf ファイルの例

以下の wsl.conf サンプル ファイルは、利用可能な構成オプションの一部を示しています。 この例では、ディストリビューションは Ubuntu-20.04 で、ファイルパスは \\wsl.localhost\Ubuntu-20.04\etc\wsl.conf です。

# Automatically mount Windows drive when the distribution is launched
[automount]

# Set to true will automount fixed drives (C:/ or D:/) with DrvFs under the root directory set above. Set to false means drives won't be mounted automatically, but need to be mounted manually or with fstab.
enabled=true

# Sets the directory where fixed drives will be automatically mounted. This example changes the mount location, so your C-drive would be /c, rather than the default /mnt/c.
root = /

# DrvFs-specific options can be specified.
options = "metadata,uid=1003,gid=1003,umask=077,fmask=11,case=off"

# Sets the `/etc/fstab` file to be processed when a WSL distribution is launched.
mountFsTab=true

# Network host settings that enable the DNS server used by WSL 2. This example changes the hostname, sets generateHosts to false, preventing WSL from the default behavior of auto-generating /etc/hosts, and sets generateResolvConf to false, preventing WSL from auto-generating /etc/resolv.conf, so that you can create your own (ie. nameserver 1.1.1.1).
[network]
hostname=DemoHost
generateHosts=false
generateResolvConf=false

# Set whether WSL supports interop processes like launching Windows apps and adding path variables. Setting these to false will block the launch of Windows processes and block adding $PATH environment variables.
[interop]
enabled=false
appendWindowsPath=false

# Set the user when launching a distribution with WSL.
[user]
default=DemoUser

# Set a command to run when a new WSL instance launches. This example starts the Docker container service.
[boot]
command=service docker start

.wslconfig

WSL で実行されているすべてのインストール済みディストリビューション全体で、.wslconfig でグローバル設定を構成します。

• .wslconfig ファイルは、既定では存在しません。 これらの構成設定を適用するには、%UserProfile% ディレクトリにそれを作成して保存する必要があります。
• WSL 2 バージョンとして実行されているすべてのインストール済み Linux ディストリビューションで設定をグローバルに構成するために使用されます。
• WSL 2 によって実行されるディストリビューションにのみ 使用できます。 WSL 1 として実行されているディストリビューションは、仮想マシンとして実行されていないため、この構成の影響を受けません。
• %UserProfile% ディレクトリに移動するには、PowerShell で cd ~ を使用してホーム ディレクトリ（通常はユーザー プロファイルである C:\Users\<UserName>）に移動するか、Windows ファイル エクスプローラーを開いてアドレス バーに %UserProfile% と入力することもできます。 ディレクトリ パスは次のようになります: C:\Users\<UserName>\.wslconfig

WSL は、これらのファイルの存在を検出し、内容を読み取り、WSL を起動するたびに構成設定を自動的に適用します。 ファイルが見つからないか、形式が正しくない (不適切なマークアップの書式設定) 場合、WSL は構成設定を適用せずに通常どおりに起動し続けます。

.wslconfig の構成設定

.wslconfig ファイルは、WSL 2 で実行されているすべての Linux ディストリビューションの設定をグローバルに構成します。 （ディストリビューションごとの設定についてはwsl.confを参照してください。）

.wslconfig ファイルの保存場所については、.wslconfig を参照してください。

このファイルには、WSL 2 ディストリビューションを実行する VM に影響を与える次のオプションを含めることができます:

主な WSL の設定

.wslconfig セクション ラベル: [[wsl2]]

"path" 値を持つエントリは、エスケープされた円記号を持つ Windows パスである必要があります。次に例を示します。 C:\\Temp\\myCustomKernel

値が size のエントリのデフォルトは B（バイト）で、単位は省略可能です。 他の単位を使用するには、サイズ単位を追加する必要があります (例: 8GB または 512MB)。

¹: Windows 11 でのみ使用できます。

²: Windows 11 バージョン 22H2 以降が必要です。

試験的な設定

これらの設定は、将来的に既定にすることを目指している試験的な機能のオプトイン プレビューです。

.wslconfig セクション ラベル: [[wsl2]]

¹: Windows 11 でのみ使用できます。

²: Windows 11 バージョン 22H2 以降が必要です。

.wslconfig ファイルの例

以下の .wslconfig サンプル ファイルは、利用可能な構成オプションの一部を示しています。 この例では、ファイル パスは %UserProfile%\.wslconfig です。

# Settings apply across all Linux distros running on WSL 2
[wsl2]

# Limits VM memory to use no more than 4 GB, this can be set as whole numbers using GB or MB
memory=4GB

# Sets the VM to use two virtual processors
processors=2

# Specify a custom Linux kernel to use with your installed distros. The default kernel used can be found at https://github.com/microsoft/WSL2-Linux-Kernel
kernel=C:\\temp\\myCustomKernel

# Specify the modules VHD for the custom Linux kernel to use with your installed distros.
kernelModules=C:\\temp\\modules.vhdx

# Sets additional kernel parameters, in this case enabling older Linux base images such as Centos 6
kernelCommandLine = vsyscall=emulate

# Sets amount of swap storage space to 8GB, default is 25% of available RAM
swap=8GB

# Sets swapfile path location, default is %UserProfile%\AppData\Local\Temp\swap.vhdx
swapfile=C:\\temp\\wsl-swap.vhdx

# Turn on default connection to bind WSL 2 localhost to Windows localhost. Setting is ignored when networkingMode=mirrored
localhostforwarding=true

# Disables nested virtualization
nestedVirtualization=false

# Turns on output console showing contents of dmesg when opening a WSL 2 distro for debugging
debugConsole=true

# Sets the maximum number of crash dump files to retain (default is 10)
maxCrashDumpCount=10

# Enable experimental features
[experimental]
sparseVhd=true

その他のリソース

• Windows コマンド ライン ブログ: WSL の自動構成
• Windows コマンドライン ブログ: Chmod/Chown、DrvFs、ファイル メタデータ