Docker 容器化部署、日誌輪轉與 UFW 防火牆隔離指南
在 Linux 雲端伺服器上安裝官方 Docker Engine 與 Compose v2,配置 daemon.json 日誌大小限制防止 NVMe 磁碟佔滿,並徹底解決 Docker 繞過 UFW 防火牆的經典安全隱憂。
在 FlawlessNode KVM 雲端伺服器上,使用 Docker Engine 與 Docker Compose v2 部署 Web 應用、資料庫與微服務已成為生產環境的標準範式。然而,預設的 Docker 安裝存在兩個極易引發正式環境事故的隱憂:無上限的容器 JSON 日誌迅速撐爆 NVMe 磁碟,以及 Docker 自動寫入 iptables NAT 規則直接繞過 UFW 防火牆將內部連接埠暴露至公網。本指南將協助您建構安全、穩健的容器化生產環境。
1. 安裝官方 Docker Engine 與 Compose v2
請勿直接安裝系統預設軟體庫中老舊的 docker.io 或已棄用的 Python 版 docker-compose v1。推薦直接透過 Docker 官方來源安裝最新版 Docker CE 與 Docker Compose v2 外掛程式:
1.1 官方一鍵安裝(支援 Ubuntu / Debian / Rocky / AlmaLinux)
# 下載並執行 Docker 官方安裝腳本
curl -fsSL https://get.docker.com | sudo sh
# 設定開機自啟並立即啟動 Docker 服務
sudo systemctl enable --now docker
驗證 Docker 引擎與 Compose v2 外掛程式版本:
docker --version
# 預期輸出:Docker version 27.x.x 或 28.x.x
docker compose version
# 預期輸出:Docker Compose version v2.x.x
[!TIP] 請注意現代指令為帶空格的
docker compose(v2 原生 Go 語言外掛程式),而非舊版帶連字號的docker-compose(v1)。Compose v2 效能更高且完整支援最新 Compose 規範。
2. 生產級 daemon.json 調優(日誌輪轉與高併發限制)
預設情況下,Docker 會將所有容器的標準輸出(stdout/stderr)持續附加寫入 /var/lib/docker/containers/<id>/<id>-json.log,且沒有任何容量上限。當運行高併發 Web 服務或頻繁報錯的容器時,日誌檔案往往在數週內膨脹至數十 GB,導致伺服器因 No space left on device 而停機。
請在安裝完 Docker 後第一時間建立 /etc/docker/daemon.json,強制開啟日誌自動輪轉(Log Rotation):
sudo mkdir -p /etc/docker
cat << 'EOF' | sudo tee /etc/docker/daemon.json
{
"log-driver": "json-file",
"log-opts": {
"max-size": "50m",
"max-file": "3",
"compress": "true"
},
"storage-driver": "overlay2",
"live-restore": true,
"default-ulimits": {
"nofile": {
"Name": "nofile",
"Hard": 1048576,
"Soft": 1048576
}
}
}
EOF
# 重新載入背景服務並重啟 Docker
sudo systemctl daemon-reload
sudo systemctl restart docker
核心配置項解析:
| 參數項 | 作用說明 | 生產環境價值 |
|---|---|---|
max-size: "50m" & max-file: "3" |
限制單個容器最多保留 3 個日誌檔案,每個最大 50MB(單容器上限 150MB) | 徹底杜絕容器日誌無限增長撐爆 NVMe 根分割區 |
live-restore: true |
在 dockerd 服務升級或重啟期間保持運行中的容器不中斷 |
顯著降低日常維護期間的業務閃斷時間 |
default-ulimits.nofile |
將容器內預設最大開啟檔案控制代碼數提升至 1,048,576 |
防止高併發反向代理或資料庫容器出現 Too many open files 報錯 |
[!NOTE] 修改
/etc/docker/daemon.json後,日誌限制規則僅對新建容器生效。若您此前已有正在運行的容器,請進入專案目錄執行docker compose up -d --force-recreate重建容器以套用新規則。
3. 核心安全加固:防止 Docker 繞過 UFW 防火牆
3.1 為什麼 Docker 會使 UFW 失效?
當您使用 -p 8080:8080 或在 docker-compose.yml 中配置 ports: ["8080:8080"] 時,Docker 會在 Linux 核心的 nat(PREROUTING 鏈)中直接插入連接埠轉發規則,其優先順序高於 UFW 的 ufw-before-input 過濾鏈。這意味著即便您在 UFW 中設定了預設拒絕入站(ufw default deny incoming)且未放行 8080 連接埠,全網任何人依然可以直接連線您的 8080 連接埠!
3.2 方案一(最推薦):僅綁定本機迴路位址 127.0.0.1
如果您的容器前端由主機 Nginx / Caddy 反向代理,或者僅允許本機服務呼叫(如 MySQL、Redis、PostgreSQL),請務必明確指定綁定至 127.0.0.1:
# docker-compose.yml 連接埠安全綁定範例
services:
webapp:
image: nginx:alpine
restart: unless-stopped
ports:
# ✅ 安全:僅允許主機本機及反向代理存取,公網無法直接掃描連線
- "127.0.0.1:8080:80"
# ❌ 高風險:會直接繞過 UFW 防火牆,向全網 0.0.0.0 暴露 8080 連接埠!
# - "8080:80"
3.3 方案二:透過 DOCKER-USER 鏈將容器流量納入 UFW 管控
如果您確實需要容器直接監聽公網連接埠並由 UFW 統一控制放行策略,可將以下 DOCKER-USER 過濾規則附加至 /etc/ufw/after.rules 檔案末尾:
sudo tee -a /etc/ufw/after.rules > /dev/null << 'EOF'
# BEGIN UFW AND DOCKER
*filter
:ufw-user-forward - [0:0]
:ufw-docker-logging-deny - [0:0]
:DOCKER-USER - [0:0]
-A DOCKER-USER -j ufw-user-forward
-A DOCKER-USER -m conntrack --ctstate RELATED,ESTABLISHED -j RETURN
-A DOCKER-USER -m conntrack --ctstate INVALID -j DROP
-A DOCKER-USER -i eth0 -m set --match-set ufw-user-input dst -j RETURN
# 預設攔截從公網網卡 eth0 直接存取 Docker 內部私有網段的封包
-A DOCKER-USER -i eth0 -d 10.0.0.0/8 -j ufw-docker-logging-deny
-A DOCKER-USER -i eth0 -d 172.16.0.0/12 -j ufw-docker-logging-deny
-A DOCKER-USER -i eth0 -d 192.168.0.0/16 -j ufw-docker-logging-deny
-A DOCKER-USER -j RETURN
-A ufw-docker-logging-deny -m limit --limit 3/min --limit-burst 10 -j LOG --log-prefix "[UFW DOCKER BLOCK] "
-A ufw-docker-logging-deny -j DROP
COMMIT
# END UFW AND DOCKER
EOF
sudo ufw reload
重新載入後,預設所有容器連接埠不再對公網暴露;如需對公網放行某個容器連接埠(如 8080),只需執行:sudo ufw route allow proto tcp from any to any port 8080。
4. 限制容器記憶體與 CPU 配額(防止單容器引發整機 OOM)
為了避免單個業務容器發生記憶體洩漏時耗盡整機實體記憶體、觸發核心 OOM Killer 終止 SSH 或資料庫行程,建議在 docker-compose.yml 中配置資源上限:
services:
api-service:
image: node:22-alpine
restart: unless-stopped
deploy:
resources:
limits:
cpus: "1.50"
memory: 1024M
reservations:
memory: 256M
隨時透過以下指令即時監控各容器的 CPU、記憶體與網路 I/O 佔用:
docker stats
5. 清理廢棄映像檔與建置快取釋放磁碟空間
長期迭代更新容器後,舊版映像檔層(Dangling Images)與建置快取會佔用大量空間。可使用以下安全指令回收磁碟:
# 1. 查看 Docker 映像檔、容器、資料卷與建置快取的空間佔用明細
docker system df
# 2. 安全清理已停止的容器、未使用的網路及懸空映像檔層
docker system prune -f
# 3. 清理超過 7 天未被任何運行中容器引用的舊版映像檔
docker image prune -a --filter "until=168h" -f
[!CAUTION] 執行
docker system prune時切勿隨意附加--volumes參數,否則當某個資料庫容器恰處於停止狀態時,其掛載的持久化資料卷(Volume)可能會被一併清除!