跳至主要内容

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:管理多個容器,推薦安裝。