Ubuntu 24.04 安裝 Docker 與 Docker Compose 教學

前言

Docker 是現代開發和部署的必備工具。這篇文章記錄在 Ubuntu 24.04 LTS 上安裝 Docker 和 Docker Compose 的完整步驟。

安裝步驟

1. 更新系統並安裝必要工具

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

2. 加入 Docker 官方 GPG Key

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

3. 加入 Docker Repository

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

4. 安裝 Docker Engine 和 Docker Compose

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

5. 讓當前使用者可以使用 Docker（不用 sudo）

sudo usermod -aG docker $USER
newgrp docker

驗證安裝

docker --version
docker compose version

輸出範例：

Docker version 29.2.1
Docker Compose version v5.0.2

測試 Docker

docker run hello-world

如果看到 “Hello from Docker!” 就表示安裝成功了！

注意事項

• Docker Compose V2 使用 docker compose（空格），不是舊版的 docker-compose（連字號）
• 加入 docker group 後需要重新登入或執行 newgrp docker 才會生效
• Ubuntu 24.04 的 codename 是 noble