Docker 安裝與環境設定

在開始使用 Docker 之前，我們需要在開發環境中安裝它。Docker 官方現在提供了 Docker Desktop，讓你在 Windows、Mac 或 Linux 上都能輕鬆擁有完整的圖形化管理工具。

本章將帶領你完成各平台的安裝步驟，並針對最新環境進行優化。

選擇適合你的 Docker 版本

Docker Desktop (推薦)

最適合個人開發者使用，包含：

  • Docker Engine：核心容器引擎。
  • Docker CLI：指令行工具。
  • Docker Compose：多容器編排工具。
  • Docker GUI：直觀的圖形管理介面。

Docker Engine (生產環境)

適合伺服器使用，通常不包含圖形介面，直接安裝在 Linux 發行版上。

Windows 安裝指南

在 Windows 上安裝 Docker，目前最佳實踐是搭配 WSL 2 (Windows Subsystem for Linux)。

  1. 啟用 WSL 2：開啟 PowerShell (以管理員身份) 並輸入：
    wsl --install
    完成後建議重新啟動電腦。
  2. 下載 Docker Desktop：前往 Docker 官網 下載 Windows 版本。
  3. 執行安裝程式：安裝時請確保勾選「Use the WSL 2 based engine (recommended)」。
  4. 啟動 Docker：安裝完成後啟動 Docker Desktop，等待右下角的小鯨魚圖示停止跳動。

macOS 安裝指南

macOS 的安裝相對簡單，但如果你使用的是 Apple Silicon (M1/M2/M3) 晶片，請注意以下幾點：

  1. 下載對應版本：官網下載時請區分 Intel Chip 或 Apple Chip。
  2. 安裝 Rosetta 2：為了讓某些舊的 Intel 架構映像檔能順利在 Apple Silicon 上執行，建議安裝 Rosetta 2：
    softwareupdate --install-rosetta
  3. 拖移安裝：將 Docker 圖示拖移到 Applications 資料夾即可。

Linux 安裝指南 (Ubuntu 範例)

對於開發者而言，有時我們也會在原生 Linux 或伺服器上安裝 Docker Engine。

# 1. 更新套件清單
sudo apt-get update

# 2. 安裝必要的相依套件
sudo apt-get install ca-certificates curl gnupg

# 3. 加入 Docker 官方 GPG 金鑰
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

# 4. 加入套件庫儲存庫
echo \
  "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 5. 安裝 Docker Engine
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

驗證安裝是否成功

安裝完成後，打開你的終端機 (Terminal / PowerShell)，輸入以下指令來確認版本：

docker --version

輸出結果應類似：Docker version 29.1.2, build 890dcca。

接著，跑一個官方的測試映像檔來確認 Docker 核心可以正常運作：

docker run hello-world

如果你看到 "Hello from Docker!" 的字樣，恭喜你，Docker 已經成功安裝並運行在你的電腦上了！

如果你在 Linux 上遇到權限問題（必須加 sudo 才能跑 docker），可以將使用者加入 docker 群組： sudo usermod -aG docker ${USER} 執行完後需登出再登入才會生效。

Docker Desktop 基本配置建議

啟動 Docker Desktop 後，點擊齒輪圖示 (Settings)：

  • General：勾選 "Start Docker Desktop when you log in" 確保每次開機立即可用。
  • Resources：
    • Memory：建議分配至少 4GB 記憶體（視你的專案規模而定）。
    • Disk image location：如果 C 槽空間不足，可以將映像檔存儲位置改到其他磁碟。
  • Docker Engine：可以在這裡手動編輯 daemon.json 設定檔，例如加入私有 Registry 的位址。