在开始安装 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 到您的日志查看和分析工作流程中。
