本文記錄了一次 Docker 磁盤(pán)占用排查與遷移的完整復(fù)盤(pán)。

一、問(wèn)題背景

服務(wù)器磁盤(pán)分布大致如下：

• 系統(tǒng)盤(pán)：/dev/vda1，40G，掛載 /
• 數(shù)據(jù)盤(pán)：/dev/vdb1，493G，掛載 /data

初始現(xiàn)象是：

• / 分區(qū)使用率偏高
• /var/lib/docker/overlay2 顯示掛載在根分區(qū)
• 懷疑 Docker 鏡像或容器占用了大量系統(tǒng)盤(pán)空間

二、Docker 磁盤(pán)占用的正確查看方式

1. 系統(tǒng)層面（df）

df -h

如果看到類似：

overlay 40G 20G 18G 54% /var/lib/docker/overlay2/.../merged

不要誤判：

這并不是 Docker 獨(dú)占 40G，而是 overlayfs 映射了宿主機(jī)根分區(qū)。

2. Docker 視角（關(guān)鍵命令）

基礎(chǔ)統(tǒng)計(jì)

docker system df

詳細(xì)拆分（強(qiáng)烈推薦）

docker system df -v

你可以精確看到：

每個(gè)鏡像的：

• SIZE
• SHARED SIZE
• UNIQUE SIZE
• 是否被容器使用

構(gòu)建緩存（Build Cache）的真實(shí)占用

容器自身的寫(xiě)層大小

三、為什么會(huì)看到大量<none>鏡像？

示例：

<none>  <none>  554MB
<none>  <none>  554MB
...

這些并不是“異常鏡像”，而是懸空鏡像（dangling images）。

產(chǎn)生原因總結(jié)

1. 多次 docker build，舊鏡像標(biāo)簽被新鏡像覆蓋
2. 構(gòu)建中間層未被任何鏡像引用
3. CI / 自動(dòng)構(gòu)建未做清理策略

本質(zhì)上：

Docker 很保守，不會(huì)自動(dòng)刪除歷史構(gòu)建產(chǎn)物

四、Docker 構(gòu)建緩存（Build Cache）才是“隱形大戶”

在一次排查中發(fā)現(xiàn)：

Build cache usage: 11.56GB

而鏡像 + 容器加起來(lái)不到 1GB。

這類緩存來(lái)自：

• docker build
• BuildKit
• 多階段構(gòu)建的中間層

清理方式

docker builder prune

如果你想徹底清：

docker system prune -a

?? 注意：

這會(huì)刪除所有未被容器使用的鏡像。

五、Docker 數(shù)據(jù)目錄遷移的正確姿勢(shì)（簡(jiǎn)版）

以下步驟在 Docker 已停止 的前提下進(jìn)行

1. 停止 Docker

systemctl stop docker

2. 拷貝數(shù)據(jù)（推薦 rsync）

rsync -a /var/lib/docker/ /data/docker/

3. 修改配置

vim /etc/docker/daemon.json

{
  "data-root": "/data/docker"
}

4. 啟動(dòng) Docker

systemctl start docker

5. 驗(yàn)證

docker info | grep "Docker Root Dir"

參考資料：

1.Docker 官方文檔 · 磁盤(pán)使用分析（docker system df）

• Docker 官方對(duì)鏡像、容器、卷、構(gòu)建緩存磁盤(pán)占用的說(shuō)明。
• https://docs.docker.com/engine/reference/commandline/system_df/

2.Docker 官方文檔 · 清理未使用資源（prune）

• 詳細(xì)說(shuō)明 docker image prune、docker builder prune、docker system prune 的行為差異與風(fēng)險(xiǎn)。
• https://docs.docker.com/engine/reference/commandline/system_prune/

3.Docker 官方文檔 · BuildKit 與構(gòu)建緩存

解釋 Build Cache 的來(lái)源、生命周期以及為何會(huì)大量占用磁盤(pán)。

https://docs.docker.com/build/cache/

4.Docker 官方文檔 · daemon.json 配置項(xiàng)說(shuō)明

包含 data-root（Docker 數(shù)據(jù)目錄遷移）的官方定義與示例。

https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-configuration-fil

六、總結(jié)

以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。

最新評(píng)論