使用Docker Compose部署GoAccess实时日志分析系统

项目概述

GoAccess是一款开源的实时Web日志分析工具，能够快速生成可视化的访问统计报告。本文将详细介绍如何通过Docker Compose部署GoAccess，并结合Nginx实现静态网站与实时日志分析的双重功能。

系统架构设计

该部署方案采用微服务架构，主要包含以下组件：

1. Nginx容器：负责托管静态网站内容并记录访问日志
2. GoAccess容器：实时分析Nginx日志并生成可视化报告
3. Traefik（可选）：提供自动化的TLS证书管理和请求路由

准备工作

在开始部署前，请确保已准备以下目录结构：

├── configs/      # 存放Nginx和GoAccess配置文件
├── public/       # 静态网站文件存放目录
└── logs/         # Nginx日志目录（注意：未配置日志轮转）

部署方案选择

项目提供了两种部署方式，用户可根据实际需求选择：

1. 基础版(Vanilla)部署

特点：

• 需要手动管理TLS证书
• 直接暴露端口访问

配置步骤：

1. 将TLS证书放入configs/certs目录
2. 证书命名需与goaccess.vanilla.conf中的配置一致
3. 静态网页请求需路由到8080端口

2. Traefik集成版部署

优势：

• 自动管理TLS证书
• 通过子域名实现服务隔离
• 简化路由配置

前提条件：

• 已部署并配置Traefik反向代理
• 配置两个DNS记录指向服务器IP：
  • 主域名（如yourdomain.com）用于静态网站
  • 子域名（如goaccess.yourdomain.com）用于GoAccess统计面板

配置文件详解

Nginx配置

基础配置位于configs目录下，主要功能包括：

• 静态文件服务
• 访问日志记录
• 与GoAccess的WebSocket通信支持

GoAccess配置

提供两种预设配置：

• goaccess.vanilla.conf：基础版配置
• goaccess.traefik.conf：Traefik集成版配置

关键配置项包括：

• 日志格式定义
• 实时报告设置
• 输出HTML格式
• WebSocket连接参数

使用建议

1. 日志管理：当前配置未包含日志轮转，建议生产环境添加logrotate配置
2. 性能优化：高流量网站可考虑增加日志处理缓冲区
3. 安全建议：限制GoAccess面板的访问权限
4. 扩展性：可轻松扩展为多站点日志分析系统

常见问题排查

1. 证书问题：确保证书路径和权限正确
2. 端口冲突：检查8080端口是否被占用
3. 域名解析：Traefik版需确认DNS配置生效
4. 实时更新：检查WebSocket连接是否正常

进阶配置

对于有特殊需求的用户，可以考虑：

1. 集成其他日志源（如Apache）
2. 添加自定义报告模板
3. 配置邮件告警功能
4. 实现多租户日志分析

通过以上Docker Compose配置，用户可以快速搭建一个功能完善的Web日志分析系统，既满足静态网站托管需求，又能实时监控访问情况。