容器与云原生 / 系统课时
容器日志为什么会占满磁盘
容器日志为什么会占满磁盘
容器本身看起来没有新增文件,宿主机磁盘却可能持续下降,一个常见原因是标准输出被 Docker 日志驱动不断写入宿主机。理解日志从 stdout/stderr 到宿主机文件的路径后,就能找到实际占用,并用轮转限制避免日志无限增长。
学习目标
- 理解容器日志如何持续消耗宿主机空间
- 找到容器实际日志文件并检查其占用
- 使用日志轮转限制单个容器的日志增长
日志空间为什么会一直增加
应用写到 stdout/stderr 的内容不会凭空消失。Docker logging driver 会接收这些记录;在常见的 json-file 驱动下,记录会落到 Docker 数据目录中的日志文件。如果没有配置轮转,持续高频输出就会让文件不断变大。

需要区分两种“占空间”:应用主动写入容器可写层或挂载卷,是业务文件占用;应用向 stdout/stderr 打日志,则由 logging driver 管理。后者即使应用目录里看不到大文件,也可能吃掉宿主机磁盘。
找到实际日志文件
在 Linux 上使用本机 Docker Engine,并且当前日志驱动提供文件路径时,可以通过 docker inspect 查看 LogPath。下面创建一个产生一批日志后保持运行的测试容器,再读取其日志文件大小。
docker rm -f log-fill-demo >/dev/null 2>&1 || true
docker run -d --name log-fill-demo alpine:3.20 sh -c 'i=0; while [ $i -lt 20000 ]; do echo this-is-a-repeated-log-line-that-demonstrates-growth; i=$((i+1)); done; sleep 300' >/dev/null
sleep 2
LOG_PATH=$(docker inspect -f '{{.LogPath}}' log-fill-demo)
echo "$LOG_PATH"
sudo du -h "$LOG_PATH"
docker rm -f log-fill-demo >/dev/null预期输出:
/var/lib/docker/containers/<ID>/<ID>-json.log
<SIZE> /var/lib/docker/containers/<ID>/<ID>-json.log<ID> 和 <SIZE> 会因环境与日志驱动不同而变化。Docker Desktop 通常把 Docker Engine 运行在虚拟机里,宿主操作系统未必能直接访问这里显示的 Linux 路径,因此不要把路径差异误判成“没有日志”。
用轮转限制增长
对 json-file 驱动,可以在创建容器时设置 max-size 和 max-file。前者控制单个日志文件达到多大时轮转,后者控制保留多少个日志文件。
docker rm -f capped-log >/dev/null 2>&1 || true
docker run -d --name capped-log --log-driver json-file --log-opt max-size=10m --log-opt max-file=3 nginx:alpine >/dev/null
docker inspect -f '{{.HostConfig.LogConfig.Type}} {{index .HostConfig.LogConfig.Config "max-size"}} {{index .HostConfig.LogConfig.Config "max-file"}}' capped-log
docker rm -f capped-log >/dev/null预期输出:
json-file 10m 3这表示该容器的 json-file 日志按约 10 MiB 单文件轮转,并最多保留 3 个日志文件。实际总占用还会有少量元数据和文件系统开销,因此不要把 10m × 3 当作精确上限。
为什么改了配置却没有生效
日志驱动和轮转选项是在容器创建时确定的。修改 Docker daemon 的默认日志配置,只会影响之后新创建的容器;已经存在的容器不会自动切换参数,通常需要按原业务配置重新创建。
如果磁盘告警已经发生,先用 docker inspect 找到高增长容器,确认它是否存在异常刷日志;再修复应用的重复报错或调低无意义日志级别,同时为新建容器设置合理轮转。只限制文件大小而不处理持续报错,虽然能保护磁盘,却会掩盖真正的运行问题。
日志管理的目标不是“把日志删掉”,而是让日志量、保留时间和故障排查需求保持可控:应用避免无意义高频输出,Docker 负责轮转,监控再对磁盘使用率和日志增长速度做预警。