Docker容器的日志管理是生产环境中不可忽视的重要环节。默认情况下，Docker会将容器的标准输出和标准错误重定向到宿主机的JSON文件中。如果不加以限制，这些日志文件会随着应用的运行无限增长，最终耗尽宿主机的磁盘空间。
为什么需要限制容器日志大小
Docker默认的日志驱动是json-file，它将日志以JSON格式存储在宿主机的特定目录下，通常是/var/lib/docker/containers/目录内。每个容器都有一个对应的JSON日志文件。这种机制虽然简单易用，但存在一个致命的缺陷：默认配置下，日志文件的大小没有上限。
假设有一个高频打印日志的应用，每秒输出几行日志，几天下来，单个容器的日志文件就可能达到几十甚至几百GB。当宿主机磁盘空间被占满时，不仅该容器无法继续写入日志，宿主机上的其他容器和系统服务也会受到影响，甚至导致整个节点宕机。这种由日志引发的磁盘爆满问题在实际运维中屡见不鲜。
因此，配置日志大小限制和轮转策略是保障系统稳定性的必要措施。日志轮转是指在日志文件达到指定大小后，将其重命名并压缩，然后创建一个新的日志文件继续写入。这样既能保留历史日志用于排查问题，又能防止单个文件无限增长。
全局配置Docker守护进程实现日志轮转
为了从根本上解决日志无限增长的问题，可以通过修改Docker守护进程的配置文件来实现全局的日志限制。这种方式适用于该宿主机上的所有容器，无论是新建的还是已经运行的，都会应用此配置。配置文件通常位于/etc/docker/daemon.json。
在这个配置文件中，可以设置日志驱动以及相关的轮转参数。主要的参数包括max-size和max-file。max-size定义了单个日志文件的最大大小，例如10m表示10MB。max-file定义了保留的日志文件数量，例如3表示最多保留3个日志文件。当日志文件达到max-size指定的大小时，Docker会进行轮转，生成新的文件，如果文件数量超过max-file，最旧的文件将被删除。
下面是一个配置示例，它将所有容器的日志限制为每个文件最大10MB，最多保留3个文件：
{
"log-driver": "json-file",
"log-opts": {
"max-size": "10m",
"max-file": "3"
}
}修改完配置文件后，需要重启Docker服务才能使配置生效。可以使用systemctl restart docker命令来重启。需要注意的是，重启Docker服务会导致所有正在运行的容器短暂中断，因此建议在业务低峰期进行操作。
针对单个容器配置日志策略
虽然全局配置可以满足大部分需求，但在某些场景下，不同的应用可能需要不同的日志策略。例如，核心业务可能需要保留更多的日志，而边缘服务则不需要太多日志。这时，可以针对单个容器进行日志配置。
在使用docker run命令启动容器时，可以通过--log-driver和--log-opt参数来指定日志驱动和选项。这种方式会覆盖全局的守护进程配置。例如，启动一个nginx容器并限制其日志大小为5MB，保留5个文件，可以使用相应的命令行参数。
对于使用Docker Compose管理的应用，可以在docker-compose.yml文件中为每个服务单独配置日志策略。这种方式更加清晰和易于维护。在服务的配置段下，添加logging字段，并指定driver和options。
下面是一个Docker Compose的配置示例，它为web服务设置了特定的日志轮转策略：
version: '3'
services:
web:
image: nginx:latest
logging:
driver: "json-file"
options:
max-size: "5m"
max-file: "5"通过这种方式，可以灵活地为不同服务定制日志策略，既满足了核心业务的日志需求，又避免了非关键服务占用过多磁盘空间。
日志轮转策略的进阶与排错
在配置日志轮转时，max-size的设置需要根据实际业务需求来定。如果设置过小，可能会导致历史日志很快被删除，无法追溯问题；如果设置过大，又起不到限制磁盘占用的作用。一般来说，对于普通应用，10MB到100MB是一个比较合理的范围。同时，max-file的设置也要考虑磁盘总容量，确保所有容器的日志总量在可控范围内。
一个常见的误区是认为修改了daemon.json配置后，现有的容器也会立即应用新的日志策略。实际上，Docker的日志配置是在容器创建时确定的。修改全局配置后，只有新建的容器会应用新配置，已经存在的容器仍然使用旧的配置。要让现有容器应用新的日志策略，必须停止并删除该容器，然后重新创建它。
如果发现日志轮转没有生效，可以使用docker inspect命令来查看容器的实际日志配置。该命令会输出容器的详细信息，其中包含LogConfig字段，显示了当前容器使用的日志驱动和选项。通过检查这个字段，可以确认配置是否正确应用。如果配置没有生效，可能是由于配置文件格式错误或者容器未重新创建。
Docker日志轮转容器日志大小限制日志配置修改时间：2026-08-21 01:21:43