Docker logs 命令教程：查看容器日志（-f、--tail、--since）

docker logs 显示容器主进程的输出。调试流程见查看日志与调试。

语法

docker logs [参数] 容器

参数

示例

示例容器每秒向 stdout 输出 line N，向 stderr 输出 error N，共输出 5 次：

docker run -d --name logger alpine:3.23 sh -c 'for i in 1 2 3 4 5; do echo line $i; echo error $i >&2; sleep 1; done; sleep 600'

全部日志、最后几行、添加时间

$ docker logs logger
line 1
error 1
line 2
error 2
line 3
error 3
error 4
line 4
error 5
line 5

$ docker logs --tail 2 logger
error 5
line 5

$ docker logs -t --tail 2 logger
2026-10-13T05:28:48.681587356Z error 5
2026-10-13T05:28:48.681659184Z line 5

• 不加参数会显示全部日志，stdout 和 stderr 交错出现，顺序按时间排列。
• --tail 2 只查看最后 2 行，日志很多时一定要加上。
• -t 会添加 Docker 记录的时间（UTC），精确到纳秒。

最近一段时间

$ docker logs --since 3s logger
error 4
line 4
error 5
line 5

--since 3s 只显示最近 3 秒的日志。排查“刚才发生了什么”时，它比 --tail 更准确。

stdout 和 stderr

$ docker logs logger 2>/dev/null
line 1
line 2
line 3
line 4
line 5

$ docker logs logger 2>&1 | grep error
error 1
error 2
error 3
error 4
error 5

• docker logs 会将容器的 stdout 和 stderr 分别发送到终端的 stdout 和 stderr。
• 2>/dev/null 丢弃 stderr，只留下 line。
• 要用 grep 搜索错误信息，必须先用 2>&1 将 stderr 合并到 stdout，否则管道只会收到 stdout，什么也找不到。

持续跟踪

$ timeout 3 docker logs -f --tail 1 logger
line 5

-f 会持续等待新日志，搭配 --tail 1 时，会先显示最后一行再开始跟踪。这里用 timeout 3 让命令在 3 秒后自动结束，平时按 Ctrl+C 停止。Compose 中对应的命令是 docker compose logs -f 服务名称。

相关章节

• 查看日志与调试
• docker compose 命令：docker compose logs
• 清理硬盘空间：日志大小上限

动手练习

练习：显示 logger 容器最近 1 分钟内包含 error 的日志，并添加时间戳。

docker logs -t --since 1m logger 2>&1 | grep error

更新于 2026年10月14日