Dozzle 实时日志查看器：Docker 部署一站式容器日志监控

Dozzle vs 传统日志查看方式#

Dozzle 的定位非常明确：它不是 Loki 那样的日志中心，而是给日常排障用的实时日志仪表盘。你不需要学 LogQL、不需要搭 Elastic Stack，打开浏览器就能看到所有容器在打印什么。

环境要求#

• Docker Engine ≥ 20.10
• 需要访问 Docker Socket（/var/run/docker.sock）
• 任意 Linux 服务器，512MB 内存绰绰有余

快速部署#

最简部署方式——单行命令：

1
docker run -d \
2
  --name dozzle \
3
  -p 8080:8080 \
4
  -v /var/run/docker.sock:/var/run/docker.sock \
5
  amir20/dozzle:latest

打开 http://你的IP:8080，自动显示所有容器的日志流。

用 Docker Compose 部署（推荐）#

1
version: '3.8'
2

3
services:
4
  dozzle:
5
    image: amir20/dozzle:latest
6
    container_name: dozzle
7
    ports:
8
      - "8080:8080"
9
    volumes:
10
      - /var/run/docker.sock:/var/run/docker.sock
11
    restart: unless-stopped

启动：

1
docker compose up -d

配置 HTTPS 访问#

用 Caddy 反代：

1
logs.yourdomain.com {
2
    reverse_proxy 127.0.0.1:8080
3
}

用 Nginx Proxy Manager：

1. 添加 Proxy Host → logs.yourdomain.com
2. 转发到 127.0.0.1:8080
3. 开启 SSL 证书

1. 限制可访问的容器#

默认 Dozzle 显示所有运行中的容器。如果想限制只显示某些容器，用 --filter 参数：

1
services:
2
  dozzle:
3
    image: amir20/dozzle:latest
4
    command: --filter name=gitea --filter name=navidrome --filter name=caddy
5
    # 其他配置不变

2. 设置用户名密码（Dozzle Pro）#

Dozzle Pro 提供付费的身份验证功能。基本用法：

1
services:
2
  dozzle:
3
    image: amir20/dozzle:latest
4
    environment:
5
      - DOZZLE_AUTH_USERNAME=admin
6
      - DOZZLE_AUTH_PASSWORD=your_secure_password
7
    volumes:
8
      - /var/run/docker.sock:/var/run/docker.sock

3. 配置自动刷新间隔#

1
services:
2
  dozzle:
3
    image: amir20/dozzle:latest
4
    command: --interval 500
5
    # 默认 300ms，改为 500ms 减少 CPU 开销

4. 配合反向代理的基础认证#

用 Caddy 自带的 basicauth：

1
logs.yourdomain.com {
2
    basicauth {
3
        admin $2a$14$xxxxxx   # 用 caddy hash-password 生成
4
    }
5
    reverse_proxy 127.0.0.1:8080
6
}

快速排障流程#

1. 打开 Dozzle 的 Web 界面
2. 选择疑似出问题的容器
3. 在搜索框输入 error / panic / exception / failed
4. 时间戳旁边直接跳转到出错时刻

多窗口对比#

用浏览器的多个标签页打开 Dozzle，每个标签页看不同容器的日志流，排障效率翻倍。

手机端查看#

Dozzle 的 Web 界面响应式适配，手机浏览器也能用。在 Caddy/NPM 上配好 HTTPS，出门在外也能随时查看服务状态。

Q1: Dozzle 会保存历史日志吗？#

不会。Dozzle 是实时日志查看器，显示的是容器当前的 stdout/stderr 流。要查看历史日志，需要 Docker 的日志驱动配置了持久化（如 json-file 或 journald），Dozzle 会读取它们。

如果需要长期存储和检索日志，建议搭配 Loki + Grafana 使用。

Q2: Dozzle 占用多少资源？#

实测：展示 15 个容器的日志流时，CPU 占用约 1~3%，内存占用约 15MB。相比 Portainer（~200MB）和 Grafana（~100MB），Dozzle 几乎可以忽略不计。

Q3: 能不能看 swarm 或 k8s 的日志？#

Dozzle 主要面向单机 Docker 环境。Dozzle Pro 提供了多主机支持，但 Kubernetes 不在支持范围内。K8s 环境推荐使用 kubectl logs 或 Loki。

Q4: 和 Portainer 的日志功能比怎么样？#

Portainer 也带日志查看功能，但体验上有明显差距：

Q5: 可以设置日志保留策略吗？#

Dozzle 本身不做日志存储，所以没有保留策略。日志的保留由 Docker 的日志驱动决定：

1
# 限制每个容器最多保留 100MB 日志，最多 10 个文件
2
docker run -d --log-opt max-size=10m --log-opt max-file=10 ...

或者在 daemon.json 中全局配置：

1
{
2
  "log-driver": "json-file",
3
  "log-opts": {
4
    "max-size": "10m",
5
    "max-file": "10"
6
  }
7
}