tracely

Tracely

一个轻量级的前端监控平台，支持 错误收集、用户活跃统计 和 应用安装/升级追踪，可自托管部署。

功能特性

• 错误收集：自动捕获 JS 运行时错误、Promise 异常、Vue 组件错误
• 自定义事件：支持自定义事件上报和统计，灵活的元数据支持
• 应用追踪：安装/升级次数统计，版本和平台分布分析
• 数据概览：实时展示 PV/UV、错误总数、安装/升级、Top 事件排行
• 安全认证：HMAC 签名验证 + JWT 登录，限速保护
• 错误去重：相同错误合并记录，统计出现次数
• 事件白名单：配置文件控制允许上报的事件类型
• 内嵌 Dashboard：前端资源打包到后端，单个二进制文件即可运行
• 现代化 UI：基于 Nuxt UI，支持明暗色模式、响应式布局
• 多应用支持：支持多应用配置，Dashboard 中切换查看

在线体验： https://tracely.hanxi.cc/ （用户名：admin / 密码：admin123）

快速开始

# Docker Compose 一键部署
mkdir tracely && cd tracely
curl -o docker-compose.yaml https://raw.githubusercontent.com/hanxi/tracely/main/docker-compose.yaml
docker compose run --rm tracely ./scripts/gen-config.sh init
docker compose up -d
# 访问 http://localhost:3001

# 本地构建
make build    # 一键构建前端 + 后端
./tracely     # 运行

详细部署说明见 快速开始文档。

项目结构

tracely/
├── internal/            # 后端核心（config, middleware, handler, model）
├── sdk/
│   ├── go/tracely/      # Go SDK
│   └── ts/              # TypeScript SDK (@imhanxi/tracely-sdk)
├── dashboard/           # Vue 3 + Nuxt UI Dashboard
├── docs/                # 完整文档
├── config.example.yaml  # 配置模板
├── Makefile             # 构建脚本
└── Dockerfile           # Docker 镜像

文档

致谢

感谢使用 Tracely！如有问题或建议，欢迎提交 Issue 或 PR。