AI导哈

网络监控与审计工具

NetVault是一个开源项目，专注于网络监控、基础设施审计和AI辅助技术支持工作流，适用于网络支持工程师、基础设施支持专家等角色。

  • by Nstalej
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Nstalej/netvault

使用说明

NetVault——网络监控、审计和人工智能辅助支持

NetVault是一个开源的投资组合项目 网络监控、基础设施审计和人工智能辅助的技术支持工作流程它是围绕实际操作需求而设计的：记录设备、检查网络健康状况、收集证据、审查审计结果，并将重复发生的事件转化为可重复使用的运行手册。

此存储库展示了在以下方面的应用经验 网络/基础设施支持、Python工具、基于Docker的部署、技术文档和人工智能辅助操作.

为什么这个项目很重要

网络和基础设施团队通常需要以下问题的明确答案：

  • 哪些设备处于活动状态、可访问或发生故障？
  • 环境发生了什么变化？
  • 配置、连接或审核检查是否通过？
  • 支持票应附有哪些证据？
  • 人工智能助手能否在不取代工程判断的情况下帮助总结研究结果？

NetVault通过一个实用的面向支持的平台探索了这一工作流程。

核心能力

  • 网络设备清单 --注册和组织路由器、交换机、防火墙、服务器和基础设施端点。
  • 健康和审计工作流程 --收集状态检查和审计证据，以提高运营可见性。
  • SNMP、SSH和REST连接器方向 --支持通用基础设施集成模式。
  • Web仪表板 --设备、审计状态、拓扑和警报的操作视图。
  • Docker首次部署 --使用Docker Compose进行本地或基于服务器的部署。
  • MCP/AI就绪架构 --将基础设施上下文暴露给人工智能工具，用于摘要、诊断和支持工作流。
  • 技术文件重点 -指南、API注释和runbook样式的支持材料。

投资组合相关性

此项目定位为以下角色：

  • 技术支持工程师
  • 网络支持工程师
  • 基础设施支持专家
  • 云/Linux支持工程师
  • NOC分析师或技术运营分析师
  • 支持运营/知识库专家
  • 技术操作的AI自动化专家

它显示了结合以下内容的能力：

  • 网络故障排除基础
  • 结构化文档
  • Python后端开发
  • Docker化服务
  • 基于仪表板的操作可见性
  • 人工智能辅助支持概念

建筑

[Support Engineer / AI Assistant]
              |
              v
        [MCP Server / API]
              |
              v
        [Core Engine]
      /       |       \
     v        v        v
[Devices] [Audits] [Alerts]
     |        |        |
     v        v        v
[SNMP/SSH] [Database] [Dashboard]

存储库结构

netvault/
├── core/                 # Python backend, API, engine, database, dashboard
├── frontend/             # React/Vite frontend
├── agents/               # Remote agent concepts, including Windows AD agent
├── docs/                 # Quickstart, API docs, setup guides, support material
├── scripts/              # Verification, setup, seed, and helper scripts
├── tests/                # Unit, integration, and e2e test structure
├── docker-compose.yml    # Docker deployment entry point
└── requirements.txt      # Python dependencies

快速启动

1.克隆

git clone https://github.com/Nstalej/netvault.git
cd netvault

2.配置环境

cp .env.example .env
# Edit .env with local ports, timezone, credentials, and secrets.

3.使用Docker Compose启动

docker compose up -d

4.打开仪表板

http://localhost:8080

如果部署在远程主机上，请替换 localhost 使用服务器IP或DNS名称。

开发设置

# Create environment
python -m venv .venv
source .venv/bin/activate  # Windows Git Bash / Linux / macOS

# Install dependencies
pip install -r requirements.txt
pip install -r requirements-dev.txt

# Run locally
python -m core.main

替代Conda工作流程：

conda env create -f environment.yml
conda activate netvault
python -m core.main

验证

pytest
python scripts/verify_api.py
python scripts/verify_device_manager.py
python scripts/verify_ssh_parsers.py

示例支持工作流程

  1. 设备或网段被报告为降级。
  2. NetVault收集设备状态、最近的检查和审计证据。
  3. 支持工程师审查仪表板数据和日志。
  4. 调查结果总结为一份准备就绪的事故记录。
  5. 重复出现的问题会变成记录在案的runbook。
  6. 人工智能助手可以帮助起草解释，但工程师会验证诊断结果。

文档

路线图

  • 改进示例数据和演示部署说明。
  • 添加更现实的网络故障排除示例。
  • 扩展runbook文档，了解DNS、延迟、端口可达性和设备可用性。
  • 添加仪表板的屏幕截图或演示GIF。
  • 为后端测试和文档管理添加CI检查。
  • 改进事故总结的MCP工具，支持工单起草。

关于

由...创建 亚历杭德罗·卡斯蒂略电子工程师，专注于网络/基础设施支持、技术文档、故障排除和人工智能辅助自动化。

相关 MCP