木-Star1. 问题背景与诊断思路
最近在Ubuntu系统上运行Docker容器时，突然收到"no space left on device"的报错。这种情况在使用Docker进行开发时并不少见，特别是当系统分区空间有限，又频繁创建和删除容器时。通过df -h命令查看磁盘使用情况，发现/var/lib/docker目录所在分区已经使用了98%的空间。
提示：Docker默认将所有镜像、容器、卷和网络配置存储在
/var/lib/docker目录下，这个位置在Ubuntu安装时通常会被分配有限的磁盘空间。
进一步分析发现，系统中存在一个名为ragflow的容器及其相关镜像占用了大量空间。这个容器可能是之前某个项目的测试环境，现在已经不再需要。在Docker生态中，这种"临时容器堆积"现象很常见，特别是当开发者快速迭代不同版本时，容易遗忘清理旧容器。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Docker存储机制深度解析
2.1 Docker存储驱动与磁盘占用
Ubuntu系统上Docker默认使用overlay2存储驱动，这种分层存储机制虽然高效，但也存在一些空间管理的特点：
-
镜像分层存储：每个Docker镜像由多个只读层组成，不同镜像可以共享相同的层。但当删除镜像时，只有独占层会被真正释放。
-
容器可写层：每个运行的容器会在镜像基础上添加一个可写层，所有修改都保存在这个层中。停止容器不会自动删除这个层。
-
卷(Volume)数据：容器挂载的卷数据独立于镜像和容器层，需要单独管理。
bash复制# 查看Docker磁盘使用详情
docker system df
输出示例：
code复制TYPE TOTAL ACTIVE SIZE RECLAIMABLE
Images 15 3 5.2GB 3.1GB (59%)
Containers 8 1 1.1GB 1.1GB (100%)
Local Volumes 5 2 3.7GB 1.2GB (32%)
Build Cache 0 0 0B 0B
2.2 为什么删除容器后空间没有释放？
很多开发者会遇到这样的困惑：明明已经删除了容器，为什么磁盘空间没有明显变化？这通常由以下原因导致：
- 关联镜像未被删除：删除容器不会自动删除其使用的镜像
- 匿名卷未被清理：容器运行时创建的匿名卷默认会保留
- 构建缓存积累：频繁的docker build会产生大量中间层缓存
3. 安全删除ragflow容器及其资源
3.1 定位目标容器及相关资源
首先需要确认ragflow容器的状态和相关信息：
bash复制# 列出所有容器(包括已停止的)
docker ps -a | grep ragflow
# 查看容器详细信息(替换CONTAINER_ID为实际ID)
docker inspect CONTAINER_ID | grep -i volume
3.2 分步骤清理流程
步骤1：停止运行中的容器
bash复制docker stop ragflow
步骤2：删除容器
bash复制docker rm ragflow
注意：如果容器创建了匿名卷，需要添加
-v参数同时删除关联卷：bash复制docker rm -v ragflow
步骤3：删除关联镜像
bash复制# 先查找ragflow使用的镜像
docker images | grep ragflow
# 删除镜像(替换IMAGE_ID为实际值)
docker rmi IMAGE_ID
步骤4：清理悬空资源
bash复制# 删除所有悬空镜像(未被任何容器引用的镜像)
docker image prune
# 删除所有未使用的卷
docker volume prune
# 全面清理(包括未使用的网络、构建缓存等)
docker system prune
4. 高级清理与空间优化技巧
4.1 批量清理策略
对于长期运行的Docker环境，建议定期执行以下命令：
bash复制# 删除所有已停止的容器
docker container prune
# 删除所有未被使用的镜像(谨慎使用，会删除暂存镜像)
docker image prune -a
# 一键清理所有可回收资源(交互式确认)
docker system prune -a
4.2 存储驱动优化配置
在/etc/docker/daemon.json中添加以下配置可以优化存储：
json复制{
"storage-driver": "overlay2",
"storage-opts": [
"overlay2.override_kernel_check=true",
"overlay2.size=20G"
]
}
修改后需要重启Docker服务：
bash复制sudo systemctl restart docker
4.3 更改Docker默认存储位置
如果系统分区空间确实有限，可以考虑将Docker数据迁移到其他分区：
bash复制# 停止Docker服务
sudo systemctl stop docker
# 复制现有数据到新位置(例如/mnt/docker)
sudo rsync -aP /var/lib/docker /mnt/docker
# 修改Docker配置
sudo nano /etc/docker/daemon.json
添加以下内容：
json复制{
"data-root": "/mnt/docker"
}
然后重启Docker：
bash复制sudo systemctl start docker
5. 预防性维护与监控方案
5.1 设置自动清理策略
在/etc/docker/daemon.json中配置自动清理：
json复制{
"features": {
"buildkit": true
},
"builder": {
"gc": {
"enabled": true,
"defaultKeepStorage": "10GB"
}
}
}
5.2 磁盘空间监控脚本
创建一个定期检查Docker磁盘使用的脚本/usr/local/bin/docker-disk-check.sh：
bash复制#!/bin/bash
THRESHOLD=80
CURRENT=$(df /var/lib/docker --output=pcent | tail -n 1 | tr -d '% ')
if [ "$CURRENT" -gt "$THRESHOLD" ]; then
echo "Docker disk usage is at ${CURRENT}% - running cleanup"
docker system prune -f
else
echo "Docker disk usage is at ${CURRENT}% - OK"
fi
设置为每日执行：
bash复制sudo chmod +x /usr/local/bin/docker-disk-check.sh
sudo ln -s /usr/local/bin/docker-disk-check.sh /etc/cron.daily/docker-disk-check
5.3 容器日志管理
容器日志也是磁盘空间的主要占用者之一，可以通过以下方式管理：
bash复制# 查看容器日志大小
docker ps -q | xargs docker inspect --format='{{.LogPath}}' | xargs ls -lh
# 全局日志大小限制(在daemon.json中)
{
"log-driver": "json-file",
"log-opts": {
"max-size": "10m",
"max-file": "3"
}
}
6. 疑难问题排查与解决
6.1 删除资源时报"device or resource busy"
当遇到资源被占用无法删除时，可以：
- 确保所有相关容器已停止
- 检查是否有其他进程占用文件：
bash复制sudo lsof | grep /var/lib/docker - 重启Docker服务后再尝试删除
6.2 空间未释放的深度处理
如果执行清理后空间仍未释放，可能是文件系统层面的问题：
bash复制# 检查文件系统错误
sudo touch /forcefsck
sudo reboot
# 或者手动执行fsck
sudo umount /var/lib/docker
sudo fsck -y /dev/sdXN # 替换为实际分区
sudo mount -a
6.3 处理残留的overlay2目录
有时直接删除/var/lib/docker/overlay2中的目录可能更有效：
- 首先停止Docker服务
- 手动检查并删除不再使用的目录
- 重启Docker服务
警告：此操作风险较高，建议先备份重要数据