用心打造
VPS知识分享网站

Docker日志占满VPS磁盘怎么办?

不少用户在VPS上部署Docker应用时,刚开始运行一切正常,但过了一段时间,突然发现磁盘空间越来越少,甚至出现网站无法访问、数据库写入失败、容器异常退出等问题。

排查后才发现,真正占用磁盘空间的可能不是网站程序或数据库,而是Docker容器不断累积的运行日志。

Docker默认使用json-file日志驱动。如果没有配置日志轮转,部分容器产生的日志文件可能持续增长,最终占满整个VPS磁盘。

本文以Ubuntu和Debian系统为例,介绍如何定位占用空间最大的Docker日志文件、处理已经过大的日志,避免同样的问题再次发生。

Docker日志占满VPS磁盘怎么办?

一、为什么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管理的轮转日志,但仍然需要定期检查磁盘空间和应用日志,避免其他文件、数据库或数据卷持续增长。

赞(0)
未经允许不得转载;国外VPS测评网 » Docker日志占满VPS磁盘怎么办?
分享到