快捷導(dǎo)航

修改Docker鏡像(images)的存儲路徑的多種實(shí)現(xiàn)方式

更新時(shí)間：2026年01月23日 09:00:51 作者：用戶8612485135916

本文介紹了如何修改Docker數(shù)據(jù)根目錄以解決磁盤空間不足或希望使用更大/更快磁盤的問題,推薦通過修改daemon.json配置來實(shí)現(xiàn),并提供了詳細(xì)的步驟,需要的朋友可以參考下

要修改 Docker 鏡像（images）的存儲路徑（即 Docker 的 數(shù)據(jù)根目錄，默認(rèn)為 /var/lib/docker），可以通過以下幾種方式實(shí)現(xiàn)。這是在磁盤空間不足或希望將 Docker 數(shù)據(jù)放到更大/更快的磁盤時(shí)的常見操作。

推薦方法：修改daemon.json配置（適用于 systemd 管理的系統(tǒng)）

步驟 1：停止 Docker 服務(wù)

sudo systemctl stop docker

停止后所有容器都會停止，請確保已備份重要數(shù)據(jù)或可接受停機(jī)。

步驟 2：創(chuàng)建新目錄并遷移數(shù)據(jù)（可選但推薦）

假設(shè)你想把 Docker 數(shù)據(jù)移到 /data/docker：

# 創(chuàng)建新目錄
sudo mkdir -p /data/docker

# （可選）遷移現(xiàn)有數(shù)據(jù)（如果你已有鏡像/容器）
sudo rsync -aqxP /var/lib/docker/ /data/docker/

使用 rsync 而不是 mv，可以保留原數(shù)據(jù)作為備份，直到確認(rèn)新路徑工作正常。

步驟 3：配置 Docker 使用新路徑

編輯或創(chuàng)建 Docker 的配置文件：

sudo nano /etc/docker/daemon.json

添加以下內(nèi)容：

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

如果文件已存在其他配置，請合并 JSON，確保格式合法。

步驟 4：啟動 Docker 并驗(yàn)證

# 啟動 Docker
sudo systemctl start docker

# 檢查狀態(tài)
sudo systemctl status docker

# 查看 Docker 根目錄是否生效
docker info | grep "Docker Root Dir"

預(yù)期輸出：

Docker Root Dir: /data/docker

步驟 5：清理舊數(shù)據(jù)（確認(rèn)無誤后）

如果遷移成功且運(yùn)行正常，可刪除舊數(shù)據(jù)釋放空間：

sudo rm -rf /var/lib/docker

務(wù)必先確認(rèn)新路徑工作正常再刪除！

其他方法（不推薦）

方法 2：通過軟鏈接（Symlink）

sudo systemctl stop docker
sudo mv /var/lib/docker /data/docker
sudo ln -s /data/docker /var/lib/docker
sudo systemctl start docker

簡單，但某些工具可能不兼容符號鏈接。
不如 daemon.json 方式規(guī)范。

方法 3：修改 systemd 啟動參數(shù)（過時(shí)）

早期版本可通過修改 /etc/default/docker 或 systemd service 文件加 -g /new/path，但 Docker 官方已棄用此方式，推薦使用 daemon.json。

權(quán)限與 SELinux 注意事項(xiàng)

確保新目錄權(quán)限正確：

sudo chown root:root /data/docker
sudo chmod 700 /data/docker

如果啟用了 SELinux（如 CentOS/RHEL），可能需要調(diào)整上下文：

sudo semanage fcontext -a -t container_var_lib_t "/data/docker(/.*)?"
sudo restorecon -R /data/docker

驗(yàn)證是否生效

拉取一個(gè)新鏡像：

docker pull hello-world

檢查新路徑下是否有數(shù)據(jù)：

ls /data/docker/
# 應(yīng)看到 containers, image, overlay2, volumes 等目錄

常見錯(cuò)誤

問題	解決方案
`docker: Error response from daemon: ...`	檢查 `daemon.json` JSON 格式是否合法（可用 jsonlint.com 驗(yàn)證）
啟動失敗	查看日志：`journalctl -u docker.service -n 50`
磁盤空間未釋放	確認(rèn)是否真的遷移了數(shù)據(jù)，或舊目錄未刪除

總結(jié)

操作	命令
停止 Docker	`sudo systemctl stop docker`
配置新路徑	編輯 `/etc/docker/daemon.json`，加 `"data-root": "/your/path"`
啟動 Docker	`sudo systemctl start docker`
驗(yàn)證	`docker info \| grep "Docker Root Dir"`