vidmaster2000/netbox

Netbox 插件增强版镜像

镜像概述

本镜像基于Netbox（开源IP地址管理与数据中心基础设施管理工具）构建，集成了多个自定义插件，扩展了Netbox的核心功能，提供更全面的网络基础设施管理能力，适用于企业级网络管理、数据中心运维等场景。

核心功能与特性

集成插件功能

• netbox-secrets：安全存储和管理网络设备的机密信息（如密码、API密钥），支持加密存储和细粒度访问控制
• netbox-floorplan-plugin：提供数据中心平面图可视化功能，直观展示设备在物理空间的布局与位置关系
• netbox-topology-views：自动生成网络拓扑图，可视化展示设备间的连接关系、网络架构及流量路径
• netbox-inventory：增强设备库存管理能力，支持详细资产信息跟踪、库存统计与审计
• netbox-reorder-rack：优化机架设备排序功能，支持按设备类型、U位、自定义规则等方式重新排列机架内设备

使用场景与适用范围

• 企业网络管理：需综合管理IP地址、网络设备、拓扑结构的IT运维团队
• 数据中心运维：需可视化物理设备布局、高效管理机架设备的机房管理人员
• 网络安全管理：需安全存储设备凭证、控制机密信息访问的安全团队
• 网络架构规划：通过拓扑视图进行网络设计、优化与故障排查的网络工程师

使用方法与配置说明

前提条件

• 需配置PostgreSQL数据库（推荐13+版本）
• 需配置Redis服务（推荐6+版本）
• 宿主机需开放8000端口（或自定义端口）

基本部署（Docker Run）

bash
docker run -d \
  --name netbox-plugins \
  -p 8000:8000 \
  -e DATABASE_URL=postgres://user:password@db-host:5432/netbox \
  -e REDIS_URL=redis://redis-host:6379/0 \
  -e SECRET_KEY=your-secure-secret-key \
  -v netbox-data:/opt/netbox/data \
  netbox-plugins:latest

Docker Compose配置

yaml
version: '3.8'

services:
  netbox:
    image: netbox-plugins:latest
    container_name: netbox
    ports:
      - "8000:8000"
    environment:
      - DATABASE_URL=postgres://netbox:netbox@postgres:5432/netbox
      - REDIS_URL=redis://redis:6379/0
      - SECRET_KEY=your-secure-secret-key
      - ALLOWED_HOSTS=localhost,192.168.1.100
    volumes:
      - netbox-data:/opt/netbox/data
    depends_on:
      - postgres
      - redis
    restart: unless-stopped

  postgres:
    image: postgres:13
    container_name: netbox-postgres
    environment:
      - POSTGRES_USER=netbox
      - POSTGRES_PASSWORD=netbox
      - POSTGRES_DB=netbox
    volumes:
      - postgres-data:/var/lib/postgresql/data
    restart: unless-stopped

  redis:
    image: redis:6
    container_name: netbox-redis
    volumes:
      - redis-data:/data
    restart: unless-stopped

volumes:
  netbox-data:
  postgres-data:
  redis-data:

插件配置与使用

1. 部署完成后，通过http://<主机IP>:8000访问Netbox界面
2. 使用默认管理员账户登录（用户名：admin，密码：admin，首次登录需修改密码）
3. 在左侧导航栏"Plugins"菜单下访问各插件功能：
   • Secrets：配置机密信息存储策略、添加设备凭证
   • Floor Plans：上传平面图背景、添加设备位置标记
   • Topology Views：生成并自定义网络拓扑图显示样式
   • Inventory：配置资产属性、导入/导出库存数据
   • Rack Reorder：选择机架，设置排序规则并应用

关键环境变量说明