Zenn
🐧

wsl.conf を使用して WSL2 の動作をカスタマイズする方法

2023/10/23に公開
WSL 2
環境設定
カスタマイズ
wslconf
tech

tl;dr

WSL2 の動作は以下の手順で簡単にカスタマイズできます。

  1. /etc/wsl.confを作成しこちらのgistの内容をコピー & ペーストする
  2. hostnameおよびdefaultの値を自分の設定にあわせて書き換える
  3. wsl --shutdownと入力して WSL2 を停止し、Windows Terminalから再度 WSL2 を起動する

Enjoy!

はじめに

WSL2[1] は Windows 上で Linux の環境をスムーズに利用できる強力なツールです。
/etc/wsl.conf を使用して、WSL2 の動作をカスタマイズできます。

この記事では、WSL2 の基本的な設定を紹介します。

1. wsl.conf とは

wsl.conf[2] は、WSL の動作をカスタマイズするための設定ファイルです。
このファイルに設定を書き込むことで WSL2 の動作を変更できます。

wsl.confの設定の詳細はMicrosoft Learn - WSL での詳細設定の構成を参照してください。

2. wsl.conf によるWSLの設定

2.1. wsl.conf の設定一覧

この記事では、以下のように WSL を設定します。

セクション 設定項目 設定 備考
boot systemd true systemd[3] のサポートを有効にする
network hostname[4] <your-hostname> WSLインスタンスのホスト名、用途に応じて設定する
interop[5] appendWindowsPath[6] false Windows側のPath設定を追加しない
user default <your-username> WSL起動時にログインするユーザー名を設定する

以上のように、WSL2 を設定します。

2.2. 作成したwsl.conf

上記の設定にあわせて、/etc/wsl.confを作成します。
/etc/wsl.conf は次の通りです。

2.3. /etc/wsl.conf のWSL への設定方法

次の手順で、WSL を設定します。

  1. /etc/wsl.confの作成
    WSL2上の Debian で、次のコマンドを実行して/etc/wsl.confを作成する。
    /etc/wsl.conf に 2.2.の節で作成した wsl.conf の内容をコピー＆ペーストする

    以下のコマンドを実行してください

    sudo vi /etc/wsl.conf

  2. /etc/wsl.confの設定
    自分の環境にあわせて、1. の<your-hostname>、<your-username>を書き換えて、/etc/wsl.confを保存します。

  3. Debian の再起動
    /etc/wsl.confを作成した Debian を停止します。

    以下のコマンドを実行してください

    wsl --shutdown

    その後、Windows Terminal[7] で Debian を選択して、WSL2 を起動します。
    プロンプトは、atsushifx@develop:~$のように表示され、wsl.confの設定が反映されています

以上で、/etc/wsl.confへの設定は終了です。

おわりに

この記事では、wsl.confを使い WSL の基本動作を設定しました。
自分の設定例はこちらのgistに保存されていますので、参考にしてください。

wsl.conf だけでなく、.profile,.bashrc[8] などのシェルスクリプトやその他の Linux の設定もすることで、WSL2 をより効果的に活用できます。

それでは、Happy Hacking!

参考資料

Microsoft Learn

Webサイト

脚注

  1. WSL2: WSL _\text{(Windows Subsystem for Linux)} の第2バージョン ↩︎

  2. wsl.conf: WSL の動作をカスタマイズするファイル。WSL 起動時に実行するコマンドなどが指定できる ↩︎

  3. systemd: Linux のサービスやデーモンを管理するシステムとサービスマネージャー ↩︎

  4. hostname: コンピュータネットワーク上でコンピューターを識別するための名前 ↩︎

  5. interop: ここでは、WSL と Windows との相互運用性に関する設定 ↩︎

  6. appendWindowsPath: WSL上に Windows 側の Path を設定するフラグ。True の時に、WSL 側に Windows 側の Path を追加する ↩︎

  7. Windows Terminal: Windows 公式のターミナルエミュレーター ↩︎

  8. .profile, .bashrc: Linux のシェルの設定ファイル。ユーザーがログインしたときに読み込まれる ↩︎

GitHubで編集を提案

Discussion