groundworkdevelopment/nedi Docker 镜像 - 轩辕镜像

NeDi Fork plus integrations 镜像文档

1. 镜像概述

本镜像基于NeDi的分支版本构建，继承NeDi核心的网络发现、设备库存管理及性能监控功能，并扩展了第三方工具集成能力。适用于企业级网络环境的设备管理、状态监控及多系统协同运维场景。

2. 核心功能与特性

2.1 基础功能

• 网络自动发现：支持通过ICMP、SNMP等协议扫描并识别网络设备（交换机、路由器、防火墙等）
• 设备库存管理：记录设备型号、配置、接口信息、固件版本等资产数据
• 性能与流量监控：实时采集设备CPU、内存使用率及端口流量数据
• 事件告警：基于阈值触发设备异常状态告警（如端口离线、高CPU使用率）

2.2 增强集成特性

• 支持与监控工具集成（如Prometheus、Grafana）
• 提供工单系统对接接口（如Jira、ServiceNow）
• 兼容LDAP/Active Directory用户认证
• 支持数据导出至CSV/JSON格式，便于第三方系统分析

3. 使用场景

• 企业内网网络设备集中管理
• 数据中心网络拓扑可视化与监控
• 多工具协同的网络运维环境
• 网络资产变更跟踪与合规审计

4. 使用方法与配置说明

4.1 快速启动

通过以下命令快速启动容器（默认使用内置SQLite数据库）：

bash
docker run -d \
  --name nedi-fork \
  -p 80:80 \
  -v nedi-data:/usr/local/nedi/data \
  --restart unless-stopped \
  nedi-fork-plus-integrations:latest

4.2 环境变量配置

4.3 持久化存储

为保证数据持久化，需挂载以下目录：

• /usr/local/nedi/data：存储设备数据、配置文件及日志
• /usr/local/nedi/database：数据库文件（仅SQLite时需挂载）

示例（使用外部MySQL数据库时的持久化配置）：

bash
docker run -d \
  --name nedi-fork \
  -p 80:80 \
  -e DB_TYPE=mysql \
  -e DB_HOST=192.168.1.100 \
  -e DB_USER=netadmin \
  -e DB_PASS=SecurePass!2023 \
  -v /opt/nedi/data:/usr/local/nedi/data \
  --restart unless-stopped \
  nedi-fork-plus-integrations:latest

4.4 docker-compose配置示例

以下为使用MySQL数据库的docker-compose配置：

yaml
version: '3.8'

services:
  nedi:
    image: nedi-fork-plus-integrations:latest
    container_name: nedi
    ports:
      - "80:80"
    environment:
      - DB_TYPE=mysql
      - DB_HOST=mysql
      - DB_PORT=3306
      - DB_NAME=nedi
      - DB_USER=nediuser
      - DB_PASS=dbPass@789
      - SNMP_COMMUNITY=private
      - LOG_LEVEL=info
    volumes:
      - nedi-data:/usr/local/nedi/data
    depends_on:
      - mysql
    restart: unless-stopped

  mysql:
    image: mysql:8.0
    container_name: nedi-mysql
    environment:
      - MYSQL_ROOT_PASSWORD=rootPass!2023
      - MYSQL_DATABASE=nedi
      - MYSQL_USER=nediuser
      - MYSQL_PASSWORD=dbPass@789
    volumes:
      - mysql-data:/var/lib/mysql
    restart: unless-stopped

volumes:
  nedi-data:
  mysql-data:

4.5 访问与初始化

容器启动后，通过 http://<宿主机IP> 访问Web管理界面，默认登录凭据：

• 用户名：admin
• 密码：admin（首次登录需强制修改）

5. 注意事项

• 生产环境建议使用外部MySQL/PostgreSQL数据库，避免SQLite性能瓶颈
• 首次启动需等待3-5分钟数据库初始化
• 网络发现扫描可能产生一定网络流量，建议在非业务高峰期执行全量扫描
• 集成功能需在Web界面"Settings > Integrations"中进行详细配置