安裝 Docker（Windows、macOS、Linux）

Windows

1. 到 Docker 官網下載 Docker Desktop for Windows。
2. 執行安裝程式，安裝過程中保持勾選 Use WSL 2 instead of Hyper-V。
3. 安裝完成後重新開機，啟動 Docker Desktop，等待左下角顯示引擎已在執行。

Docker Desktop 需要 WSL 2。如果還沒啟用，可以用系統管理員身分開啟 PowerShell 執行：

wsl --install

macOS

1. 到 Docker 官網下載 Docker Desktop for Mac，依照晶片選擇 Apple Silicon 或 Intel 版本。
2. 開啟下載的 .dmg，把 Docker 拖進「應用程式」資料夾。
3. 啟動 Docker，第一次會要求授權，完成後選單列會出現鯨魚圖示。

不確定是哪種晶片？點左上角蘋果選單 →「關於這台 Mac」，看「晶片」或「處理器」欄位。

Linux（Ubuntu）

在 Linux 上通常直接安裝 Docker Engine，不需要 Docker Desktop。下面是用官方套件庫安裝的方式：

# 1. 安裝必要工具並加入 Docker 的 GPG 金鑰
sudo apt-get update
sudo apt-get install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

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

# 3. 安裝 Docker Engine 與 Compose 外掛
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

不用 sudo 執行 docker

預設只有 root 能執行 docker。把自己加入 docker 群組，重新登入後就不用每次加 sudo：

sudo usermod -aG docker $USER

加入 docker 群組等同於擁有 root 權限，只對信任的帳號這樣做。

確認安裝成功

docker version

輸出中同時看到 Client 和 Server 兩段，代表 CLI 和 Docker Engine 都正常。接著執行：

docker run hello-world

看到 Hello from Docker! 就完成了。

常見問題

Cannot connect to the Docker daemon

代表 Docker Engine 沒有在執行。

• Windows / macOS：確認 Docker Desktop 已經開啟。
• Linux：執行 sudo systemctl start docker，並用 sudo systemctl enable docker 設定開機自動啟動。

permission denied while trying to connect to the Docker daemon socket

Linux 上的權限問題。照上面的步驟把自己加入 docker 群組，然後登出再登入（或執行 newgrp docker）。

更新於 2026年10月12日