怒月 (Nuyue) - 服务器监控探针系统

Git 仓库: https://git.viaeon.com/admin/nuyue

---

项目简介

怒月是一个服务器监控探针系统，由 服务端 (Server) 和 客户端 (Agent) 两部分组成。

核心功能

• 🖥️ 服务器实时监控 - CPU/内存/磁盘/网络/GPU 温度
• 🌐 TCPing 网络延迟 - 多节点延迟检测
• 📊 探针页面 - 自定义主题、SSR 渲染、公开分享
• 🔔 智能告警 - 阈值规则、Telegram/邮件通知
• 💳 订阅计费 - 月付/年付/永久、多种支付方式
• 🔐 安全加密 - 前端加密、配置加密存储

技术栈

组件	技术
服务端	Go + Gin + GORM + gRPC
客户端	Go + gopsutil
前端	React 18 + Naive UI + Tailwind CSS
数据库	PostgreSQL / SQLite
缓存	Redis (可选)

---

快速开始

服务端部署

# Docker Compose (推荐)
docker-compose up -d

# 访问
open http://localhost:8080

Agent 安装

curl -sL https://nuyue.sh/install.sh | bash -s -- \
  --token=YOUR_TOKEN \
  --server=https://nuyue.sh:9090

---

项目结构

nuyue/
├── server/                 # Go 服务端
│   ├── cmd/server/        # 入口
│   ├── internal/mod/      # 业务模块
│   ├── pkg/               # 公共包
│   └── migrations/        # 数据库迁移
├── agent/                  # Go 客户端
│   └── cmd/agent/         # 入口
├── web/                    # React 前端
│   └── src/
│       ├── pages/         # 页面组件
│       ├── api/           # API 封装
│       └── store/         # 状态管理
├── docs/                   # 文档
│   ├── DESIGN.md          # 设计文档
│   └── DEPLOY.md          # 部署文档
└── scripts/               # 脚本
    └── install.sh         # Agent 安装脚本

---

模块列表

模块	功能	状态
安装向导	SQLite/PostgreSQL 双模式、Redis 可选	✅
用户认证	注册/登录/JWT/密码重置	✅
系统设置	SMTP/支付/安全/TG Bot 配置	✅
套餐管理	CRUD、月付/年付/永久	✅
服务器管理	CRUD、Agent Token、指标存储	✅
探针页面	自定义主题、SSR、公开分享	✅
告警系统	规则 CRUD、阈值检测、通知	✅
Agent 客户端	指标采集、gRPC 上报	✅
前端界面	Termius 深色主题、响应式	✅

---

截图

控制台

服务器列表

探针页面

---

开发指南

环境准备

# 服务端
cd server
go mod download
go run ./cmd/server/main.go

# 前端
cd web
npm install
npm run dev

编译构建

# 服务端
cd server && go build -o bin/nuyue-server ./cmd/server/main.go

# Agent
cd agent && go build -o bin/nuyue-agent ./cmd/agent/main.go

# 前端
cd web && npm run build

---

配置示例

SQLite 单机部署

database:
  type: sqlite
  path: /data/nuyue.db

redis:
  enabled: false

PostgreSQL 生产部署

database:
  type: postgres
  host: postgres
  port: 5432
  user: nuyue
  password: nuyue123
  name: nuyue

redis:
  enabled: true
  host: redis
  port: 6379

---

API 文档

认证

# 登录
POST /api/v1/auth/login
{
  "username": "admin",
  "password": "password123"
}

# 响应
{
  "code": 200,
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIs...",
    "user": {...}
  }
}

服务器管理

# 获取服务器列表
GET /api/v1/servers
Authorization: Bearer <token>

# 添加服务器
POST /api/v1/servers
{
  "name": "生产服务器",
  "region": "HK"
}

---

贡献指南

1. Fork 项目
2. 创建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add amazing feature')
4. 推送分支 (git push origin feature/amazing-feature)
5. 创建 Pull Request

---

许可证

MIT License

---

联系方式

• 问题反馈：https://git.viaeon.com/admin/nuyue/issues
• 文档：https://nuyue.sh/docs

---

怒月 (Nuyue) - 服务器监控，从未如此简单 🌙