# most_agent

**Repository Path**: scpli/most_agent

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 20
- **Created**: 2026-08-14
- **Last Updated**: 2026-08-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# ⚡ NetMon Agent Platform
### 基于 AI 多 Agent 协作的企业级全栈智能运维与网络基础设施自动化平台

[![Go Version](https://img.shields.io/badge/Go-1.25+-00ADD8?style=flat-square&logo=go)](https://golang.org)
[![React](https://img.shields.io/badge/React-18-61DAFB?style=flat-square&logo=react)](https://react.dev)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-3178C6?style=flat-square&logo=typescript)](https://www.typescriptlang.org/)
[![SQLite](https://img.shields.io/badge/SQLite-Pure--Go-003B57?style=flat-square&logo=sqlite)](https://modernc.org/sqlite)
[![License](https://img.shields.io/badge/License-MPL--2.0-blue.svg?style=flat-square)](LICENSE)
[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20Linux%20(x86%2FARM)-orange.svg?style=flat-square)](#-三-系统启动与部署方式)

**国产自研开源 · 告警聚合降噪 · 根因诊断 (RCA) · 故障自愈闭环 · 网络设备 SNMP 监控 · 容器/K8s/虚机统一纳管 · 单二进制零依赖交付**

</div>

---

## 📑 目录
- [一、 系统功能详细介绍](#一-系统功能详细介绍)
  - [1. AI 智能运维与多 Agent 自愈闭环](#1-ai-智能运维与多-agent-自愈闭环)
  - [2. 网络设备与 SNMP 深度监控](#2-网络设备与-snmp-深度监控)
  - [3. 类夜莺 PromQL 告警与策略中心](#3-类夜莺-promql-告警与策略中心)
  - [4. 服务器与容器/云原生统一管理](#4-服务器与容器云原生统一管理)
  - [5. 高兼容 WebShell 终端与安全审计](#5-高兼容-webshell-终端与安全审计)
  - [6. IPAM 子网规划与 3D 机房数字孪生](#6-ipam-子网规划与-3d-机房数字孪生)
- [二、 技术架构与技术栈](#二-技术架构与技术栈)
  - [1. 总体架构拓扑图](#1-总体架构拓扑图)
  - [2. 核心技术栈清单](#2-核心技术栈清单)
  - [3. 关键架构设计亮点](#3-关键架构设计亮点)
- [三、 系统启动与部署方式](#三-系统启动与部署方式)
  - [1. 方式一：单二进制独立运行（极简·推荐）](#1-方式一单二进制独立运行极简推荐)
  - [2. 方式二：Linux Systemd 系统服务部署](#2-方式二linux-systemd-系统服务部署)
  - [3. 方式三：源码一键全自动交叉编译](#3-方式三源码一键全自动交叉编译)
  - [4. 方式四：本地前后端联合开发模式](#4-方式四本地前后端联合开发模式)
- [四、 环境变量与配置说明](#四-环境变量与配置说明)
- [五、 开源许可证](#五-开源许可证)

---

## 一、 系统功能详细介绍

### 1. AI 智能运维与多 Agent 自愈闭环
- **12 个专业化 AIOps Agent 分工协作**：
  - **告警降噪 Agent**：智能聚类海量报警事件，抑制告警风暴，提取核心事件链。
  - **根因分析 Agent (RCA)**：结合时序指标、系统日志与网络拓扑，给出自然语言根因诊断报告与置信度。
  - **自愈决策 Agent**：自动生成结构化排障/修复 Shell 命令，评估操作风险等级（低/中/高/高危）。
  - **巡检与日志 Agent**：按计划巡检系统健康度，自动解析过滤异常日志。
  - **合规审计与 DBA Agent**：慢查询分析、配置漂移比对、合规基线扫描。
- **HITL 人机协同移动端审批 (Human-in-the-Loop)**：
  - 高风险或敏感变更支持推送**企业微信、钉钉**，运维工程师在手机端一键确认后由 Agent 自动执行。
- **自愈全流程闭环验证**：
  - 执行命令后自动发起二次探活与指标回采，验证故障是否真正恢复，并自动生成 Post-Mortem 复盘报告。
- **RAG 向量智能知识库**：
  - 内置专家运维经验库，支持本地上传 SOP 文档，语义检索注入大模型上下文，越用越聪明。
- **多模型混合路由与熔断降级**：
  - 原生支持**火山引擎豆包 (Doubao)、DeepSeek、阿里通义千问 (Qwen)、智谱 GLM、OpenAI**。
  - 100% 支持本地私有化大模型（**Ollama / vLLM / LM Studio**），实现敏感数据与拓扑不出内网。

---

### 2. 网络设备与 SNMP 深度监控
- **全厂商 SNMP 适配引擎**：
  - 支持 SNMP v1 / v2c / v3，内置华为 (Huawei)、思科 (Cisco)、华三 (H3C)、锐捷 (Ruijie)、中兴 (ZTE)、飞塔 (Fortinet) 等品牌专属 OID 指标集。
- **自定义 OID 探测与在线下发**：
  - 支持在 Web 界面对任意目标设备进行 **标量 (SNMP GET)** 与 **表量 (SNMP WALK)** 的一键在线测试。
  - 探测成功后**强制要求输入自定义 Tag 标签**（如 `env="prod"`, `role="core-switch"`），一键持久化为该设备的自定义监控采集项。
- **网络 NOC 监控大屏 (100% 真实数据计算)**：
  - **实时总体吞吐速率**：基于精确滑动窗口（`Ranked CTE`）计算端口瞬时上行/下行速率 (Mb/s)，杜绝多设备时间戳毫秒误差导致的速率暴增。
  - **累计吞吐总量**：精确汇总真实入/出方向累计流量 (Gb)。
  - **接口健康全景**：接口 UP/DOWN 实时占比统计、物理错包率/丢包率。
  - **Top 排行与厂商分布**：核心交换机流量 Top 排行榜与设备品牌分布占比。
- **三位一体在线状态监测 (SNMP 优先可达保证)**：
  - 探测器优先验证 SNMP 协议可用性，**只要 SNMP 响应即绝对判定为在线**；辅以 ICMP Ping 与 SSH 端口探测，彻底根除交换机禁 Ping 导致的离线误报。

---

### 3. 类夜莺 PromQL 告警与策略中心
- **内置 PromQL 告警规则评估引擎**：
  - 后端调度器以 10s 粒度实时对时序采样与 Tag 标签执行 PromQL 语法评估。
  - 支持用户自定义输入 PromQL 表达式，如：
    ```promql
    # 核心交换机错误包告警
    snmp_interface_in_errors{role="core-switch", oper_status="up"} > 100
    
    # 华为设备 CPU 占用过高
    huawei_cpu_usage{env="production"} > 85
    ```
- **告警静默、抑制与升级**：
  
  - 支持按 Tag 标签设置维护期静默规则与告警升级策略，避免重复告警轰炸。

---

### 4. 服务器与容器/云原生统一管理
- **Docker 容器全景纳管**：
  - 多主机 Docker 实例统一纳管，容器秒级启停、重启、销毁。
  - 容器实时 CPU/内存/网络/磁盘 IO 监控波形图，流式日志实时查看。
  - 可视化 **Docker Compose** 模板在线编写、部署与编排。
- **Kubernetes 集群纳管**：
  - 支持一键导入标准 `kubeconfig`，可视化查看 Node 资源利用率、Pod 运行状态、Deployments 与 Services 拓扑。
- **多平台虚拟机管理**：
  - 支持对 VMware vSphere、Proxmox VE、KVM 虚拟机进行统一纳管、电源操作与快照回滚。

---

### 5. 高兼容 WebShell 终端与安全审计
- **全功能交互式 WebShell**：
  - 基于 xterm.js + WebSocket，支持多标签页、窗口尺寸动态自适应、快捷命令面板。
- **老旧网络设备专用算法兼容**：
  - 针对老旧核心交换机/防火墙，原生集成 `diffie-hellman-group-exchange-sha1`、`diffie-hellman-group14-sha1` 及 `ssh-rsa` 密钥交换算法，杜绝握手失败。
- **高危命令安全过滤引擎**：
  - 内置 7 类高危指令拦截机制（如 `rm -rf /`、`mkfs`、`dd`、`iptables -F` 等），支持按角色授权与全操作审计留痕。

---

### 6. IPAM 子网规划与 3D 机房数字孪生
- **IP 地址资产管理 (IPAM)**：
  - IP 子网与 VLAN 统一规划，自动生成可用地址池，支持 IP 分配、预留、回收与使用率热力图。
- **机房 3D 数字孪生**：
  - 基于 WebGL / Three.js 渲染机房 3D 空间，支持机柜机位 U 位展示、设备上下架状态与功耗/温湿度联动。

---

## 二、 技术架构与技术栈

### 1. 总体架构拓扑图

```mermaid
graph TB
    subgraph Browser["前端表现层 (React 18 + Vite + Tailwind + Lucide)"]
        UI["Web 现代化管理界面"]
        Dashboard["NOC 监控大屏 / 3D 机房孪生"]
        WebShell["xterm.js Web 终端"]
    end

    subgraph GoServer["高性能 Go 核心单二进制服务端 (Embedded Frontend)"]
        Router["Chi HTTP 路由网关 (129+ REST Endpoints)"]
        WS["WebSocket 实时双向管道"]
        
        subgraph Engine["核心引擎层"]
            SNMP["SNMP 轮询与采集调度器 (10s 高精调度)"]
            Prober["三位一体在线探测器 (SNMP/Ping/SSH)"]
            AlertEval["PromQL 类夜莺告警评估引擎"]
            AgentHub["AI 多 Agent 协作与推理编排"]
            SSHTerm["SSH/WebShell 协议网关"]
        end

        subgraph Storage["数据存储层 (纯 Go 驱动 · WAL 模式)"]
            AppDB[("SQLite app.db (用户/设备/告警/配置)")]
            MetricsDB[("SQLite metrics.db (SNMP指标/时序样本)")]
            OidDB[("SQLite oid.db (系统与品牌OID字典)")]
        end
    end

    subgraph Target["纳管基础设施与外部服务"]
        NetDev["🌐 网络设备 (华为/思科/华三/锐捷 SNMP/SSH)"]
        Servers["🖥️ Linux/Windows 物理机与虚拟机"]
        Containers["🐳 Docker 主机 & ☸️ K8s 集群"]
        LLM["🤖 大模型 (豆包 / DeepSeek / 通义 / 本地Ollama)"]
        Notify["📬 告警通知 (企业微信 / 钉钉 / 邮件)"]
    end

    UI --> Router
    WebShell <--> WS
    Router --> Engine
    Engine --> Storage
    Engine --> Target
```

---

### 2. 核心技术栈清单

| 层次 | 核心技术 | 选型优势说明 |
| :--- | :--- | :--- |
| **后端语言** | **Go 1.25** | 高并发、超低内存占用、天然支持跨平台交叉编译 |
| **HTTP 路由** | **Chi Router v5** | 极简快速、轻量级、完全符合 Go 标准库 `net/http` 接口 |
| **数据存储** | **Pure-Go SQLite (`modernc.org/sqlite`)** | **无需 CGO/GCC**，零外部数据库依赖，WAL 高并发模式，自动完成 60+ 次 Schema 迁移 |
| **SNMP 协议** | **Gosnmp v1.44** | 高性能纯 Go SNMP 实现，支持 v1/v2c/v3 报文编解码 |
| **终端引擎** | **xterm.js + Gorilla WebSocket** | 毫秒级低延迟 WebShell，全面支持 ANSI 颜色与流控 |
| **前端框架** | **React 18 + TypeScript 5.7** | 现代化组件化架构，类型安全，极致开发体验 |
| **构建工具** | **Vite 5** | 毫秒级热更新，Rollup 生产打包优化 |
| **可视化图表** | **ECharts + Three.js + Lucide Icons** | 丰富的时序波形图、网络拓扑图与 3D WebGL 数字孪生机房 |

---

### 3. 关键架构设计亮点

1. **内嵌式一体化交付 (`//go:embed`)**：
   - 前端 Vite 产物（HTML、CSS、JS、字体与图标）全量内嵌至 Go 二进制中。
   - 用户**无需在宿主机上安装 Node.js、NPM、Python 或 Nginx**，直接分发运行单个文件即可。
2. **纯 Go 零 CGO 编译 (`CGO_ENABLED=0`)**：
   - 彻底摆脱 GCC/MinGW 跨平台交叉编译限制，可在 Windows 上秒级构建出标准的 Linux x86_64 与 ARM64 生产包。
3. **分库与分区滑动窗口算法**：
   - 业务配置库（`app.db`）与高频时序指标库（`metrics.db`）物理隔离，互不阻塞。
   - 网络流量采用 `ROW_NUMBER() OVER (PARTITION BY device_id, if_index)` 精确计算接口前后两点差值与耗时，从算法底层消除跨设备时间差导致的速率异常。

---

## 三、 系统启动与部署方式

### 1. 方式一：单二进制独立运行（极简·推荐）

编译好的跨平台二进制产物位于 [`backend-go/release/`](./backend-go/release/) 目录：

#### 🪟 Windows 运行：
```powershell
# 进入 release 目录
cd backend-go\release

# 直接双击或命令行启动（默认监听 8088 端口）
.\itops-server-windows-amd64.exe

# 启动后在浏览器打开：
http://localhost:8088
```

#### 🐧 Linux (x86_64 / ARM64) 运行：
```bash
# 赋予可执行权限
chmod +x itops-server-linux-amd64

# 前台测试运行
./itops-server-linux-amd64

# 后台持续运行（推荐）
nohup ./itops-server-linux-amd64 > itops.log 2>&1 &
```

> 🔑 **默认初始账号**：`admin`  
> 🔑 **默认初始密码**：`admin`（首次登录后系统会强制提示修改安全密码）

---

### 2. 方式二：Linux Systemd 系统服务部署

创建服务文件 `/etc/systemd/system/itops.service`：
```ini
[Unit]
Description=ITOps Agent Platform
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/opt/itops
ExecStart=/opt/itops/itops-server-linux-amd64
Restart=always
RestartSec=5
LimitNOFILE=65536

[Install]
WantedBy=multi-user.target
```

加载并启动服务：
```bash
systemctl daemon-reload
systemctl enable itops
systemctl start itops
systemctl status itops
```

---

### 3. 方式三：源码一键全自动交叉编译

项目根目录提供了全自动的一键构建脚本（全自动构建前端 Vite 产物、同步至嵌入目录并交叉编译 Windows/Linux 三平台二进制）：

- **Windows 用户**：直接双击运行根目录下的 [`build_release.bat`](./build_release.bat)
- **Linux/macOS 用户**：
  ```bash
  chmod +x ./build_release.sh
  ./build_release.sh
  ```

---

### 4. 方式四：本地前后端联合开发模式

若需对系统进行二次开发或定制：

#### 1. 启动 Go 后端服务：
```bash
cd backend-go
go run ./cmd/server
# 后端 API 将监听在 http://localhost:8088
```

#### 2. 启动前端 Vite 开发服务器：
```bash
cd frontend
npm install
npm run dev
# 前端服务将启动在 http://localhost:3000 (已配置好接口反向代理)
```

---

## 四、 环境变量与配置说明

系统支持通过项目根目录的 `.env` 文件或系统环境变量进行个性化配置（均包含开箱即用的默认值）：

```ini
# 基础服务配置
PORT=8088                         # 服务监听端口 (默认: 8088)
DATA_DIR=./data                   # SQLite 数据库存储目录 (默认: ./data)
LOG_LEVEL=info                    # 日志级别: debug / info / warn / error

# 安全与认证配置
JWT_SECRET=your-secret-key        # JWT 签名密钥 (建议生产环境修改)
JWT_EXPIRE_HOURS=24               # Token 有效时长 (小时)

# AI 模型配置 (也可在登录后在前端 "设置 → AI 配置" 界面可视化设置)
DOUBAO_API_KEY=your-api-key       # 火山引擎豆包 API Key
DEEPSEEK_API_KEY=your-api-key     # DeepSeek API Key
OPENAI_API_BASE=https://api.openai.com/v1
```

---

## 五、 开源许可证

本项目遵循 [Mozilla Public License 2.0 (MPL-2.0)](LICENSE) 开源授权协议：
- 允许企业内网免费商用、私有化部署与二次改造。
- 若对外分发基于本项目的修改版本，所修改的源文件必须保持开源并保留原始版权信息。

---

<div align="center">
  <sub>⚡ ITOps Agent Platform · 让运维更简单，让系统更有序</sub>
</div>