Star 1.4k 开源Nginx 访问日志分析与可视化面板

• 项目开发技术栈
• IP 归属地查询策略
• 如何使用项目
• 1) Docker

Nginx 的 access.log 里藏着网站的所有秘密——谁在访问、从哪来、看了什么、停留多久。但大多数人的做法是 tail -f access.log 然后肉眼扫描，或者写几行 awk 脚本凑合着看。说实话，这跟用算盘分析大数据没啥区别。

你可能会说：上 ELK 啊。但就为了分析个 Nginx 日志，搞一套 ES + Logstash + Kibana？杀鸡用牛刀，光运维成本就劝退了。

NginxPulse 就是那把"刚好够用的瑞士军刀"。 轻量级 Nginx 访问日志分析面板，实时统计、PV 过滤、IP 归属地解析、可视化报表，一个 Docker 命令就能跑起来，不需要任何外部依赖。

GitHub 地址：https://github.com/likaia/nginxpulse

技术选型：为什么是 Go + SQLite？

这套技术选型很克制。 没有用 MySQL/PostgreSQL 这类"正经"数据库，没有上 Redis 缓存，没有搞微服务架构——一个 Go 二进制 + 一个 SQLite 文件，整个应用的内存占用可能还不到 ES 的一个索引碎片。

对于个人博客、中小站点的日志分析来说，这才是正确的"量级"。

基于 Spring Boot + MyBatis Plus + Vue & Element 实现的后台管理系统 + 用户小程序，支持 RBAC 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能

• 项目地址：https://github.com/YunaiV/ruoyi-vue-pro
• 视频教程：https://doc.iocoder.cn/video/

IP 归属地查询：五层降级策略，设计得很讲究

IP 归属地解析是日志分析的核心功能之一。很多开源工具要么只支持本地库（数据老旧），要么只调远程 API（慢且有限额）。NginxPulse 搞了一套五层逐级降级策略 ，值得学习：

请求 IP → ① 快速过滤 → ② 内存缓存 → ③ 远程批量查询 → ④ 本地 ip2region → ⑤ IPv6 特殊处理

① 快速过滤（零成本）127.0.0.1、192.168.x.x、空值这类地址直接返回"本地/内网"，一次远程查询都不浪费。别笑——很多工具真的会把 127.0.0.1 发到远程 API 去查。

② 内存缓存（最多 50,000 条）大部分站点的访客 IP 是高度重复的。5 万条缓存基本能覆盖中小站点一天的独立 IP，命中率极高。

③ 远程批量查询调 ip-api.com/batch 接口，单批最多 100 个 IP，超时 1.2 秒。批量接口比逐个查效率高 10 倍以上，而且 ip-api 的免费额度（每分钟 45 次）按"请求次数"算不是按"IP 数量"算，一次请求查 100 个 IP 只算 1 次。

④ 本地兜底远程挂了或返回"未知"？没关系，ip2region 本地数据库兜底。断网照样能用，虽然准确度略低，但总比返回空白强。

⑤ IPv6 特殊处理ip2region 只支持 IPv4，IPv6 只能走远程。远程也查不到就老实返回"未知"。

部署提示 ：ip2region.xdb 内嵌在二进制中，首次启动自动解压到 ./var/nginxpulse_data/ip2region.xdb，加载向量索引提升查询性能。记得放行 ip-api.com 的出站访问，否则远程查询层直接废掉。

基于 Spring Cloud Alibaba + Gateway + Nacos + RocketMQ + Vue & Element 实现的后台管理系统 + 用户小程序，支持 RBAC 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能

• 项目地址：https://github.com/YunaiV/yudao-cloud
• 视频教程：https://doc.iocoder.cn/video/

Docker 部署：真的只要一行

整个项目打成单镜像 （前端 Nginx + 后端服务），不用分别部署前后端，不用配反向代理。

方式一：拉取远程镜像（推荐）

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

方式二：本地构建

docker build -t nginxpulse:local .

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" \
  nginxpulse:


    
local

跑起来后访问 8088 端口就能看到面板。唯一需要改的就是 WEBSITES 环境变量里的日志路径和域名。 多站点？数组里多加几个 JSON 对象就行。

适合谁用： 个人博客、中小站点、不想上 ELK 又想看日志统计的团队。大流量站点（日均百万 PV 以上）建议还是上正经的日志系统。