【WSL2リファレンス】Ubuntuの最短構築・詳細設定・リソース制限まとめ

はじめに

WindowsでLinux開発環境を構築する際、GUIのインストーラー(Microsoft Store)は手軽ですが、パスの制御やバージョン指定の柔軟性に欠けることがあります。本記事では、コマンドプロンプトやPowerShellを使い、エンジニアが納得できる「最小構成かつクリーンな」Ubuntu環境の構築手順を解説します。

とりあえず動かしたい時(microsoftStore版)→ Microsoft StoreからシンプルにUbuntuを導入する方法。

目次

0. 前提条件の確認

WSL2を利用するには、Windowsのビルド番号が一定以上である必要があります。

  • OS: Windows 10 バージョン 1903 以降、または Windows 11
  • BIOS設定: CPUの仮想化(Virtualization Technology / VT-x / AMD-V)が有効であること

1. 最短インストール(Step-by-Step)

初めてWSLを導入する場合、以下の手順を管理者権限のPowerShellで実行します。

1.1 WSL2の有効化と最新化

インストールとアップデートするコマンドです。wsl導入済みならupdateだけで構いません。

wsl --install
wsl --update

初回インストール時は、ユーザ名とパスワードを聞かれるので設定する。

1.2 OSのインストール(バージョン指定)

# インストール可能なOS一覧を表示
wsl --list --online

# 例: Ubuntu 24.04を指定してインストール
wsl --install -d Ubuntu-24.04

2. ディストリビューション管理コマンド(逆引き)

日常的な管理や、複数の環境を使い分ける際に使用します。

目的コマンド
稼働状況の確認wsl --list --verbose (または wsl -l -v)
デフォルトOSの変更wsl --set-default <DistroName>
特定のOSを停止wsl --terminate <DistroName>
WSLの完全シャットダウンwsl --shutdown
OSの登録解除(削除)wsl --unregister <DistroName>
wsl2でインストールできている環境とデフォルトをチェックする

win11 wsl2 で”wsl --list --verbose” した例(ubuntuとubuntu24.04が入っている)

一番左の ” * ” はデフォルトOSを指しており、wsl単体や-dをつけずに起動したときに起動するものを指しています。また、ここで表示される VERSIONは、それぞれのディストリビューションが WSL1かWSL2どちらのバージョンで動いているのかを示しています。


3. リソース制限の設定(メモリ・CPU割り当て)

Windows側のメモリをWSLに使い切られないよう制限をかけます。

Windows側のユーザーフォルダ(C:\Users\<ユーザー名>\)に .wslconfig ファイルを新規作成します。

設定例: .wslconfig

[wsl2]
# WSL2に割り当てる最大メモリ量
memory=8GB

# 使用するCPUコア数
processors=4

# Swapファイルのサイズ
swap=4GB

# Windows側へのlocalhost転送(開発用)
localhostForwarding=true

反映方法: 設定保存後、PowerShellで wsl --shutdown を実行してから再起動します。


4. ストレージ最適化(VHDXの移動・圧縮)

デフォルトのCドライブを圧迫しないための上級者向け操作です。

インストール先ドライブの変更(移動)

エクスポート:

wsl --export <Distro> <Path\FileName.tar>

登録解除:

wsl --unregister <Distro>

インポート:

wsl --import <Distro> <InstallLocation> <Path\FileName.tar>

ディスク容量の返却(圧縮)

WSL内でファイルを消してもWindows側のVHDXサイズは縮小されません。手動で圧縮します。

  1. wsl --shutdown
  2. diskpart を起動
  3. select vdisk file="<vhdxのパス>"
  4. compact vdisk

5. インストール直後の初期設定(Ubuntu側)

Ubuntuが起動したら、まず以下の3工程を済ませておきましょう。(任意)

① ミラーサーバーを日本に変更

リポジトリのアップデートなどの参照先を米国(デフォルト)から日本サーバに変えておきます

sudo sed -i 's|http://archive.ubuntu.com/ubuntu/|http://jp.archive.ubuntu.com/ubuntu/|g' /etc/apt/sources.list

② パッケージの最新化

sudo apt update && sudo apt upgrade -y

③ 開発基本ツールの導入(よく使うやつをお好みで)

sudo apt install -y build-essential pkg-config git curl
ミラーサーバーの国内サーバー化のメリット

グローバル負荷の軽減: 国内トラフィックで完結させることで、本家サーバーの負荷分散に寄与します。

DL速度の劇的な向上: 物理的距離の短縮により、パッケージ取得時のレイテンシが減少、スループットが最大化されます。

接続の安定化: 海外経由の複雑なルーティングを避けることで、大容量の upgrade 時におけるタイムアウトや接続断のリスクを低減できます。

さいごに

WSL2 の導入と基本的な初期設定についてまとめました。参考になれば幸いです。

ubuntuを入れてみたが、何から始めたらいいかわからないという方向けに、linuxの基本的なファイル操作からシェル演算子の仕組みやメモリの確認方法、part4では自分好みのターミナル環境を整える方法をlinuxコマンド入門シリーズとして投稿しています。初めから順次追っていけば最低限のlinux操作はできるようになるはず?です。(linuxの最低限操作がどのレベルなのか人に依る)

linuxコマンド入門 part4で紹介したコマンドの逆引きリファレンス

linuxターミナルを効率的に自分好みに改造する方法を紹介したシリーズのサムネイル

【Linuxコマンド入門 第4部・完】自分好みの環境を作る 逆引きリファレンス 【Linuxコマンド入門 Part4-17】

Linux作業を劇的に効率化する全16記事の総まとめ!aliasでの短縮、PATHの仕組み、tmuxの画面分割からdotfiles管理まで。ターミナルを自分好みに改造する必須テクニックを、目的別に探せる逆引きリファレンス形式で大公開。