gregyankovoy/goaccess

docker-goaccess镜像说明

镜像概述

本镜像基于Alpine Linux系统构建，包含集成GeoIP功能的GoAccess日志分析工具，并通过nginx反向代理GoAccess生成的HTML文件及websockets，用户无需额外配置即可直接访问日志分析内容。

核心功能

1. 提供GoAccess日志分析能力，支持访问数据统计与GeoIP地域定位
2. 通过nginx反向代理简化访问流程，无需独立部署Web服务
3. 支持配置持久化与日志目录映射，便于自定义分析场景

使用场景

• 分析Nginx服务器访问日志，获取访问趋势、来源地域等关键数据
• 快速部署轻量级日志可视化服务，适用于小型网站或个人项目
• 无需复杂环境搭建即可实现日志实时分析与展示

配置说明

部署示例（docker run）

bash
docker run --name goaccess -p 7889:7889 -v /本地/nginx/logs路径:/opt/log -v /本地/goaccess存储路径:/config -d gregyankovoy/goaccess

卷挂载

• /config：存储GoAccess配置文件及生成的静态HTML分析结果
• /opt/log：映射到Nginx日志目录，供GoAccess读取分析

环境变量

• PUID：运行nginx和GoAccess的用户ID
• PGID：运行nginx和GoAccess的用户组ID

关键文件

• /config/goaccess.conf：GoAccess配置文件（默认填充基础配置，可自定义修改）
• /config/html：GoAccess生成的静态HTML分析页面

反向代理配置（Nginx）

nginx
location ^~ /goaccess {
    resolver 127.0.0.11 valid=30s;
    set $upstream_goaccess goaccess;
    proxy_pass [***]

    proxy_connect_timeout 1d;
    proxy_send_timeout 1d;
    proxy_read_timeout 1d;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "Upgrade";
}