一篇教你搞定容器日志问题

在使用 Docker 时，容器日志的无限制增长可能会导致磁盘空间被快速占满，甚至引发服务崩溃。哥们带你将从问题定位、临时解决方案、长期优化策略三个层面，手把手教你彻底解决 Docker 日志问题。

一、问题定位：日志文件在哪？

通常情况下位于Docker容器的日志默认存储在宿主机的以下路径中：

/var/lib/docker/containers/<container_id>/<container_id>-json.log

取决于你的 docker 存储目录，如需修改请结合个人环境以及项目条件进行修改，每个容器生成的日志文件通常以 *-json.log 结尾。

快速检查磁盘占用：

# 查看磁盘使用情况 
df -h 
# 找出日志目录占用空间最大的容器 
cd /var/lib/docker/containers/ 
du -sh * | sort -nr | head -n 20

二、临时解决方案：快速释放磁盘空间

方法一：使用 truncate 清空日志

# 替换为实际容器ID
container_id="your_container_id"
truncate -s 0 /var/lib/docker/containers/${container_id}/*-json.log

• 优势：保留文件 inode，不会中断正在写入的日志进程。

方法二：使用 echo 清空日志

echo "" > /var/lib/docker/containers/${container_id}/*-json.log

• 注意：可能导致日志文件 inode 变化，建议优先使用 truncate。

其实某些情况下你也可以使用docker system prune -a来进行清理未使用的容器、镜像、网络和卷。

三、长期优化策略

方法一：配置日志轮转（Log Rotation）

通过 logrotate 工具自动管理日志文件的大小和保留时间。

1. 创建配置文件 /etc/logrotate.d/docker-container-logs：

vim /etc/logrotate.d/docker-container-logs
/var/lib/docker/containers/*/*.log {
    rotate 7        # 保留7天日志
    daily           # 每天轮转一次
    compress        # 压缩旧日志
    missingok       # 文件缺失不报错
    notifempty      # 空文件不轮转
    copytruncate    # 截断原始文件前复制
}

方法二：限制单个日志文件大小

在启动容器时，通过 --log-opt 参数限制日志文件的大小和数量：

docker run -d \ 
--log-opt max-size=10m \ # 单个日志文件最大10MB 
--log-opt max-file=3 \ # 最多保留3个日志文件 
your_image_name

如果修改的是已经启动的容器配置

docker stop <container>
docker update \
  --log-driver=json-file \
  --log-opt max-size=10m \
  --log-opt max-file=3 <container>
docker start <container>

下面是我觉得一些比较适合自己公司环境的最佳实践：

四、常见问题解答

Q1：清空日志后容器异常怎么办？

A：使用 truncate -s 0 清空日志是安全的，不会中断容器运行。但如果直接删除日志文件，需重启容器才能恢复日志记录功能。

Q2：如何避免日志无限增长？

A：核心策略是限制日志大小（max-size）和集中存储（外部日志系统）。

Q3：日志清理后磁盘空间未释放？

A：可能是文件被其他进程占用，尝试重启 Docker 服务：

五、生产环境、开发环境和测试环境大小限制

可以通过设置/etc/docker/daemon.json

{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "100m",
    "max-file": "5"
  }
}

注意事项

• 现有容器不生效：修改 daemon.json 后，仅对新创建的容器生效。旧容器需手动更新日志配置（删除并重新创建）。
• 性能影响：频繁的日志轮转（小 max-size）可能增加 I/O 负载，生产环境需谨慎调整。
• 日志丢失风险：max-file=0 表示禁用日志轮转，可能导致磁盘爆满；max-file=1 会覆盖旧日志。