Skip to content
/ nginxpulse Public
forked from likaia/nginxpulse

轻量级 Nginx 访问日志分析与可视化面板，提供实时统计、PV 过滤、IP 归属地与客户端解析。

License

MIT license
0 stars 89 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

itsharex/nginxpulse

BranchesTags
 
 

Repository files navigation

NginxPulse Logo

English | 简体中文

NginxPulse

轻量级 Nginx 访问日志分析与可视化面板，提供实时统计、PV 过滤、IP 归属地与客户端解析。

demo-img-1.png

demo-img-2.png

目录

项目开发技术栈

  • 后端：Go 1.23.x · Gin · Logrus
  • 数据：SQLite (modernc.org/sqlite)
  • IP 归属地：ip2region（本地库） + ip-api.com（远程批量）
  • 前端：Vue 3 · Vite · TypeScript · PrimeVue · ECharts/Chart.js · Scss
  • 容器：Docker / Docker Compose · Nginx（前端静态部署）

IP 归属地查询策略

  1. 快速过滤：空值/本地/回环地址返回“本地”，内网地址返回“内网/本地网络”。
  2. 缓存优先：内存缓存命中直接返回（最多缓存 50,000 条）。
  3. 远程优先：调用 ip-api.com/batch 批量查询，超时 1.2s，单批最多 100 个。
  4. 本地兜底：远程失败或结果为“未知”时，IPv4 使用内置 ip2region 数据库本地查询（50ms 超时）。
  5. IPv6 处理：仅走远程查询，远程失败则返回“未知”。

本地数据库 ip2region.xdb 内嵌在二进制中，首次启动会自动解压到 ./var/nginxpulse_data/ip2region.xdb，并尝试加载向量索引提升查询性能。

本项目会访问外网 IP 归属地 API（ip-api.com），部署环境需放行该域名的出站访问。

如何使用项目

1) Docker

单镜像（前端 Nginx + 后端服务）：

使用远程镜像（Docker Hub）：

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

多架构镜像（amd64/arm64）构建与发布：

./scripts/publish_docker.sh -r <repo> -p linux/amd64,linux/arm64

仅本地构建指定架构示例：

docker buildx build --platform linux/arm64 -t nginxpulse:local --load .

GitHub Actions 自动发布（多架构镜像）：

  • 在仓库 Secrets 中配置：
    • DOCKERHUB_USERNAME
    • DOCKERHUB_TOKEN
    • DOCKERHUB_REPO（例如：username/nginxpulse）
  • 推送 v* tag 或发布 Release 时触发。

如果更偏好配置文件方式，可将 configs/nginxpulse_config.json 挂载到容器内的 /app/configs/nginxpulse_config.json。

2) Docker Compose

使用远程镜像（Docker Hub）：将 docker-compose.yml 改为下方远程镜像版本，然后执行：

docker compose up -d

本地构建运行（基于源码构建镜像）：保持仓库自带的 docker-compose.yml，执行：

docker compose up -d --build

示例 docker-compose.yml（远程镜像）：

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":["kaisir.cn","www.kaisir.cn"]}]'
    volumes:
      - ./nginx_data/logs/all/access.log:/share/log/nginx/access.log:ro
      - ./var/nginxpulse_data:/app/var/nginxpulse_data
      - /etc/localtime:/etc/localtime:ro
    restart: unless-stopped

示例 docker-compose.yml（本地构建）：

version: "3.8"
services:
  nginxpulse:
    image: nginxpulse:local
    build:
      context: .
    container_name: nginxpulse
    ports:
      - "8088:8088"
      - "8089:8089"
    environment:
      WEBSITES: '[{"name":"主站","logPath":"/share/log/nginx/access.log","domains":["kaisir.cn","www.kaisir.cn"]}]'
    volumes:
      - ./nginx_data/logs/all/access.log:/share/log/nginx/access.log:ro
      - ./var/nginxpulse_data:/app/var/nginxpulse_data
      - /etc/localtime:/etc/localtime:ro
    restart: unless-stopped

说明：

  • logPath 必须是容器内路径，确保与挂载目录一致。
  • var/nginxpulse_data 挂载用于持久化数据库和解析缓存，推荐保留。

参数说明（环境变量）：

  • WEBSITES（必填，无配置文件时）
    • 网站列表 JSON 数组，字段：name、logPath、domains（可选）。
    • domains 用于将 referer 归类为“站内访问”，不影响日志解析与 PV 过滤。
  • CONFIG_JSON（可选）
    • 完整配置 JSON 字符串（等同于 configs/nginxpulse_config.json 内容）。
    • 设置后会忽略本地配置文件，其他环境变量仍可覆盖其中字段。
  • LOG_DEST（可选，默认：file）
    • 日志输出位置：file 或 stdout。
  • TASK_INTERVAL（可选，默认：1m）
    • 扫描间隔，支持 5m、25s 等 Go duration 格式。
  • LOG_RETENTION_DAYS（可选，默认：30）
    • 日志保留天数，超过天数会清理数据库中的旧日志。
  • DEMO_MODE（可选，默认：false）
    • 开启演示模式，定时生成模拟日志并直接写入数据库（不再解析日志文件）。
  • ACCESS_KEYS（可选，默认：空）
    • 访问密钥列表（JSON 数组或逗号分隔），配置后将启用访问限制。
  • APP_LANGUAGE（可选，默认：zh-CN）
    • 系统默认语言，支持 zh-CN / en-US（也接受 zh、en）。
    • 会同步影响 IP 归属地在线查询返回语言。
  • SERVER_PORT（可选，默认：:8089）
    • 服务监听地址，可传 :8089 或 8089，不带冒号会自动补上。
  • PV_STATUS_CODES（可选，默认：[200]）
    • 统计 PV 的状态码列表，可用 JSON 数组或逗号分隔值。
  • PV_EXCLUDE_PATTERNS（可选，默认内置规则）
    • 全局 URL 排除正则数组（JSON 数组）。
  • PV_EXCLUDE_IPS（可选，默认：空或配置文件）
    • 排除 IP 列表（JSON 数组或逗号分隔）。

访问：

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

前端语言：

  • 默认语言由后端 APP_LANGUAGE / 配置文件 system.language 决定。
  • 可通过 URL 参数覆盖：?lang=en 或 ?locale=en-US。

PV_EXCLUDE_PATTERNS和PV_EXCLUDE_IPS的具体格式请参考nginxpulse_config.json

3) 手动构建（前端、后端）

前端构建：

cd webapp
npm install
npm run build

后端构建：

go mod download
go build -o bin/nginxpulse ./cmd/nginxpulse/main.go

本地开发（前后端一起跑）：

./scripts/dev_local.sh

前端开发服务默认端口 8088，并会将 /api 代理到 http://127.0.0.1:8089。 本地开发前请准备好日志文件，放在 var/log/ 下（或确保 configs/nginxpulse_config.json 的 logPath 指向对应文件）。

4) 单体部署（单进程）

如果你希望只分发一个可执行文件（内置前端静态资源），可以使用：

./scripts/build_single.sh

执行后会生成单体可执行文件（已内置前端静态资源），启动后即可同时提供前后端服务：

  • 前端：http://localhost:8088
  • 后端：http://localhost:8088/api/...

默认会构建 linux/amd64 和 linux/arm64，产物在： bin/linux_amd64/nginxpulse 与 bin/linux_arm64/nginxpulse。

指定目标平台示例：

GOOS=linux GOARCH=amd64 ./scripts/build_single.sh
GOOS=linux GOARCH=arm64 ./scripts/build_single.sh

单体部署的配置方式

单体运行时读取配置有两种方式（任选其一）：

方式 A：配置文件（默认）

  1. 在运行目录创建 configs/
  2. 放入 configs/nginxpulse_config.json
  3. 启动：./nginxpulse

方式 B：环境变量注入（无需文件）

CONFIG_JSON="$(cat /path/to/nginxpulse_config.json)" ./nginxpulse

注意事项：

  • 配置文件路径为相对路径 ./configs/nginxpulse_config.json，请确保运行时工作目录正确。
  • 如果使用 systemd，请设置 WorkingDirectory，或改用 CONFIG_JSON 注入。
  • 数据目录 ./var/nginxpulse_data 也是相对路径；找不到目录时请先确认当前进程的工作目录。

5) Makefile 构建

此项目也支持了通过Makefile来构建相关资源，命令如下：

make frontend   # 构建前端 webapp/dist
make backend    # 构建后端 bin/nginxpulse（不内嵌前端）
make single     # 构建单体包（内嵌前端 + 复制配置与gzip示例）
make dev        # 启动本地开发（前端8088，后端8089）
make clean      # 清理构建产物

指定版本号示例：

VERSION=v0.4.8 make single
VERSION=v0.4.8 make backend

说明：

  • make single 默认构建 linux/amd64 与 linux/arm64，产物在 bin/linux_amd64/ 与 bin/linux_arm64/。
  • 单平台构建时，产物在 bin/nginxpulse，配置在 bin/configs/nginxpulse_config.json（端口默认 :8088），gzip 示例在 bin/var/log/gz-log-read-test/。

多个日志文件如何挂载？

WEBSITES 它的值是个数组，参数对象中传入网站名、网址、日志路径（这个路径为容器内访问的路径，可按照需求随意指定）。 参考示例:

environment:
  WEBSITES: '[{"name":"网站1","logPath":"/share/log/nginx/access-site1.log","domains":["www.kaisir.cn","kaisir.cn"]}, {"name":"网站2","logPath":"/share/log/nginx/access-site2.log","domains":["home.kaisir.cn"]}]'
volumes:
  - ./nginx_data/logs/site1/access.log:/share/log/nginx/access-site1.log:ro
  - ./nginx_data/logs/site2/access.log:/share/log/nginx/access-site2.log:ro

如果你有很多个网站要分析，一个个挂载太麻烦，你可以考虑将日志目录整体挂载进去，然后在WEBSITES里去指定具体的日志文件即可。

比如：

environment:
  WEBSITES: '[{"name":"网站1","logPath":"/share/log/nginx/access-site1.log","domains":["www.kaisir.cn","kaisir.cn"]}, {"name":"网站2","logPath":"/share/log/nginx/access-site2.log","domains":["home.kaisir.cn"]}]'
volumes:
  - ./nginx_data/logs:/share/log/nginx/

注意：如果你的nginx日志是按天进行切割的，可以使用 * 来替代日期，比如：{"logPath": "/share/log/nginx/site1.top-*.log"}

压缩日志（.gz）

支持直接解析 .gz 压缩日志，logPath 可指向单个 .gz 文件或使用通配符：

{"logPath": "/share/log/nginx/access-*.log.gz"}

项目内提供了 gzip 参考样例：var/log/gz-log-read-test/。

自定义日志格式

支持为每个网站单独配置日志格式，也可以指定日志类型 logType（默认 nginx，Caddy 见下节）。

日志类型（logType）：

  • nginx（默认）：按 Nginx access log 解析（兼容默认 combined 格式）。

方式 A：logFormat（Nginx log_format 语法）

{
  "name": "主站",
  "logPath": "/share/log/nginx/access.log",
  "logType": "nginx",
  "logFormat": "$remote_addr - $remote_user [$time_local] \"$request\" $status $body_bytes_sent \"$http_referer\" \"$http_user_agent\""
}

当前支持的变量： $remote_addr $remote_user $time_local $time_iso8601 $request $request_method $request_uri $uri $status $body_bytes_sent $bytes_sent $http_referer $http_user_agent

方式 B：logRegex（正则，命名分组）

{
  "name": "主站",
  "logPath": "/share/log/nginx/access.log",
  "logType": "nginx",
  "logRegex": "^(?P<ip>\\S+) - (?P<user>\\S+) \\[(?P<time>[^\\]]+)\\] \"(?P<request>[^\"]+)\" (?P<status>\\d+) (?P<bytes>\\d+) \"(?P<referer>[^\"]*)\" \"(?P<ua>[^\"]*)\"$"
}

命名分组要求（至少包含）：

  • IP：ip / remote_addr
  • 时间：time / time_local / time_iso8601
  • 状态码：status
  • URL：url / request_uri / uri 或 request（会从 request 中拆 method + url）

可选时间解析格式（Go time layout）：

{
  "timeLayout": "2006-01-02T15:04:05+08:00"
}

未配置时会自动尝试默认格式（time_local）、RFC3339/RFC3339Nano，以及时间戳（秒/毫秒）。

Caddy 日志支持

支持 Caddy 默认 JSON access log（每行一条 JSON）。

示例配置：

{
  "name": "Caddy 站点",
  "logPath": "/share/log/caddy/access.log",
  "logType": "caddy"
}

示例日志格式（单行 JSON）：

{"ts":1705567800.123,"level":"info","logger":"http.log.access","msg":"handled request","request":{"remote_ip":"203.0.113.10","method":"GET","uri":"/","headers":{"User-Agent":["Mozilla/5.0"],"Referer":["-"]}},"status":200,"size":1234}

解析字段说明：

  • 时间：ts / time / timestamp（支持秒/毫秒或 RFC3339 字符串）
  • IP：request.remote_ip / request.client_ip
  • 方法与路径：request.method + request.uri
  • 状态码：status
  • 大小：size（可选）
  • UA/Referer：request.headers.User-Agent / request.headers.Referer（可选）

项目内示例文件：var/log/nginx-pulse-demo/access_caddy.json。

访问密钥列表（ACCESS_KEYS）

当 accessKeys 配置为非空数组时，访问 UI 和 API 都需要提供密钥。默认值为空数组

配置文件方式（推荐）：

{
  "system": {
    "accessKeys": ["key-1", "key-2"]
  }
}

环境变量方式：

ACCESS_KEYS='["key-1","key-2"]' ./nginxpulse

Docker Compose 方式：

services:
  nginxpulse:
    environment:
      ACCESS_KEYS: '["key-1","key-2"]'

请求头要求：

  • API 请求需带 X-NginxPulse-Key: <your-key>。
  • 前端访问会自动弹窗提示输入密钥（存储在localStorage中）。

关闭密钥：

  • 不配置 accessKeys 或配置为空数组即可关闭。

二次开发注意事项

环境依赖

  • Go 1.23.x（与 go.mod 保持一致）
  • Node.js 20+ / npm
  • Docker（可选，用于容器化）

配置与数据目录

  • 配置文件：configs/nginxpulse_config.json
  • 数据目录：var/nginxpulse_data/（相对当前工作目录）
    • nginxpulse.db：SQLite 数据库
    • nginx_scan_state.json：日志扫描游标
    • ip2region.xdb：IP 本地库
  • 维表去重版本首次启动会自动迁移旧日志表结构（数据量大时需等待迁移完成），并在清理日志时自动回收维表孤儿数据。
  • 数据库内包含维表与聚合表（*_dim_*、*_agg_*），用于去重和统计加速。
  • 环境变量覆盖：
    • CONFIG_JSON / WEBSITES
    • LOG_DEST / TASK_INTERVAL / SERVER_PORT
    • PV_STATUS_CODES / PV_EXCLUDE_PATTERNS / PV_EXCLUDE_IPS

大日志解析策略

  • 默认先解析最近 7 天的数据，保证前台查询能尽快返回。
  • 历史数据通过后台分批回填（按时间/字节预算），避免阻塞周期性扫描。
  • 当前台查询的时间范围仍在回填中时，会提示“所选范围仍在解析中，数据可能不完整”。

Nginx 日志格式

默认解析模式基于典型的 access log 格式：

<ip> - <user> [time] "METHOD /path HTTP/1.x" status bytes "referer" "ua"

如果你的 Nginx 使用自定义 log_format，需要同步调整 internal/ingest/log_parser.go 中的正则。

示例日志：

4.213.160.187 - - [31/Dec/2025:15:40:45 +0800] "GET /wp-includes/index.php HTTP/1.1" 404 41912 "https://www.google.fr/" "Mozilla/5.0 (Linux; Android 13; SM-S908E) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Mobile Safari/537.36"
4.213.160.187 - - [31/Dec/2025:15:40:46 +0800] "GET /wp-includes/js/crop/cropper.php HTTP/1.1" 404 41912 "https://www.yahoo.com/" "Mozilla/5.0 (Linux; Android 12; 2201116SG) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Mobile Safari/537.36"
4.213.160.187 - - [31/Dec/2025:15:40:48 +0800] "GET /wp-includes/js/dist/ HTTP/1.1" 404 41912 "https://www.google.fr/" "Mozilla/5.0 (iPhone; CPU iPhone OS 17_1_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.1 Mobile/15E148 Safari/604.1"
10.10.0.1 - - [31/Dec/2025:15:40:48 +0800] "GET / HTTP/1.1" 200 19946 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 SafeLine-CE/v9-2-8"
4.213.160.187 - - [31/Dec/2025:15:40:49 +0800] "GET /wp-includes/js/index.php HTTP/1.1" 404 41905 "https://www.yahoo.com/" "Mozilla/5.0 (Linux; Android 13; M2101K6G) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Mobile Safari/537.36"
4.213.160.187 - - [31/Dec/2025:15:40:50 +0800] "GET /wp-includes/widgets/autoload_classmap.php HTTP/1.1" 404 41905 "https://www.google.co.uk/" "Mozilla/5.0 (Linux; Android 10; LM-Q720) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Mobile Safari/537.36"
4.213.160.187 - - [31/Dec/2025:15:40:51 +0800] "GET /wp.php HTTP/1.1" 404 41905 "https://www.google.de/" "Mozilla/5.0 (Linux; Android 12; SM-A525F) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/117.0.0.0 Mobile Safari/537.36"
4.213.160.187 - - [31/Dec/2025:15:40:52 +0800] "GET /.well-known/rk2.php HTTP/1.1" 404 41905 "https://www.google.co.uk/" "Mozilla/5.0 (iPhone; CPU iPhone OS 15_7_9 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6.5 Mobile/15E148 Safari/604.1"
4.213.160.187 - - [31/Dec/2025:15:40:53 +0800] "GET /.well-known/x.php HTTP/1.1" 404 41905 "https://www.google.com/" "Mozilla/5.0 (Linux; Android 14; Pixel 8 Pro) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Mobile Safari/537.36"
4.213.160.187 - - [31/Dec/2025:15:40:54 +0800] "GET /wp-admin/maint/chosen.php HTTP/1.1" 404 41905 "https://www.google.com/" "Mozilla/5.0 (Linux; Android 10; LM-Q720) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Mobile Safari/537.36"
4.213.160.187 - - [31/Dec/2025:15:40:55 +0800] "GET /wp-admin/network/autoload_classmap.php HTTP/1.1" 404 41912 "https://duckduckgo.com/" "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0.1 Mobile/15E148 Safari/604.1"
4.213.160.187 - - [31/Dec/2025:15:40:57 +0800] "GET /wp-admin/s.php HTTP/1.1" 404 41905 "https://www.google.de/" "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0.1 Mobile/15E148 Safari/604.1"
4.213.160.187 - - [31/Dec/2025:15:40:58 +0800] "GET /wp-admin/w.php HTTP/1.1" 404 41905 "https://www.google.co.uk/" "Mozilla/5.0 (Linux; Android 11; CPH2251) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Mobile Safari/537.36"
4.213.160.187 - - [31/Dec/2025:15:40:59 +0800] "GET /wp-admin/z.php HTTP/1.1" 404 41912 "https://www.google.com/" "Mozilla/5.0 (Linux; Android 13; SM-G991U) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/117.0.0.0 Mobile Safari/537.36"
192.168.30.21 - - [31/Dec/2025:15:40:59 +0800] "GET /morte.arm7 HTTP/1.0" 403 153 "-" "-"
192.168.30.21 - - [31/Dec/2025:15:41:23 +0800] "GET /morte.sh4 HTTP/1.0" 403 153 "-" "-"
14.212.15.74 - - [31/Dec/2025:15:41:36 +0800] "GET /api/content/posts?_r=1767166847811&page=0&size=10&keyword=&sort=topPriority%2CcreateTime%2Cdesc HTTP/1.1" 200 19530 "https://www.kaisir.cn/" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Safari/537.36"
10.10.0.1 - - [31/Dec/2025:15:41:48 +0800] "GET / HTTP/1.1" 200 19948 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 SafeLine-CE/v9-2-8"
192.168.30.21 - - [31/Dec/2025:15:41:53 +0800] "GET /morte.mpsl HTTP/1.0" 403 153 "-" "-"
192.168.30.21 - - [31/Dec/2025:15:42:13 +0800] "GET /morte.spc HTTP/1.0" 403 153 "-" "-"
192.168.30.21 - - [31/Dec/2025:15:42:14 +0800] "GET /morte.i686 HTTP/1.0" 403 153 "-" "-"
192.168.30.21 - - [31/Dec/2025:15:42:40 +0800] "GET /morte.mips HTTP/1.0" 403 153 "-" "-"
10.10.0.1 - - [31/Dec/2025:15:42:48 +0800] "GET / HTTP/1.1" 200 19948 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 SafeLine-CE/v9-2-8"
180.97.250.103 - - [31/Dec/2025:15:42:57 +0800] "GET /sdk.51.la/js-sdk-pro.min.js HTTP/1.1" 404 239 "-" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.3"
192.168.30.21 - - [31/Dec/2025:15:43:11 +0800] "GET /LjEZs/uYtea.arm7 HTTP/1.0" 403 153 "-" "-"
192.168.30.21 - - [31/Dec/2025:15:43:13 +0800] "GET /LjEZs/uYtea.arm6 HTTP/1.0" 403 153 "-" "-"
10.10.0.1 - - [31/Dec/2025:15:43:48 +0800] "GET / HTTP/1.1" 200 19941 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 SafeLine-CE/v9-2-8"
192.168.30.21 - - [31/Dec/2025:15:44:05 +0800] "GET /LjEZs/uYtea.ppc HTTP/1.0" 403 153 "-" "-"
192.168.30.21 - - [31/Dec/2025:15:44:27 +0800] "GET /LjEZs/uYtea.sh4 HTTP/1.0" 403 153 "-" "-"
192.168.30.21 - - [31/Dec/2025:15:44:37 +0800] "GET /LjEZs/uYtea.m68k HTTP/1.0" 403 153 "-" "-"
10.10.0.1 - - [31/Dec/2025:15:44:48 +0800] "GET / HTTP/1.1" 200 19948 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 SafeLine-CE/v9-2-8"
192.168.30.21 - - [31/Dec/2025:15:45:19 +0800] "GET /LjEZs/uYtea.x86_64 HTTP/1.0" 403 153 "-" "-"
192.168.30.21 - - [31/Dec/2025:15:45:36 +0800] "GET /LjEZs/uYtea.spc HTTP/1.0" 403 153 "-" "-"

IP排除问题

默认会排除内网/保留地址 IP。如果你想把内网 IP 的访问也纳入 PV 统计，可以把 PV_EXCLUDE_IPS 传为空数组（[]），或在配置文件中将 excludeIPs 设置为空数组。

目录结构与主要文件

.
├── cmd/
│   └── nginxpulse/
│       └── main.go                 # 程序入口
├── internal/                       # 核心逻辑（解析、统计、存储、API）
│   ├── app/
│   │   └── app.go                  # 初始化、依赖装配、任务调度
│   ├── analytics/                  # 统计口径与聚合
│   ├── enrich/
│   │   ├── ip_geo.go               # IP 归属地（远程+本地）与缓存
│   │   └── pv_filter.go            # PV 过滤规则
│   ├── ingest/
│   │   └── log_parser.go           # 日志扫描、解析与入库
│   ├── server/
│   │   └── http.go                 # HTTP 服务与中间件
│   ├── store/
│   │   └── repository.go           # SQLite 结构与写入
│   ├── version/
│   │   └── info.go                 # 版本信息注入
│   ├── webui/
│   │   └── dist/                   # 单体嵌入的前端静态资源
│   └── web/
│       └── handler.go              # API 路由
├── webapp/
│   └── src/
│       └── main.ts                 # 前端入口
├── configs/
│   ├── nginxpulse_config.json      # 核心配置入口
│   ├── nginxpulse_config.dev.json  # 本地开发配置
│   └── nginx_frontend.conf         # 内置 Nginx 配置
├── docs/
│   └── versioning.md               # 版本管理与发布说明
├── scripts/
│   ├── build_single.sh             # 单体构建脚本
│   ├── dev_local.sh                # 本地一键启动
│   └── publish_docker.sh           # 推送 Docker 镜像
├── var/                            # 数据目录（运行时生成/挂载）
│   └── log/
│       └── gz-log-read-test/       # gzip 参考日志
├── Dockerfile
└── docker-compose.yml

如需更详细的统计口径或 API 扩展，建议从 internal/analytics/ 与 internal/web/handler.go 开始。

写在最后

本项目大部分代码通过codex生成，我投喂了很多开源项目和资料让他做参考，在此感谢大家对开源社区的贡献。

About

轻量级 Nginx 访问日志分析与可视化面板，提供实时统计、PV 过滤、IP 归属地与客户端解析。

Resources

Readme

License

MIT license
Activity
Custom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages

  • Go 45.7%
  • Vue 33.7%
  • TypeScript 9.3%
  • SCSS 6.3%
  • Shell 2.5%
  • Python 2.0%
  • Other 0.5%