⭐⭐⭐ Spring Boot 项目实战	⭐⭐⭐ Spring Cloud 项目实战
《Dubbo 实现原理与源码解析 —— 精品合集》	《Netty 实现原理与源码解析 —— 精品合集》
《Spring 实现原理与源码解析 —— 精品合集》	《MyBatis 实现原理与源码解析 —— 精品合集》
《Spring MVC 实现原理与源码解析 —— 精品合集》	《数据库实体设计合集》
《Spring Boot 实现原理与源码解析 —— 精品合集》	《Java 面试题 + Java 学习指南》

摘要: 原创出处 juejin.cn/post/7597080391880343562 「用户1701007912029」欢迎转载，保留摘要，谢谢！

🙂🙂🙂关注微信公众号：【芋道源码】有福利：

RocketMQ / MyCAT / Sharding-JDBC 所有源码分析文章列表

RocketMQ / MyCAT / Sharding-JDBC 中文注释源码 GitHub 地址

您对于源码的疑问每条留言都将得到认真回复。甚至不知道如何读源码也可以请教噢。

新的源码解析文章实时收到通知。每周更新一篇左右。

认真的源码交流微信群。

搞运维或者自己折腾服务器的朋友应该都有这个需求：想看看自己网站的访问情况。

之前试过 GoAccess、ELK 那一套，要么配置麻烦，要么太重量级。最近发现了一个叫 NginxPulse 的项目，用下来感觉还不错，分享给大家。

这是啥？

一句话：轻量级的 Nginx 日志分析面板。

能干啥：

实时看 PV/UV 数据
IP 归属地查询（国内用 ip2region 本地库，国外走 ip-api）
客户端/浏览器解析
支持多站点
支持自定义日志格式

看下效果图：

技术栈

后端是 Go + Gin，前端是 Vue3 + Vite + PrimeVue，数据库就一个 SQLite，够轻量。

IP 归属地这块挺聪明的：先查内存缓存，然后走远程 API 批量查，失败了再用本地 ip2region 兜底。既保证速度又保证准确率。

怎么跑起来

Docker 一把梭

最简单的方式，一行命令搞定：

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

把 /your/nginx/logs/access.log 换成你自己的日志路径就行。

Docker Compose

如果喜欢 compose，也行：

version: "3.8"
services:
nginxpulse:
    image:magiccoders/nginxpulse:latest
    container_name:nginxpulse
    ports:
      -"8088:8088"
      -"8089:8089"
    environment:
      WEBSITES:'[{"name":"主站","logPath":"/share/log/nginx/access.log","domains":["example.com"]}]'
    volumes:
      -./nginx_logs/access.log:/share/log/nginx/access.log:ro
      -./var/nginxpulse_data:/app/var/nginxpulse_data
    restart:unless-stopped

跑起来之后：

前端面板：http://localhost:8088
后端 API：http://localhost:8089

多网站怎么配？

如果你有多个站点，WEBSITES 传数组就行：

WEBSITES='[
  {"name":"主站","logPath":"/logs/main.log","domains":["www.example.com"]},
  {"name":"博客","logPath":"/logs/blog.log","domains":["blog.example.com"]}
]'

日志按天切割的话，支持通配符：

{"logPath": "/logs/access-*.log"}

.gz 压缩日志也能直接解析，不用手动解压。

几个实用功能

1. 远端日志拉取

日志不在本机？没关系，支持 SFTP、HTTP、S3/OSS 三种方式拉取远端日志。

比如 SFTP：

{
  "id": "sftp-main",
"type": "sftp",
"host": "1.2.3.4",
"port": 22,
"user": "nginx",
"auth": { "keyFile": "/secrets/id_rsa" },
"path": "/var/log/nginx/access.log"
}

2. Push Agent

如果服务器在内网或者边缘节点，可以用 Agent 主动推送日志。在日志服务器上跑一个轻量 agent，实时把日志推到 NginxPulse 主服务。

3. 自定义日志格式

不是默认的 combined 格式？可以自定义。支持两种方式：

方式一：直接写 log_format 语法

{
  "logFormat": "$remote_addr - $remote_user [$time_local] \"$request\" $status $body_bytes_sent"
}

方式二：正则（命名分组）

{
  "logRegex": "^(?P<ip>\\S+) - (?P<user>\\S+) \\[(?P<time>[^\\]]+)\\]..."
}

4. Caddy 也支持

用 Caddy 的朋友也能用，配置 logType: "caddy" 就行，会按 JSON 格式解析。

5. 访问控制

生产环境可以加个密钥：

ACCESS_KEYS='["your-secret-key"]'

访问时需要带上 X-NginxPulse-Key 请求头，前端会自动弹窗让你输入。

常见问题

Q：跑起来后日志明细是空的？

A：多半是权限问题。给日志目录和数据目录加个权限：

chmod -R 777 /path/to/logs /path/to/nginxpulse_data

Q：有访问但是 PV/UV 都是 0？

A：默认排除内网 IP。如果想统计内网流量，把 PV_EXCLUDE_IPS 设成空数组：

PV_EXCLUDE_IPS='[]'

单体部署

如果不想用 Docker，可以构建成单个可执行文件：

./scripts/build_single.sh

会生成一个内置前端的二进制文件，直接运行就能同时提供前后端服务。支持 amd64 和 arm64。

最后

GitHub 地址：

https://github.com/likaia/nginxpulse

在线演示：

https://nginx-pulse.kaisir.cn/

目前 1.4k star，MIT 协议，可以放心用。

如果你也在找 Nginx 日志分析工具，可以试试这个。比起重量级的 ELK 或者纯命令行的 GoAccess，这个算是个不错的中间选择。

芋道源码 —— 纯源码解析博客

终于找到一个好用的 Nginx 日志分析工具了