Docker logs 命令用于查看和管理容器日志，支持实时跟踪、时间过滤及格式控制。文章解析了常用参数、日志驱动架构及生产环境应用案例，涵盖 Web 监控、故障分析及多容器聚合场景。同时提供性能优化、安全实践及常见问题解决方案，推荐结合 ELK 等系统实现集中化管理。
docker logs 是 Docker 中最常用的日志管理命令，它允许用户查看容器内应用程序生成的日志输出。作为容器化应用监控和故障排查的核心工具，掌握其各种用法对于运维和开发人员至关重要。
docker logs [OPTIONS] CONTAINER
| 参数 | 说明 | 示例 | 应用场景 |
|---|---|---|---|
-f, --follow | 实时跟踪日志输出 | -f | 实时监控应用日志 |
--since | 显示指定时间后的日志 | --since "2023-01-01" | 故障时间点后的日志分析 |
-t, --timestamps | 显示时间戳 | -t | 需要时间标记的日志分析 |
--tail | 显示最后 N 行日志 | --tail 100 | 快速查看最新日志 |
--details | 显示额外详细信息 | --details | 调试复杂问题 |
--until | 显示指定时间前的日志 | --until "2023-12-31" | 历史日志分析 |
--no-trunc | 显示完整日志行 | --no-trunc | 查看完整日志内容 |
Docker 日志系统主要包含以下组件：
-f 参数，则持续监控新日志。具体驱动支持情况请参考官方文档。
docker logs my_container
典型输出：
text
/docker-entrypoint.sh: Configuration complete; ready for start up
2025/06/30 14:01:10 [notice] 1#1: using the "epoll" event method
2025/06/30 14:01:10 [notice] 1#1: nginx/1.29.0
...
docker logs -ft my_container
docker logs --since "30m ago" --until "10m ago" my_container
docker logs --no-trunc my_container
docker logs --tail 50 --timestamps my_container
watch -n 1 'docker logs --tail 20 -t my_web_service | grep -E "ERROR|WARN"'
docker logs --since "2023-07-25T14:30:00" --until "2023-07-25T14:35:00" --details app_container > crash_report.log
for container in $(docker ps -q); do
echo "=== $container logs ==="
docker logs --tail 5 "$container"
done
| 驱动类型 | 性能 | 功能 | 适用场景 |
|---|---|---|---|
| json-file | 中 | 基础 | 开发环境 |
| journald | 高 | 丰富 | systemd 系统 |
| syslog | 中 | 网络 | 集中式日志 |
| fluentd | 低 | 强大 | 日志分析系统 |
日志驱动选择：
docker run --log-driver=journald my_image
使用时间范围过滤：
docker logs --since "5m ago" my_container
合理限制日志量：
docker logs --tail 1000 my_container
日志归档策略：
find /var/lib/docker/containers -name "*.log" -mtime +7 -exec gzip {} \;
日志权限控制：
chmod 640 /var/lib/docker/containers/*/*.log
敏感信息过滤：
docker logs my_container | grep -v "password"
问题 1：日志文件过大 解决：配置日志轮转
docker run --log-opt max-size=10m --log-opt max-file=3 my_image
问题 2：日志显示不完整
解决：使用 --no-trunc
docker logs --no-trunc my_container
问题 3：时间戳不准确 解决：统一时区
docker run -e TZ=Asia/Shanghai my_image
docker logs build_container | tee build.log
if grep -q "BUILD FAILED" build.log; then
exit 1
fi
docker logs -f my_container | while read line; do
if [[ "$line" == *"ERROR"* ]]; then
send_alert "$line"
fi
done
docker logs --since "1h ago" my_app | awk '/ERROR/{err++} /WARN/{warn++} END{print "Errors:", err, "Warnings:", warn}'
docker logs 常与以下工具配合使用：
通过本文，您应该已经掌握：
终极实践建议：
扩展阅读方向：
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online