强曰为道
与天地相似,故不违。知周乎万物,而道济天下,故不过。旁行而不流,乐天知命,故不忧.
文档目录

GoAccess 日志分析完全指南

GoAccess 日志分析完全指南

GoAccess 是一款开源、实时的 Web 日志分析与交互式查看器,可在终端(Terminal)中运行,也可生成 HTML、JSON、CSV 等格式的报告。它以极低的资源占用,提供媲美商业日志分析平台的核心能力。


为什么选择 GoAccess?

特性 说明
极快的分析速度 C 语言编写,单线程即可处理 GB 级日志
🖥️ 终端实时面板 top 命令的 ncurses 交互界面
🌐 HTML 实时面板 通过 WebSocket 实现浏览器实时刷新
📊 丰富的指标 访客数、请求量、带宽、状态码、来源页、地理位置等
🔧 高度可定制 支持自定义日志格式、过滤器、配色方案
🐳 容器友好 轻松集成 Docker、CI/CD 流水线
🆓 完全免费 MIT 开源协议,无任何限制

教程目录

本教程共 12 章,从入门到高级实践,循序渐进:

章节 标题 关键内容
01 GoAccess 概述 功能特性、与 AWK/Grafana 对比、适用场景
02 安装与配置 多平台安装、编译选项、GeoIP、UTF-8 支持
03 基本使用 终端面板、HTML 报告、JSON/CSV 输出
04 日志格式详解 Apache/Nginx 格式、自定义格式、时间格式
05 实时监控 终端实时面板、WebSocket、HTML 实时面板
06 HTML 报告 自定义样式、图表、导出、自动化生成
07 过滤与排除 日期范围、状态码、IP、请求类型、排除规则
08 自定义日志处理 多虚拟主机、合并日志、轮转日志、管道输入
09 指标分析 访问量、带宽、访客、来源页、状态码深度分析
10 自动化集成 定时报告、告警、CI 集成、邮件通知
11 Docker 部署 容器化部署、Compose、与 Nginx 集成
12 最佳实践 性能优化、运维效率、监控策略、安全分析

阅读建议

  • 初学者:按章节顺序阅读 01 → 04,快速上手基本用法
  • 运维工程师:重点关注 05、07、08、10、12 章
  • Docker 用户:直接跳到第 11 章,再回看 04 和 06
  • 高级用户:第 09 章的指标分析和第 12 章的最佳实践最具参考价值

环境说明

本教程中的命令示例基于以下环境,其他系统请适当调整:

项目 版本/说明
操作系统 Ubuntu 22.04 LTS / Debian 12 / CentOS Stream 9
GoAccess 1.9+(部分特性需 1.7+)
Web 服务器 Nginx 1.24+ / Apache 2.4+
终端 支持 UTF-8 和 256 色的终端模拟器

扩展阅读