跳至主要内容

Install Tutorial

在開始使用 Docker 之前，我們需要先安裝 Docker。Docker 支援多種作業系統，包括 Linux、macOS 和 Windows。本篇將介紹如何在這些系統上安裝 Docker。

在 Linux 上安裝 Docker（Ubuntu 為例）​

在 Linux 上安裝 Docker 最推薦的方式是透過官方的 Docker CE（Community Edition），適用於開發者和個人使用者。

1. 更新系統套件庫​

先確保你的系統是最新的，並安裝必要的相依套件：

sudo apt update
sudo apt install -y ca-certificates curl gnupg

2. 加入 Docker 官方 GPG 金鑰​

Docker 官方提供的套件需要驗證金鑰，先新增 GPG 金鑰：

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo tee /etc/apt/keyrings/docker.asc > /dev/null
sudo chmod a+r /etc/apt/keyrings/docker.asc

3. 加入 Docker 官方的套件庫​

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update

4. 安裝 Docker​

執行以下指令安裝 Docker：

sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

5. 啟動並測試 Docker​

啟動 Docker 服務：

sudo systemctl enable --now docker

確認 Docker 是否成功安裝：

docker --version

執行測試容器：

sudo docker run hello-world

如果看到 "Hello from Docker!"，表示安裝成功！ 🎉

6. 允許非 root 用戶執行 Docker（可選）​

預設情況下，Docker 只能由 root 或 sudo 權限執行。如果希望普通用戶可以執行 Docker，可以執行：

sudo usermod -aG docker $USER
newgrp docker

然後嘗試執行：

docker run hello-world

如果不需要 sudo 就能執行，表示設定成功。

在 macOS 上安裝 Docker​

1. 下載並安裝 Docker Desktop​

Docker 提供官方的 macOS 版本（Docker Desktop），請從以下網址下載： 🔗 Docker 官方下載頁面

下載後，打開 .dmg 檔案，將 Docker 拖曳到「應用程式」資料夾即可。

2. 啟動 Docker​

安裝完成後，在「應用程式」中開啟 Docker Desktop，並等待 Docker 服務啟動（通常會顯示 "Docker is running"）。

3. 測試 Docker​

打開 終端機（Terminal），輸入：

docker --version
docker run hello-world

如果看到「Hello from Docker!」，表示安裝成功。

在 Windows 上安裝 Docker​

Windows 主要有兩種方式安裝 Docker：

  1. Docker Desktop（適用於 Windows 10/11 Pro、Enterprise）
  2. Docker Toolbox（較舊的 Windows 版本或 Windows Home 用戶）

1. 下載 Docker Desktop​

從官方網站下載安裝程式： 🔗 Docker 官方下載頁面

2. 安裝 Docker​

  • 執行下載的 .exe 檔案
  • 勾選 「Use WSL 2 instead of Hyper-V」（建議使用 WSL2）
  • 按「安裝」，等待安裝完成

3. 啟用 WSL 2（可選，但建議）​

如果要使用 Windows Subsystem for Linux（WSL2），請開啟 PowerShell（以管理員身份執行）：

wsl --install

然後設定 WSL2 為預設後端：

wsl --set-default-version 2

4. 啟動 Docker​

  • 在「開始」功能表搜尋 Docker Desktop，開啟應用程式
  • 確認 Docker is running（通常會在系統工具列顯示 Docker 圖示）

5. 測試 Docker​

打開「命令提示字元」或「PowerShell」，輸入：

docker --version
docker run hello-world

如果成功顯示「Hello from Docker!」，代表安裝成功 🎉

在 Windows 安裝 Docker（使用 WSL2）​

如果你使用的是 Windows 10 Home 版本，則無法使用 Hyper-V，必須改用 WSL2 + Docker。

1. 安裝 WSL2​

開啟 PowerShell（以管理員身份執行），輸入：

wsl --install

下載 Ubuntu（建議版本），然後設定 WSL2 為預設：

wsl --set-default-version 2

2. 安裝 Docker​

  • 下載 Docker Desktop
  • 啟動安裝程式，並選擇 「Use WSL2 instead of Hyper-V」
  • 完成安裝後，開啟 Docker Desktop 並確保 WSL2 整合功能開啟

3. 測試 Docker​

在 WSL2（Ubuntu）中執行：

docker --version
docker run hello-world

如果看到「Hello from Docker!」，表示成功！ 🎉

安裝 Docker Compose（選用）​

Docker Compose 是 Docker 的擴充工具，主要用來管理多個容器的應用程式，像是 Web 伺服器 + 資料庫 的架構。

在 Linux 安裝 Docker Compose​

Docker Compose 內建於新版本的 Docker，可透過以下方式確認：

docker compose version

如果沒有安裝，可以使用：

sudo apt install -y docker-compose-plugin

在 macOS 和 Windows​

Docker Desktop 內建 Docker Compose，所以無需額外安裝。

測試 Docker Compose​

建立 docker-compose.yml：

version: '3'
services:
  web:
    image: nginx
    ports:
      - '8080:80'

啟動：

docker compose up -d

打開瀏覽器，輸入 http://localhost:8080，若能看到 Nginx 介面，代表安裝與測試成功！ 🎉

總結​

  • Linux 安裝：使用 apt 套件庫並啟動 Docker 服務。
  • macOS 安裝：下載 Docker Desktop 並啟動 Docker。
  • Windows 安裝：使用 Docker Desktop，並建議啟用 WSL2。
  • 測試 Docker：使用 docker run hello-world 確保安裝成功。
  • Docker Compose：管理多個容器，推薦安裝。