一款轻量级 Nginx 访问日志分析与可视化面板,支持实时统计、IP 归属地解析与客户端识别

源码:https://github.com/likaia/nginxpulse

开源协议

NginxPulse 项目,遵循 MIT 协议。这意味着你可以自由使用、修改、分发,甚至用于商业产品,只需保留原始版权声明即可。

对大多数开发者和企业来说,MIT 是最友好的开源协议之一,几乎无限制。

即刻体验一波

第一种方式:拷贝nginx日志到程序下解析

假设你有一台运行 Nginx 的服务器,日志路径为 /var/log/nginx/access.log。只需三步:

    1. 在本地创建目录:
bash 复制代码
cd /mnt
mkdir -p ./logs ./nginxpulse_data ./pgdata

###拷贝远程的nginx日志到当前目录下
cp /var/log/nginx/access.log ./logs/
    1. 启动容器:

    docker run -d --name nginxpulse
    -p 8088:8088
    -v (pwd)/logs:/share/logs:rw \ -v (pwd)/nginxpulse_data:/app/var/nginxpulse_data
    -v $(pwd)/pgdata:/app/var/pgdata
    -v /etc/localtime:/etc/localtime:ro
    magiccoders/nginxpulse:latest

    1. 浏览器打开 http://localhost:8088,按提示完成初始化。

1.4 因为是拷贝过来的日志文件,会导致文件属组不一样,无法解析日志文件

bash 复制代码
###进入容器授权
docker exec -it f79b1f8 /bin/sh
chown -R nginxpulse:nginxpulse /share/logs/

几秒后,你就能看到:

  • • 实时 PV/UV 曲线

  • • 访问来源地图(国家/城市)

  • • 客户端分布(Chrome、Safari、爬虫等)

  • • 热门页面、404 列表、Referer 分析

  • • 日志明细(支持按 IP、状态码、时间筛选)

如果日志中有内网 IP(如 192.168.x.x),默认会被排除在 PV 统计外。但你可以在配置中将 PV_EXCLUDE_IPS 设为空数组,立即纳入统计。

此外,它还能自动识别 Caddy 的 JSON 日志格式,支持自定义 Nginx log_format,甚至能解析带 $http_x_forwarded_for 的代理日志------灵活性远超普通日志分析工具。

第二种方式:程序主动去读取远程服务器的nginx日志,生产适合用

在站点与日志配置:高级来源 (sources JSON)

{ "id": "sftp-jfj", "type": "sftp", "path": "/var/log/nginx/access.log", "compression": "auto", "host": "192.168.10.1", "port": 22, "user": "root", "auth": { "password": "123456" } }

查看程序日志输出:cat /mnt/nginxpulse_data/nginxpulse.log;如下输出,说明配置成功

网站 75e7 的远端目标 /var/log/nginx/access.log 扫描完成,解析了 6 条记录

相关推荐
tianyuanwo3 小时前
PostgreSQL 部署运维实战总结:从安装踩坑到生产可用
运维·数据库·postgresql
Decay__3 小时前
SQLServer 优化案例集 —— 慢 SQL 优化、索引重构与参数调整收益对比
运维·数据库·sql·mysql·架构
优化Henry5 小时前
LTE 站点 S1 链路反复闪断导致小区频闪退服故障排查
运维·网络·学习·信息与通信·tdd
manageengine5 小时前
服务器 CPU 100% 怎么排查:8 条命令从现象定位到根因
运维·服务器·cpu
分布式存储与RustFS5 小时前
RustFS 分片上传怎么配:大文件断点续传的最小可验证流程
运维·云原生·开源·对象存储·分布式存储·s3·性能基准
爱吃香菜的初学者6 小时前
二十五.Linux——epoll
linux·运维·服务器
Csvn7 小时前
Nginx 反向代理入门:proxy_pass 两种形态、超时链与 502/504 分辨
后端·nginx
宽海智能仓储物流8 小时前
宽海智能WCS系统常见问题全解析:从选型对接、运维定制到降本增效
运维·数据仓库·自动化
无奈笑天下8 小时前
银河麒麟上DHCP无法获取IP地址问题处理
linux·运维·服务器·网络协议
分布式存储与RustFS8 小时前
Rivet 的 Agent 状态存进自建 RustFS:主桶配置与上线边界
运维·云原生·开源·对象存储·分布式存储·s3·性能基准