moonrailgun/tianji

Tianji

概述与主要用途

Tianji（一体化洞察中心）是一款整合型监控工具，将网站分析、Uptime监控和服务器状态监控功能集于一体。它旨在解决用户需同时部署多个专业工具（如GA/umami分析流量、uptime监控服务可用性、Prometheus监控服务器状态等）的痛点，以轻量级方式满足非专业用户的综合监控需求，避免维护多个独立服务的复杂性。

核心功能与特性

• 网站分析：支持PV/UV统计、页面访问量分析等基础流量指标
• Uptime监控：监控服务器网络质量与连通性，支持被动接收监控结果
• 服务器状态：收集并展示服务器运行状态与性能指标
• 问题通知：及时推送服务异常或性能问题告警
• 遥测功能：支持收集部署情况的基础遥测数据（适用于开源项目部署监控）
• 团队协作：多用户协作管理监控任务与数据
• UTM追踪：分析营销活动UTM参数效果
• ***报告：生成网站性能与质量评估报告
• OpenAPI：提供API接口，支持功能扩展与第三方集成
• Helm安装支持：适配Kubernetes环境，可通过Helm Chart部署
• 其他功能：等待列表管理、调查（部分功能）、钩子（Hooks）、网站管理等

使用场景与适用范围

适用于个人开发者、小型团队或需要轻量级综合监控的用户，具体场景包括：

• 监控个人博客或小型网站的访问流量与用户行为
• 跟踪服务器/服务的在线状态与可用性
• 收集服务器基础性能指标，替代复杂的Prometheus部署
• 管理开源项目的用户部署情况（通过遥测功能）
• 简化多工具维护流程，降低部署与运维成本

部署与使用方法

一键部署

支持通过以下平台快速部署：

• Sealos：![Deploy on Sealos]([***]
• RepoCloud：![Deploy to RepoCloud]([***]
• Render：
• ClawCloud：https://raw.githubusercontent.com/ClawCloud/Run-Template/refs/heads/main/Run-on-ClawCloud.svg]([***]

Docker部署（通用方法）

Docker Run快速启动

bash
docker run -d --name tianji -p 8080:8080 -v tianji_data:/app/data moonrailgun/tianji

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  tianji:
    image: moonrailgun/tianji
    ports:
      - "8080:8080"
    volumes:
      - tianji_data:/app/data
    restart: always

volumes:
  tianji_data:

启动服务：

bash
docker-compose up -d

翻译与本地化

添加新翻译

1. 修改以下文件：
   • src/client/i18next-toolkit.config.cjs：编辑国家/地区代码
   • src/client/utils/i18n.ts：添加显示配置
2. 执行命令生成翻译文件：

   bash
   cd src/client
   pnpm install
   pnpm run translation:extract
   pnpm run translation:translate  # 需设置环境变量`OPENAPI_KEY`以调用ChatGPT自动翻译
   

3. 手动检查 src/client/public/locales 目录下的翻译文件

改进翻译

直接编辑 src/client/public/locales 目录下的对应翻译文件

开源许可

Tianji采用Apache 2.0开源许可，受umami（MIT许可）和uptime-kuma（MIT许可）启发开发。

界面预览

包含网站分析仪表盘、监控状态面板、服务器性能指标视图、团队协作界面等多种可视化展示，直观呈现综合监控数据。实际界面可在部署后通过应用内访问查看。