在 Windows 上用 WSL 打造完整的 Ubuntu 開發環境（Node、Python、Docker、遠端桌面）

一套可重現的 WSL 安裝流程筆記：從啟用 WSL、安裝指定版本的 Ubuntu，到鋪好 Node.js（NVM 管理）、Python、Pi、Docker，最後加上 XFCE + XRDP 遠端桌面。適合想嘗試在 Windows 上跑 Linux 開發環境的人照表操課。

一、安裝與設定 WSL + Ubuntu

WSL（Windows Subsystem for Linux）讓你在 Windows 裡直接執行 Linux 發行版，不需要虛擬機或雙系統。

# 啟用 WSL 所需功能，並安裝預設的 Linux 發行版
wsl --install

# 更新 WSL 核心與相關元件
wsl --update

# 列出可從 Microsoft Store / 線上來源安裝的發行版
wsl -l -o
# 或完整寫法：
wsl --list --online

若要安裝指定版本而非預設發行版，可以搭配 --name（在 Windows 中的名稱）與 --location（虛擬磁碟儲存位置）：

# 注意：--name 與後續 wsl -d 使用的名稱必須一致
wsl --install Ubuntu-26.04 --name Ubuntu26 --location D:\wsl2\ubuntu26

啟動與設定預設發行版：

# 啟動指定的 WSL 發行版
wsl -d Ubuntu26

# 將 Ubuntu26 設為預設，之後直接執行 wsl 就進入它
wsl --set-default Ubuntu26

二、NVM 與 Node.js

NVM（Node Version Manager） 讓你在同一台電腦上安裝、切換、管理多個 Node.js 版本：

# 下載並安裝 NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# 不重啟 Shell 就立即載入（安裝後若尚未讀取 ~/.nvm/nvm.sh）
. "$HOME/.nvm/nvm.sh"

接著安裝 Node.js 24 並確認版本：

# NVM 會下載安裝 Node 24，之後可透過 nvm 管理不同版本
nvm install 24

# 查看版本
node -v
npm -v   # npm 是 Node.js 的套件管理工具

三、Python

讓 Ubuntu 的 python 指令直接對應到 Python 3：

sudo apt install python-is-python3

安裝後執行 python --version 就會等於 python3 --version。

四、Pi（AI 助手 CLI）

Pi 是 Mario Zechner 的 AI agent（在 Omarchy 也被列為預設 agent 之一），官方一行安裝：

curl -fsSL https://pi.dev/install.sh | sh

會從 pi.dev 下載安裝腳本並透過 sh 執行。

五、Docker

用官方腳本安裝 Docker：

# 下載 Docker 官方安裝腳本
# -f：HTTP 錯誤即失敗 / -s：靜默 / -S：錯誤仍顯示訊息 / -L：自動跟隨重新導向
curl -fsSL https://get.docker.com -o install-docker.sh

# 以 root 執行安裝
sudo sh install-docker.sh

六、XFCE + XRDP 遠端桌面

最後加一個圖形桌面，讓你用 RDP（遠端桌面協定） 連進 Ubuntu：

# 先更新套件清單（安裝新套件前建議）
sudo apt update

# 安裝 XFCE 桌面、額外工具與 XRDP 服務
# xfce4=桌面環境 / xfce4-goodies=常見工具套件 / xrdp=RDP 服務 / -y=自動回答 Yes
sudo apt install xfce4 xfce4-goodies xrdp -y

# 設定 XRDP 登入後啟動 XFCE
echo "startxfce4" > ~/.xsession

# 設定 XRDP 開機自動啟動，並立即啟動
sudo systemctl enable xrdp
sudo systemctl start xrdp

連線資訊：

# 顯示目前 WSL 環境的 IP——這就是 XRDP 遠端連線的目標
hostname -I

用 Windows 內建的「遠端桌面連線」輸入這個 IP（連線方式選 Xorg），即可進入 XFCE 桌面。

---

備註

• --name 與 wsl -d 用的名字要一致，否則會找不到發行版。
• WSL 安裝預設全碟掛載在 \\wsl$\ 路徑，若想把虛擬磁碟放在 D 槽，記得用 --location。
• XRDP 對應的是 Xorg 連線方式，若你偏好 Wayland 桌面，可改裝其他組合。

本筆記整理的是一條可重現的「Windows → Linux 開發環境」路徑：WSL 做底座，Node/Python/Pi/Docker 鋪開發工具，最後用 XRDP 補一個圖形介面，遠端管理起來更方便。