不少用户在VPS上部署Docker应用时,刚开始运行一切正常,但过了一段时间,突然发现磁盘空间越来越少,甚至出现网站无法访问、数据库写入失败、容器异常退出等问题。
排查后才发现,真正占用磁盘空间的可能不是网站程序或数据库,而是Docker容器不断累积的运行日志。
Docker默认使用json-file日志驱动。如果没有配置日志轮转,部分容器产生的日志文件可能持续增长,最终占满整个VPS磁盘。
本文以Ubuntu和Debian系统为例,介绍如何定位占用空间最大的Docker日志文件、处理已经过大的日志,避免同样的问题再次发生。

一、为什么Docker日志会占满磁盘?
Docker容器在运行过程中,会持续产生标准输出和错误输出,例如:
- 网站访问日志和程序运行信息
- PHP、Node.js等应用的错误日志
- 数据库运行信息和连接记录
- 定时任务执行记录
- 程序异常及调试信息
Docker默认使用json-file日志驱动,将容器的标准输出和错误输出保存为JSON格式的日志文件。
在没有配置日志大小限制的情况下,这些文件可能一直增长。
举个例子,一台只有50GB SSD的VPS,部署了Nginx、MySQL、Redis以及几个业务容器。
假设其中一个应用每小时产生200MB日志,一天就会产生约4.8GB日志。连续运行一段时间后,磁盘空间很容易被消耗殆尽。
因此,部署Docker应用时,除了关注镜像、数据库和程序文件,还应该给容器日志设置合理的大小限制。
二、查看VPS磁盘空间使用情况
发现磁盘空间不足,首先要确认究竟是哪个分区出现了问题。
登录VPS,执行:
df -h
可以看到类似下面的结果:
Filesystem Size Used Avail Use%
/dev/vda1 50G 46G 4.0G 92%
这里主要关注四个参数:
- Size:磁盘总容量。
- Used:已经使用的空间。
- Avail:剩余可用空间。
- Use%:磁盘使用率。
如果发现根目录已经使用90%以上,就需要进一步排查。
接着查看Docker的数据占用情况:
docker system df
想了解得更加详细,可以执行:
docker system df -v
这里可以查看Docker镜像、容器、数据卷和构建缓存占用的空间。
需要注意,Docker系统空间统计不等于完整的容器日志统计,不能仅凭这一项就判断日志是否占满磁盘。
三、找到占用空间最大的Docker日志
这是整个排查过程中最关键的一步。
首先查看Docker的数据存储目录:
docker info --format '{{.DockerRootDir}}'
大多数Linux系统默认会使用:
/var/lib/docker
但部分用户可能修改过Docker的数据目录,因此建议以命令实际返回的路径为准。
接下来查看容器日志文件的大小:
DOCKER_ROOT=$(docker info --format '{{.DockerRootDir}}')
sudo find "$DOCKER_ROOT/containers" -type f -name '*-json.log' -printf '%s\t%p\n' | sort -nr | head -20
这条命令会找出占用空间最大的20个JSON日志文件。
输出结果中,第一列是文件大小(字节),第二列是日志文件路径。
找到可疑文件后,可以查看它属于哪个容器:
docker ps -a
然后检查容器使用的日志驱动:
docker inspect -f '{{.HostConfig.LogConfig.Type}}' 容器名称
如果返回:
json-file
说明它正在使用JSON文件日志驱动。
继续查看该容器的日志文件路径:
docker inspect -f '{{.LogPath}}' 容器名称
再检查文件大小:
sudo ls -lh "$(docker inspect -f '{{.LogPath}}' 容器名称)"
如果看到某个日志文件已经达到几GB甚至十几GB,基本就能找到磁盘空间被占用的原因。
需要注意,以上方法主要针对json-file日志驱动。如果容器使用local、journald等其他日志驱动,需要采用对应的日志管理方式。
四、如何安全处理已经过大的Docker日志?
找到大日志文件后,不建议直接使用rm删除日志,也不建议使用truncate命令直接修改Docker正在管理的日志文件。
原因是Docker的日志文件由Docker守护进程管理,直接使用外部工具修改文件,可能干扰Docker的日志系统,导致日志读取异常。
更稳妥的处理方式是配置日志限制,然后重新创建产生大量日志的容器。
假设你使用Docker Compose部署应用,可以先备份当前配置文件,确认数据库和业务数据已经保存在独立的数据卷或宿主机目录中。
然后打开docker-compose.yml。
在对应服务下添加logging配置:
services:
app:
image: your-image
logging:
driver: "json-file"
options:
max-size: "10m"
max-file: "3"
这里的两个参数非常重要。
max-size: 10m表示单个日志文件达到10MB后进行轮转。
max-file: 3表示最多保留3个日志文件。
按照这个设置,单个容器的日志文件保留量大致控制在30MB左右,实际占用可能因轮转过程和文件系统开销略有差异。
配置完成后,先检查Compose配置:
docker compose config
确认没有格式错误,再重新创建对应服务:
docker compose up -d --force-recreate app
这里的app需要替换成实际的服务名称。
重新创建容器后,旧容器会被替换,对应的旧容器日志也会随旧容器删除。
注意,不要为了清理日志执行docker compose down -v。 -v可能删除关联的数据卷,造成数据库或业务数据丢失。
另外,如果应用把重要数据直接写在容器可写层,而不是挂载的数据卷或宿主机目录中,重新创建容器也可能导致数据丢失。操作前一定要确认数据存储位置。
五、给所有Docker容器设置默认日志限制
上面介绍的是针对单个服务配置日志限制。
如果一台VPS上运行了很多Docker容器,逐个修改可能比较麻烦。这时可以直接修改Docker守护进程的默认日志配置。
打开配置文件:
sudo nano /etc/docker/daemon.json
如果文件不存在,可以新建。
加入以下内容:
{
"log-driver": "json-file",
"log-opts": {
"max-size": "10m",
"max-file": "3"
}
}
这里设置的是Docker全局默认日志策略。
保存文件后,先检查JSON格式是否正确:
python3 -m json.tool /etc/docker/daemon.json
确认没有格式错误,再重启Docker服务:
sudo systemctl restart docker
注意,重启Docker可能影响正在运行的容器,建议选择合适的维护时间操作。
还有一个容易忽略的地方。
修改daemon.json只会影响之后新创建的容器,已经存在的容器不会自动应用新设置。
因此,修改完成后,还需要根据实际部署方式重新创建原有容器。
另外,如果daemon.json原本已经有其他配置,不要直接覆盖整个文件,而应该保留原有内容,将上述日志配置合并进去。
六、检查日志限制是否生效
配置完成并重新创建容器后,可以检查容器当前的日志配置:
docker inspect -f '{{json .HostConfig.LogConfig}}' app
如果配置正确,应该能够看到类似内容:
{"Type":"json-file","Config":{"max-file":"3","max-size":"10m"}}
然后查看容器最近的日志:
docker logs --tail 50 app
最后重新检查磁盘空间:
df -h
如果磁盘空间有所恢复,并且日志配置已经生效,说明处理完成。
不过,日志轮转只是控制日志文件的增长速度,并不能解决应用本身不断输出错误日志的问题。
建议再检查一次应用运行情况:
docker logs --tail 100 app
如果发现大量重复的报错、数据库连接失败或者程序异常重试,还需要从应用本身入手修复。
七、Docker磁盘清理还有哪些误区?
这里提醒几个比较容易踩坑的地方。
首先,docker system prune主要用于清理未使用的Docker资源,例如部分无用容器、网络、镜像和构建缓存,它不是清理正在运行容器日志的专用命令。
其次,不要随意执行:
docker system prune -a --volumes
这条命令可能删除未使用的镜像、其他资源以及未被容器引用的数据卷。对于保存数据库、网站文件的VPS来说,误删数据卷可能造成严重后果。
最后,不要认为VPS磁盘越大就不需要管理日志。即使使用100GB SSD,遇到程序异常循环输出日志,也可能在很短时间内耗尽空间。
比较合理的做法是,部署Docker时就配置日志轮转,并定期检查磁盘使用情况。
常见问题FAQ
1. Docker日志默认保存在什么位置?
使用json-file日志驱动时,日志一般保存在Docker数据目录下的containers子目录中。具体路径可以通过docker inspect查看,不建议直接修改这些文件。
2. docker system prune可以清理容器日志吗?
它主要清理未使用的Docker资源,不能作为清理正在运行容器日志的解决方案。
3. 修改daemon.json后,原来的容器会自动应用日志限制吗?
不会。修改全局日志配置后,新创建的容器才会应用新设置,已有容器需要重新创建。
4. max-size设置为10m,max-file设置为3,日志最多占用30MB吗?
这是单个容器日志的近似保留上限,不是整个Docker目录的容量上限。多个容器的日志仍然需要分别计算。
5. 设置日志轮转后,还需要定期清理日志吗?
一般不需要手动清理由Docker管理的轮转日志,但仍然需要定期检查磁盘空间和应用日志,避免其他文件、数据库或数据卷持续增长。


