MCPcopy Create free account
hub / github.com/BeyondXinXin/nixvis

github.com/BeyondXinXin/nixvis @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
189 symbols 462 edges 28 files ⚖ MIT 95 documented · 50% updated 19d agov1.0.1 · 2026-08-11★ 416

Browse by type

Functions 159 Types & classes 30
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

NixVis

一个轻量、自部署的 Nginx access log 统计工具。下载一个可执行文件或启动一个 Docker 容器,即可查看网站访问数据。

演示地址:nixvis.beyondxin.com

NixVis 界面截图

NixVis 没有内置登录。请只在内网访问,或使用带认证的反向代理,不要直接暴露到公网。

特点

  • 单个可执行文件或 Docker 容器,无需额外服务
  • 多站点与日志轮转支持
  • PV、UV、流量、URL、来源、浏览器、设备与地域统计
  • 小时和天维度的访问趋势
  • 本地 SQLite 存储与增量读取
  • 前端资源和 IP 地理库内嵌,无需部署静态文件

部署

Linux

Releases 下载对应版本,或获取最新稳定版:

wget https://github.com/BeyondXinXin/nixvis/releases/latest/download/nixvis-linux-amd64
chmod +x nixvis-linux-amd64
mv nixvis-linux-amd64 nixvis
./nixvis -gen-config

编辑生成的 nixvis_config.json,将示例站点改为自己的 access log 文件:

{
  "name": "我的网站",
  "logPath": "/var/log/nginx/access.log"
}

然后启动并访问 http://localhost:8088

./nixvis

Docker

下载同一版本发布的两个文件:

wget https://github.com/BeyondXinXin/nixvis/releases/latest/download/docker-compose.yml
wget https://github.com/BeyondXinXin/nixvis/releases/latest/download/nixvis_config.json

编辑 nixvis_config.json 中的站点和 docker-compose.yml 中的日志挂载路径,再启动:

docker compose up -d

统计数据保存在 nixvis_data 中。正常升级不需要删除它:

docker compose pull
docker compose up -d

配置注意事项

  • logPath 填 access log 的文件路径,不是目录;轮转日志可使用 glob,例如 /var/log/nginx/access.log*
  • 不支持读取 .gz 压缩日志;请在 glob 中排除它们。
  • 使用标准 Nginx access log(combined 格式)。自定义 log_format 不保证可解析。
  • 程序每 5 分钟增量读取一次日志;可通过 system.taskInterval 调整,最小为 5 秒。
  • 运行 ./nixvis -v 可查看当前二进制版本、构建时间和提交号。

许可证

NixVis 使用 MIT License 开源发布。

Extension points exported contracts — how you extend this code

browse all types & interfaces →

Core symbols most depended-on inside this repo

browse all functions →

Shape

Function 123
Method 36
Struct 28
Interface 2

Languages

Go71%
TypeScript29%

Modules by API surface

internal/storage/log_parser.go15 symbols
internal/stats/stats.go15 symbols
internal/web/assets/static/js/api.js11 symbols
internal/util/config.go11 symbols
internal/stats/client_stats.go10 symbols
internal/netparser/ip_geo.go10 symbols
internal/storage/repository.go9 symbols
internal/web/assets/static/js/maps.js8 symbols
internal/util/app_cli.go8 symbols
internal/stats/timeseries_stats.go8 symbols
cmd/nixvis/main.go8 symbols
internal/web/assets/static/js/main.js7 symbols

For agents

$ claude mcp add nixvis \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page