刚开源！一款轻量、高效灵活、功能强大的可视化神器

— 特色专栏 —

MySQL/PostgreSQL/MongoDB

ElasticSearch/Hadoop/Redis

Kubernetes/Docker/DevOps

Kafka/RabbitMQ/Zookeeper

监控平台/应用与服务/集群管理

Nginx/Git/Tools/OpenStack

大家好，我是民工哥！

发现一款轻量却功能强大的 Nginx 日志分析可视化工具！

刚刚开源，它就是：nginx-puls！

NginxPulse 是一个轻量级的 Nginx 访问日志分析与可视化面板开源项目，它能够帮助用户实时统计和分析 Nginx 的访问日志，提供 PV 过滤、IP 归属地与客户端解析等功能。

功能特性

实时统计：NginxPulse 能够实时解析和统计 Nginx 的访问日志，为用户提供最新的访问数据。

PV 过滤：支持对页面浏览量（PV）进行过滤，帮助用户更好地了解网站的实际访问情况。

IP 归属地与客户端解析：能够解析访问者的 IP 归属地和客户端信息，为用户提供更详细的访问者画像。

轻量级：项目采用轻量级设计，资源占用低，易于部署和使用。

技术选型

后端：使用 Go 1.23.x 语言开发，结合 Gin 框架和 Logrus 日志库，提供高效的后端服务。

数据存储：采用 SQLite 数据库进行数据存储，方便用户进行数据管理和查询。

IP 归属地解析：结合 ip2region 本地库和 ip-api.com 远程批量查询，提供准确的 IP 归属地信息。

前端：使用 Vue 3、Vite、TypeScript、PrimeVue、ECharts/Chart.js 和 Scss 等技术栈，提供美观且功能丰富的用户界面。

容器化：支持 Docker 和 Docker Compose 容器化部署，方便用户快速搭建和使用。

安装与使用

安装部署

Docker 部署

用户可以通过 Docker 或 Docker Compose 快速部署 NginxPulse，无需手动构建和配置。

docker run -d --name nginxpulse \
  -p 8088:8088 \
  -p 8089:8089 \
  -e WEBSITES='[{"name":"主站","logPath":"/share/log/nginx/access.log","domains":["kaisir.cn","www.kaisir.cn"]}]' \
  -v ./nginx_data/logs/all/access.log:/share/log/nginx/access.log:ro \
  -v "$(pwd)/var/nginxpulse_data:/app/var/nginxpulse_data" \
  magiccoders/nginxpulse:latest

手动构建：对于需要自定义配置或二次开发用户，项目提供了详细的手动构建指南，包括前端和后端的构建步骤。

NginxPulse 的项目结构清晰，主要分为以下几个部分：

cmd #程序入口目录，包含主程序文件。
internal #核心逻辑目录，包含解析、统计、存储和 API 等核心功能。
webapp #前端目录，包含前端源代码和构建脚本。
configs #配置文件目录，包含项目的核心配置文件和内置的 Nginx 配置文件。
scripts #脚本目录，包含本地一键启动脚本等实用工具。
Dockerfile 和 docker-compose.yml #容器化部署所需的文件。

配置文件

项目的核心配置文件为 configs/nginxpulse_config.json，用户可以通过修改该文件来调整项目的各项参数。

docker run -d --name nginxpulse \
  -p 8088:8088 \
  -p 8089:8089 \
  -e WEBSITES='[{"name":"主站","logPath":"/share/log/nginx/access.log","domains":["kaisir.cn","www.kaisir.cn"]}]' \
  -v ./nginx_data/logs/all/access.log:/share/log/nginx/access.log:ro \
  -v "$(pwd)/var/nginxpulse_data:/app/var/nginxpulse_data" \
  magiccoders/nginxpulse:latest

使用界面

Web 访问

• 前端：http://localhost:8088
• 后端：http://localhost:8089

结语

NginxPulse 作为一款轻量级 Nginx 访问日志分析与可视化面板，凭借其高效、灵活且功能全面的特性，为网站运维与数据分析提供了有力支持。

它不仅能够实时统计访问数据，还支持 PV 过滤、IP 归属地查询以及客户端解析，帮助用户快速洞察网站流量特征与用户行为模式。通过本地缓存与远程查询相结合的 IP 归属地策略，NginxPulse 在保证查询效率的同时，也兼顾了 IPv6 等新兴网络环境的兼容性。

此外，其基于 Go 与 Vue 的现代化技术栈，以及 Docker 容器化的部署方式，使得工具的安装、配置与扩展变得异常便捷。

无论是对于个人开发者还是企业运维团队，NginxPulse 都是一个值得尝试的 Nginx 日志分析利器，能够显著提升网站监控与数据分析的效率与准确性。

项目地址：https://github.com/likaia/nginxpulse

都看到这里了，觉得不错的话，随手点个赞👍 、推荐