## 产品介绍

NginxPulse 是一个轻量级的 Nginx 访问日志分析与可视化面板，旨在为开发者和运维人员提供便捷的日志监控和分析工具。通过实时解析 Nginx 访问日志，提供多维度的统计指标、PV/UV 过滤、IP 归属地查询以及客户端信息解析等功能。该项目将原始的日志文件转化为直观的可视化图表，帮助用户快速了解网站流量、用户分布和访问行为。

## 主要功能

- **实时日志分析与统计**：自动扫描并解析 Nginx 访问日志（支持 gzip 压缩格式），实时统计 PV（页面浏览量）、UV（独立访客）、请求状态码分布、访问路径排行等关键指标，并以图表形式直观展示。

- **IP 归属地与客户端解析**：集成本地 ip2region 数据库与远程 ip-api.com 服务，实现 IP 地址的地理位置解析（支持 IPv4/IPv6），同时解析 User-Agent 获取客户端设备、浏览器和操作系统信息，帮助分析用户来源和访问环境。

- **灵活的数据过滤与配置**：提供可配置的 PV 过滤规则，支持排除内网 IP 或特定地址，确保统计数据的准确性。系统采用异步任务处理日志解析与 IP 归属地补齐，避免阻塞实时分析，并内置缓存机制提升查询性能。

## 配置和使用说明

安装时默认将服务器中的站点路径（默认为 `/opt/1panel/www/sites`）映射到容器内的 `/sites`，所以你启动应用后配置站点与日志时，你的日志路径应写作: 

```
/sites/<站点目录>/log/*.log
```

如果你想一次匹配全部站点，你也可以使用通配符:

```
/sites/*/log/*.log
```