在开始安装 Dozzle 之前,确保您的系统已经安装了 Docker 和 Docker Compose。如果尚未安装,您可以按照以下步骤在 Linux 系统上进行安装:
在 Ubuntu 上安装 Docker:
sudo apt-get update
sudo apt-get install docker.io
在 Ubuntu 上安装 Docker Compose:
sudo apt-get install docker-compose
在其他系统上安装 Docker 和 Docker Compose:
请根据您的操作系统,参考 Docker 官方文档进行安装。
下载 Dozzle
为了获取最新版本的 Dozzle,我们将从 GitHub 上克隆 Dozzle 仓库。执行以下命令:
git clone https://github.com/amir20/dozzle.git
这将在当前目录中创建一个名为 dozzle
的文件夹,其中包含 Dozzle 的源代码和配置文件。
配置 Dozzle
进入下载的 Dozzle 目录,并编辑 docker-compose.yml
文件以根据您的需求进行配置。打开文件:
cd dozzle
nano docker-compose.yml
在编辑器中,您可以看到一些默认的配置项,例如端口、日志文件路径等。根据您的喜好和环境,进行相应的更改。以下是一个示例配置:
version: '3'
services:
dozzle:
image: amir20/dozzle:latest
ports:
- "8080:8080"
volumes:
- "/var/run/docker.sock:/var/run/docker.sock"
请确保您了解每个配置项的含义,以便更好地满足您的需求。
启动 Dozzle
保存并退出编辑器后,使用以下命令启动 Dozzle:
docker-compose up -d
这将下载并启动 Dozzle 容器。请注意,-d
标志表示以后台模式运行容器。
现在,Dozzle 将在指定的端口上运行,并且您可以通过浏览器访问该端口以查看实时日志。
使用 Dozzle 查看实时日志
打开您喜欢的 Web 浏览器,并输入以下地址:
http://localhost:8080
请确保将端口号替换为您在 docker-compose.yml
文件中配置的端口。这将打开 Dozzle 的 Web UI。
查看容器实时日志
在 Dozzle Web UI 中,您将看到列出的 Docker 容器名称。这些名称是根据您系统上运行的容器而生成的。点击您感兴趣的容器名称,即可查看该容器的实时日志。
日志信息将按照时间戳的顺序显示,这样您可以轻松地追踪容器的活动。每条日志条目都包含时间戳、日志级别和日志消息。
过滤日志
Dozzle 提供了过滤日志的功能,让您更方便地找到关注的信息。在 Web UI 界面的搜索框中输入您感兴趣的关键字,Dozzle 将仅显示包含该关键字的日志。
例如,如果您想查看特定容器的错误日志,只需在搜索框中输入关键字 "error",Dozzle 将过滤并显示相关的日志条目。
高级配置
Dozzle 支持许多高级配置选项,可以根据您的需求进行调整。您可以在 docker-compose.yml
文件中进行相应的更改,例如更改日志文件位置、调整刷新间隔等。
如果您需要更多关于高级配置的信息,可以查阅 Dozzle 的官方文档:
https://dozzle.dev/docs
Dozzle 高级功能和生产环境配置
HTTPS 支持
在生产环境中,安全性是至关重要的。您可以通过为 Dozzle 配置 HTTPS 来保护通信。为此,您可以使用反向代理工具(如 Nginx 或 Traefik)将流量转发到 Dozzle,并在代理中配置 SSL。
以下是使用 Nginx 作为反向代理的示例:
server {
listen 443 ssl;
server_name your_domain.com;
ssl_certificate /path/to/your/certificate.crt;
ssl_certificate_key /path/to/your/private_key.key;
location / {
proxy_pass http://localhost:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
请替换 your_domain.com
、/path/to/your/certificate.crt
和 /path/to/your/private_key.key
为实际的域名和证书路径。
认证与授权
在生产环境中,您可能希望对 Dozzle 进行身份验证和授权,以确保只有授权的用户能够访问日志。这可以通过在反向代理中配置认证和授权来实现。
例如,使用 Nginx 进行基本身份验证:
location / {
proxy_pass http://localhost:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
auth_basic "Restricted Access";
auth_basic_user_file /path/to/htpasswd;
}
在这里,/path/to/htpasswd
是包含用户名和密码的文件。
多容器配置
如果您的系统中运行了多个 Docker 容器,并且您希望监控所有容器的日志,可以使用 Dozzle 的多容器配置。在 docker-compose.yml
文件中,您可以添加多个 dozzle
服务,每个服务监听一个不同的端口。
version: '3'
services:
dozzle_1:
image: amir20/dozzle:latest
ports:
- "8080:8080"
volumes:
- "/var/run/docker.sock:/var/run/docker.sock"
dozzle_2:
image: amir20/dozzle:latest
ports:
- "8081:8080"
volumes:
- "/var/run/docker.sock:/var/run/docker.sock"
这样,您可以通过访问不同的端口来查看不同容器的日志。
持久化存储
默认情况下,Dozzle 仅在容器运行时保存配置。如果您希望保留配置信息,可以将配置文件挂载到主机上。在 docker-compose.yml
中添加以下卷:
volumes:
- "./config:/app/config"
这将把配置文件保存在项目根目录下的 config
文件夹中。
通过以上配置,您可以在生产环境中更加安全和灵活地使用 Dozzle。
Dozzle 进阶用法和其他功能
日志颜色化
Dozzle 支持将日志根据日志级别进行颜色化显示,使不同级别的日志更易于区分。在 docker-compose.yml
中,您可以添加 DOZZLE_OPTIONS
环境变量来启用颜色化。
services:
dozzle:
image: amir20/dozzle:latest
ports:
- "8080:8080"
volumes:
- "/var/run/docker.sock:/var/run/docker.sock"
environment:
- DOZZLE_OPTIONS=color
这将在 Dozzle Web UI 中以不同的颜色显示不同日志级别的日志条目。
日志时间格式
如果您希望自定义显示在日志中的时间格式,可以通过在 docker-compose.yml
中添加 DOZZLE_OPTIONS
环境变量来实现。
services:
dozzle:
image: amir20/dozzle:latest
ports:
- "8080:8080"
volumes:
- "/var/run/docker.sock:/var/run/docker.sock"
environment:
- DOZZLE_OPTIONS=timeFormat=YYYY-MM-DDTHH:mm:ss.SSSZ
这将使用指定的时间格式来显示日志时间戳。在这里,YYYY-MM-DDTHH:mm:ss.SSSZ
是一个示例时间格式。
实时搜索
Dozzle 提供了实时搜索功能,让您可以快速找到特定关键字的日志。在 Web UI 的搜索框中输入关键字,Dozzle 将动态过滤显示的日志。
定制化日志显示
通过在 docker-compose.yml
中配置 DOZZLE_OPTIONS
环境变量,您可以进一步定制 Dozzle 的行为。例如,您可以设置日志条目的最大显示数、日志刷新的时间间隔等。
services:
dozzle:
image: amir20/dozzle:latest
ports:
- "8080:8080"
volumes:
- "/var/run/docker.sock:/var/run/docker.sock"
environment:
- DOZZLE_OPTIONS=maxEntries=100
在这里,maxEntries=100
将限制每个容器的最大显示日志条目数为 100。
使用 Dozzle API
Dozzle 还提供了 API,使您可以通过编程方式与 Dozzle 进行交互。通过 API,您可以获取容器列表、检索特定容器的日志等。详细的 API 文档可以在官方文档https://dozzle.dev/docs/api
中找到。
通过这些进阶用法和功能,您可以更好地适应 Dozzle 到您的日志查看和分析工作流程中。