1. Project Overview

NixVis

NixVis is an open-source, lightweight Nginx log analysis tool developed in Go, specifically designed for self-hosted environments. It provides intuitive data visualization and comprehensive statistical analysis to help you monitor key metrics such as website traffic, traffic sources, and geographic distribution in real time. It can be quickly deployed and used without complicated configuration.

2. Open Source License

Licensed under MIT

3. Screenshots

4. Feature Overview

Features

• Comprehensive Traffic Metrics
  Real-time statistics for unique visitors (UV), page views (PV), and traffic data
• Geographic Distribution
  Visualized maps showing traffic sources across China and worldwide
• Detailed Traffic Rankings
  Rankings for URLs, referrers, browsers, operating systems, and device types
• Time Series Analysis
  Supports viewing traffic trends by hour and by day
• Multi-Site Support
  Monitor traffic data from multiple websites simultaneously
• Incremental Log Parsing
  Automatically scans Nginx log files, parses and stores the latest data
• High-Performance Queries
  Uses lightweight SQLite for storage, combined with a multi-level caching strategy to deliver fast responses
• Embedded Resources
  Frontend resources and IP databases are embedded in the executable, eliminating the need to deploy additional static files

5. Tech Stack

Quick Start

wget nixvis
chmod +x nixvis

./nixvis -gen-config

{
  "websites": [
    {
      "name": "Example Website 1",
      "logPath": "./weblog_eg/blog.beyondxin.top.log"
    },
    {
      "name": "Example Website 2",
      "logPath": "/var/log/nginx/blog.log"
    }
  ],
  "system": {
    "logDestination": "file",
    "taskInterval": "5m"
  },
  "server": {
    "Port": ":8088"
  },
  "pvFilter": {
    "statusCodeInclude": [
      200
    ],
    "excludePatterns": [
      "favicon.ico$",
      "robots.txt$",
      "sitemap.xml$",
      "\\.(?:js|css|jpg|jpeg|png|gif|svg|webp|woff|woff2|ttf|eot|ico)$",
      "^/api/",
      "^/ajax/",
      "^/health$",
      "^/_(?:nuxt|next)/",
      "rss.xml$",
      "feed.xml$",
      "atom.xml$"
    ]
  }
}

Supports log paths with automatic rotation (see Instructions for details)

./nixvis

Compile from Source Code

If you want to compile NixVis from source, follow these steps:

# Clone the project repository
git clone nixvis
cd nixvis
# Build the project
go mod tidy
go build -o nixvis ./cmd/nixvis/main.go
# Or use the build script
# bash package.sh

Docker Deployment

wget /docker/docker-compose.yml
wget /docker/nixvis_config.json

If you need to analyze multiple log files, consider mounting the entire log directory (e.g.,
/var/log/nginx:/var/log/nginx:ro）。

version: '3'
services:
  nixvis:
    image: ${{ secrets.DOCKERHUB_USERNAME }}/nixvis:latest
    ports:
      - "8088:8088"
    volumes:
      - ./nixvis_config.json:/app/nixvis_config.json:ro
      - /var/log/nginx/blog.log:/var/log/nginx/blog.log:ro
      - /etc/localtime:/etc/localtime:ro

docker compose up -d

Tech Stack

• Backend
  :Go language (Gin framework, ip2region geographic location lookup)
• Frontend
  :Native HTML5/CSS3/JavaScript (ECharts map visualization, Chart.js charts)