# aiops

**Repository Path**: sky857160/aiops

## Basic Information

- **Project Name**: aiops
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-15
- **Last Updated**: 2026-08-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AIOps

基于 Zabbix + AI 的智能运维监控平台，提供主机管理、网络拓扑可视化、AI 巡检、智能告警分析等一体化运维能力。

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
[![Node](https://img.shields.io/badge/node-%3E%3D18-green.svg)](https://nodejs.org/)
[![React](https://img.shields.io/badge/react-18-blue.svg)](https://reactjs.org/)

---

## 项目简介

AIOps 是一款面向运维团队的智能化监控管理平台，深度集成 Zabbix 监控系统，结合大模型 AI 能力，实现从数据采集、可视化展示到智能分析的完整运维闭环：

- **主机监控**：全量主机的 CPU、内存、磁盘、网络等指标实时监控
- **AI 巡检**：支持基于 AI 大模型的自动巡检任务，自动生成巡检报告
- **网络拓扑**：可视化网络拓扑图，实时展示设备状态与链路流量
- **告警分析**：智能聚合告警，关联根因分析，降低噪音
- **可视化大屏**：支持自定义仪表盘、水波图等丰富可视化组件

---

## 主要功能

| 模块 | 说明 |
|------|------|
| 主机管理 | 主机列表、资源概览、指标配置、详情页（CPU/内存/磁盘/网络/端口状态等） |
| AI 巡检 | 手动/定时巡检任务，AI 自动生成巡检报告，支持 Word 导出 |
| 网络拓扑 | 拓扑图编辑、设备/链路管理、流量实时展示、告警联动 |
| 数据源管理 | 多 Zabbix 实例接入，统一数据源配置 |
| AI 模型管理 | 支持阿里云百炼、腾讯混元、OpenAI 兼容接口，多模型切换 |
| 告警分析 | 问题聚合、历史数据查询、Top 主机排行 |
| 可视化大屏 | 自定义仪表盘，ECharts/Gauge/Topology 等 15+ 组件，响应式布局 |
| 指标配置 | 统一维护 CPU/内存/磁盘/温度/网络/端口/风扇/电源等指标匹配规则 |
| 模板管理 | 仪表盘模板编辑与面板配置 |
| 用户认证 | 内置登录系统，保护敏感数据 |

---

## 环境依赖

| 依赖 | 版本要求 |
|------|---------|
| Node.js | >= 18 |
| npm / pnpm | 最新稳定版 |
| Zabbix Server | 5.x / 6.x / 7.x（需提供 API Token） |
| AI 大模型 API | 阿里云百炼 / 腾讯混元 / OpenAI 兼容接口 |

---

## 部署步骤

### 1. 克隆项目

```bash
git clone https://gitee.com/sky857160/aiops.git
cd aiops
```

### 2. 安装依赖

```bash
npm install
```

### 3. 配置环境变量

在项目根目录创建 `.env` 文件：

```env
# 后端服务端口
PORT=3001

# Zabbix API 配置（可在 Web 界面中补充，此处为默认值）
# ZABBIX_API_URL=http://your-zabbix-server/zabbix/api_jsonrpc.php
# ZABBIX_API_TOKEN=your-token

# AI 模型配置（可选，默认在管理页面中配置）
# AI_API_KEY=your-api-key
# AI_API_URL=your-ai-endpoint
# AI_MODEL_NAME=your-model
```

### 4. 初始化数据库

首次启动时，应用会自动创建 SQLite 数据库（`data/aiops.db`）及所有必需的表，并插入默认管理员账号：

- **用户名**：`admin`
- **密码**：`admin123`

> 建议首次登录后立即修改默认密码。

---

## 启动命令

### 开发模式（前后端同时启动）

```bash
npm run dev
```

启动后访问：
- 前端界面：http://localhost:5173
- 后端 API：http://localhost:3001

### 仅启动后端

```bash
npm run server:dev
```

### 仅启动前端

```bash
npm run client:dev
```

### 生产构建

```bash
npm run build
npm run preview   # 预览构建结果
```

---

## 项目目录说明

```
aiops/
├── api/                        # 后端 Express 服务
│   ├── app.ts                  # Express 应用入口，路由注册
│   ├── server.ts               # 服务启动入口
│   ├── db.ts                   # SQLite 数据库初始化 & 迁移
│   ├── scheduler.ts            # 定时巡检任务调度器
│   ├── routes/                 # API 路由定义
│   │   ├── auth.ts             # 认证相关接口
│   │   ├── hosts.ts            # 主机管理接口
│   │   ├── inspections.ts      # AI 巡检任务接口
│   │   ├── topology.ts         # 网络拓扑接口
│   │   ├── aiModels.ts         # AI 模型管理接口
│   │   ├── chat.ts             # AI 对话接口
│   │   ├── datasources.ts      # 数据源管理接口
│   │   ├── templates.ts        # 仪表盘模板接口
│   │   ├── metricConfig.ts     # 指标配置接口
│   │   ├── problems.ts         # 告警问题接口
│   │   └── networkDevices.ts   # 网络设备接口
│   └── services/               # 业务逻辑服务层
│       ├── zabbixService.ts    # Zabbix API 封装
│       ├── aiModelService.ts   # AI 大模型调用
│       ├── inspectionService.ts # 巡检逻辑
│       ├── reportService.ts    # 巡检报告生成
│       └── topologyService.ts  # 拓扑数据服务
├── src/                        # 前端 React 应用
│   ├── App.tsx                 # 路由配置 & 布局
│   ├── pages/                  # 页面组件
│   │   ├── Dashboard.tsx       # 主仪表盘
│   │   └── Login.tsx           # 登录页
│   ├── components/             # 业务组件
│   │   ├── widgets/            # 可视化组件库（15+ 种）
│   │   ├── HostList.tsx        # 主机列表
│   │   ├── AIInspection.tsx    # AI 巡检面板
│   │   ├── TopologyCanvas.tsx  # 拓扑画布
│   │   └── ChatPanel.tsx       # AI 对话面板
│   ├── stores/                 # Zustand 状态管理
│   │   ├── authStore.ts        # 认证状态
│   │   ├── dashboardStore.ts   # 仪表盘状态
│   │   └── themeStore.ts       # 主题状态
│   └── lib/utils.ts            # 工具函数
├── public/                     # 静态资源
├── data/                       # SQLite 数据库文件（自动生成）
├── package.json
├── tsconfig.json
├── vite.config.ts
└── README.md
```

---

## 技术栈

- **前端**：React 18 + TypeScript + Vite + Tailwind CSS + ECharts + Zustand
- **后端**：Node.js + Express + TypeScript
- **数据库**：SQLite（better-sqlite3）
- **AI**：阿里云百炼 / 腾讯混元 / OpenAI 兼容接口

---

## 许可证

MIT License