nginx的轻量级日志分析工具GOACCESS

由于日志很多，不知道怎么处理，这几天一直在找一个能分析nginx日志的工具，知道目前网站的情况，找到了GoAccess - Downloads，部署简单，还有界面展示，准备用这个。部署简单，如果nginx用原生的COMBINED格式的额日志，那么整个流程会很简单，主要功夫浪费在了自定义的nginx日志格式写出相匹配的goaccess.conf中的log_format的正则格式。

部署下载

从GoAccess - Downloads下载goaccess-1.9.4.tar.gz文件，上传到nginx部署的服务上进行安装。

# 解压源码包
tar -zxvf /tmp/goaccess-1.9.4.tar.gz -C /tmp
cd /tmp/goaccess-1.9.4

# 配置编译选项（可选：--enable-utf8 启用 UTF-8 支持，--with-zlib 启用压缩日志）
./configure --enable-utf8 --with-zlib

# 编译并安装（需 sudo）
make && sudo make install

# 验证安装
goaccess --version

查看版本出现内容，即安装成功了。其中它的配置文件在
/usr/local/etc/goaccess/goaccess.conf位置。进入此文件，打开三个注解，time_format、date-format、log-foramt，保存退出。

修改配置文件并页面查看结果

需要提前把nginx.conf中的access.log文件设置为COMBINED格式，即在nginx.conf的http模板中设置如下

access_log /home/data/wwwlogs/nginx/http-access.log combined;

然后执行以下操作，看是否报错，如果报错，大概率是ngin日志格式无法解析

goaccess /home/data/wwwlogs/nginx/http_access.log  -p /usr/local/etc/goaccess/goaccess.conf

没有错误，就可以看到控制台展示，如下：

接下来为了方便查看，可以设置生成页面，配置nginx进行查看了。

写一个shell文件，生成一个html文件，格式如下：

# !/bin/bash  goaccess.sh
LANG="zh_CN.UTF-8"           #页面转换为中文
/usr/local/bin/goaccess /home/data/wwwlogs/nginx/http-access.log   -o /home/data/wwwlogs/index.html -p /usr/local/etc/goaccess/goaccess.conf

对这个文件授予执行权限chmod +x goaccess.sh，然后执行crontab -e，写如下内容

30 * * * * /bin/bash /home/data/script/goaccess.sh

和vim一样，保存退出即可。下面开始配置nginx，把统计页面透出去查看，在nginx的配置中增加新的配置文件goaccess-8099.conf，内容如下：

server {
   listen       8099;
   server_name 192.168.118.6:8099;

   # Allow special characters in headers
   ignore_invalid_headers off;
   # Allow any size file to be uploaded.
   # Set to a value such as 1000m; to restrict file size to a specific value
   client_max_body_size 0;
   # Disable buffering
   proxy_buffering off;
   proxy_request_buffering off;

   location / {
      alias /home/data/wwwlogs/;
      index index.html  index.htm;
      try_files $uri $uri/ /index  /index.html;

   }

}

对nginx进行reload后，即可打开页面查看。

注意： 以上的nginx的日志是默认的没有修改。

但是在实际工作中会对nginx.conf的access.log进行个性化自定义，那么就需要相匹配goaccess.conf的配置。目前有两种解决方式。

1. 再增加一个access.log的日志，不影响自定义的，但是性能会有所降低。如下图：

2. 根据nginx的日志格式，写出相匹配的goaccess.conf的log_foramt日志的正则

nginx.conf的http的日志格式：

 log_format  main  '$time_local ||  $remote_addr || $upstream_addr || $status ||  $request_time || $upstream_status || $upstream_response_time '
                      ' || $upstream_cache_status || $body_bytes_sent || $http_referer '
                      ' || $remote_user || $http_user_agent '
                      ' || $http_x_forwarded_for || $request';

相匹配的goaccess.conf的配置文件：

# 日志格式定义：使用 %d:%t %^ 来匹配日期时间字段（包括时区）
log-format %d:%t %^||%h||%v||%s||%T||%S||%R||%^||%b||%^||%^||%{Referer}i||%u||%{X-Forwarded-For}i||%r

# 日期格式：匹配日期部分（如 24/Sep/2025）
date-format %d/%b/%Y

# 时间格式：匹配时间部分（如 15:54:43）
time-format %H:%M:%S

# Locale 设置：确保英文月份缩写被正确解析
#locale en_US.UTF-8

其余操作都是一样的。