修改 Docker 镜像（images）的存储路径

要修改 Docker 镜像（images）的存储路径（即 Docker 的 数据根目录，默认为 /var/lib/docker），可以通过以下几种方式实现。这是在磁盘空间不足或希望将 Docker 数据放到更大/更快的磁盘时的常见操作。

---

✅ 推荐方法：修改 daemon.json 配置（适用于 systemd 管理的系统）

步骤 1：停止 Docker 服务

sudo systemctl stop docker

⚠️ 停止后所有容器都会停止，请确保已备份重要数据或可接受停机。

---

步骤 2：创建新目录并迁移数据（可选但推荐）

假设你想把 Docker 数据移到 /data/docker：

# 创建新目录
sudo mkdir -p /data/docker

# （可选）迁移现有数据（如果你已有镜像/容器）
sudo rsync -aqxP /var/lib/docker/ /data/docker/

🔍 使用 rsync 而不是 mv，可以保留原数据作为备份，直到确认新路径工作正常。

---

步骤 3：配置 Docker 使用新路径

编辑或创建 Docker 的配置文件：

sudo nano /etc/docker/daemon.json

添加以下内容：

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

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

---

步骤 4：启动 Docker 并验证

# 启动 Docker
sudo systemctl start docker

# 检查状态
sudo systemctl status docker

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

预期输出：

Docker Root Dir: /data/docker

---

步骤 5：清理旧数据（确认无误后）

如果迁移成功且运行正常，可删除旧数据释放空间：

sudo rm -rf /var/lib/docker

❗ 务必先确认新路径工作正常再删除！

---

⚠️ 其他方法（不推荐）

方法 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 方式规范。

方法 3：修改 systemd 启动参数（过时）

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

---

🔒 权限与 SELinux 注意事项

• 确保新目录权限正确：

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

• 如果启用了 SELinux（如 CentOS/RHEL），可能需要调整上下文：

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

---

📌 验证是否生效

1. 拉取一个新镜像：

   docker pull hello-world
   

2. 检查新路径下是否有数据：

   ls /data/docker/
   # 应看到 containers, image, overlay2, volumes 等目录
   

---

❌ 常见错误

问题	解决方案
docker: Error response from daemon: ...	检查 daemon.json JSON 格式是否合法（可用 jsonlint.com 验证）
启动失败	查看日志：journalctl -u docker.service -n 50
磁盘空间未释放	确认是否真的迁移了数据，或旧目录未删除

---

✅ 总结

操作	命令
停止 Docker	sudo systemctl stop docker
配置新路径	编辑 /etc/docker/daemon.json，加 "data-root": "/your/path"
启动 Docker	sudo systemctl start docker
验证	docker info | grep "Docker Root Dir"

💡 最佳实践：在新服务器部署时就配置好 data-root，避免后期迁移。