Docker 容器化指南：安裝、基本指令與進階使用

🎯 重點摘要： Docker 是容器化的領導者，用來把應用程式與依賴打包起來到處跑，不再有「我的電腦跑得好」的問題：
  ① 理解 Docker 的核心概念（Image、Container、Volume、Network）
  ② 安裝 Docker（Windows / macOS / Linux 三種方式）
  ③ 掌握基本指令（run、ps、images、exec、rm、logs）
  ④ 學會 Docker Compose 一次管理多個容器
  ⑤ 進階技巧：Dockerfile 建構自己的映像、Multi-stage build、除錯技巧

30 分鐘從零開始，讓你的應用「一次打包、到處跑」！

前言 — 什麼是 Docker？

Docker 是一個開源的容器化平台。你可以把它想像成「把應用程式 + 所有依賴打包在一起，一個指令就能到處跑」的技術。

傳統上，我們會在本機安裝 Node.js、Python、資料庫等等，但部署的時候常常會碰到：

• 「我的電腦跑得好，伺服器就錯」
• 「開發環境的 Node 版本和生產不一樣」
• 「部署一堆依賴很麻煩」

Docker 完美解決了這些問題 — 容器內含應用 + 所有依賴，確保環境一致性。

Docker 與傳統 VM 虛擬機的差別

如何安裝 Docker

Windows 安裝

1. 前往 Docker Desktop for Windows 下載安裝檔
2. 雙擊執行安裝程式，勾選「Install required Windows components for WSL2」
3. 安裝完成後，打開 Docker Desktop 等待初始化完成

⚠️ 注意： Windows 10 需要開啟 WSL2 支援。可以透過命令提示管理員執行 wsl --install 來啟用。

macOS 安裝

1. 前往 Docker Desktop for Mac 下載 .dmg 檔案
2. 支援 Intel 和 Apple Silicon（M1/M2/M3）
3. 拖曝到 Applications，開啟後即可使用

Linux (Ubuntu / Debian) 安裝

Linux 使用者可以用官方 script 一鍵安裝：

curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh

或者手動加入 apt repository 安裝：

# 新增 Docker 的官方 GPG key
sudo apt update
sudo apt install ca-certificates curl gnupg
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

# 設定 repository
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" | sed 's/-.*//')" stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

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

驗證安裝

docker --version
# Docker version 27.2.0, build 3232116

docker compose version
# Docker Compose version v2.29.2

加入 docker group (避免每次 sudo)

sudo usermod -aG docker $USER
# 登出並重新登入生效

Docker 基本指令大全

以下是 Docker 的核心指令整理，涵蓋容器、映像、卷、網路等。

映像 (Images) 管理

容器 (Containers) 管理

docker run 常用參數

💡 快速操作： 用 -it 進入容器後，可以直接執行指令進行除錯：
docker exec -it 容器名 sh

卷 (Volumes) 與網路 (Networks)

卷管理 — 把資料持久化

容器刪除了資料也會消失，Volume 讓資料持續保存：

# 建立卷
docker volume create my-data

# 查看卷
docker volume ls

# 刪除卷
docker volume rm my-data

# 清理無用卷
docker volume prune

網路管理 — 讓容器互通

# 建立網橋網路
docker network create my-net

# 查看網路
docker network ls

# 清理無用網路
docker network prune

# docker-compose.yml
version: '3.8'

services:
  web:
    image: nginx:latest
    ports:
      - "8080:80"
    volumes:
      - ./html:/usr/share/nginx/html
    depends_on:
      - db

  db:
    image: postgres:16
    environment:
      POSTGRES_USER: myuser
      POSTGRES_PASSWORD: secretpass
      POSTGRES_DB: mydb
    volumes:
      - db-data:/var/lib/postgresql/data

  redis:
    image: redis:7-alpine

volumes:
  db-data:

# 使用官方 Node.js 18 為基礎
FROM node:18-alpine

# 設定工作目錄
WORKDIR /app

# 複製 package.json 並安裝依賴
COPY package*.json ./
RUN npm ci --only=production

# 複製程式碼
COPY . .

# 設定環境變數
ENV NODE_ENV=production

# 開放連接埠
EXPOSE 3000

# 啟動指令
CMD ["npm", "start"]

# Multi-stage Dockerfile example
FROM node:18-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

FROM node:18-alpine AS runtime
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY --from=builder /app/dist ./dist
EXPOSE 3000
CMD ["npm", "start"]

# 進入正在運行的容器
docker exec -it <容器名> sh

# 查看容器環境變數
docker inspect <容器名> | jq '.[0].Config.Env'

# 查看容器映射的埠
docker port <容器名>

# 查看容器 IP 位址
docker inspect <容器名> | jq '.[0].NetworkSettings.Networks'

# 動態查看容器資源使用
docker stats

# 查看本地磁碟使用情況
docker system df

# 清理停止的容器
docker container prune

# 清理未使用的卷
docker volume prune

# 清理未使用的網路
docker network prune

# 清理未使用的映像
docker image prune

# 一次清理所有無用資源
docker system prune -a --volumes

# .dockerignore
node_modules
npm-debug.log
.git
.gitignore
.env
*.md
.dockerignore
Dockerfile
README.md
tests/