kvitex/netbox

Netbox Docker镜像文档

镜像概述

本镜像基于netbox-community/netbox-docker仓库的分支构建，提供Netbox的Docker化部署方案。在原生Netbox功能基础上，特别集成了Napalm RoutersOS驱动，增强对网络设备的管理与配置能力。

核心功能与特性

• 基于官方Netbox社区版构建，保留全部核心功能，包括网络设备资产管理、IP地址管理、VLAN管理等
• 集成Napalm RoutersOS驱动，支持与MikroTik等使用RoutersOS的网络设备进行交互 -采用Docker容器化部署，简化安装配置流程，便于快速部署和横向扩展

使用场景

• 中小型网络环境的网络设备集中管理与监控
• 网络配置自动化与合规性检查
• 需要与RoutersOS设备集成的网络管理系统搭建
• 网络基础设施即代码(IaC)实践环境构建

使用方法

拉取镜像

bash
docker pull [镜像仓库地址]/netbox-napalm:latest

基本运行命令

bash
docker run -d \
  --name netbox \
  -p 8000:8000 \
  -e DATABASE_URL=postgres://user:password@db:5432/netbox \
  -e REDIS_URL=redis://redis:6379/0 \
  -e SECRET_KEY=your_secure_secret_key \
  [镜像仓库地址]/netbox-napalm:latest

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3'

services:
  netbox:
    image: [镜像仓库地址]/netbox-napalm:latest
    ports:
      - "8000:8000"
    environment:
      - DATABASE_URL=postgres://netbox:netbox@db:5432/netbox
      - REDIS_URL=redis://redis:6379/0
      - SECRET_KEY=your_secure_secret_key
      - ALLOWED_HOSTS=localhost,127.0.0.1,your-domain.com
    depends_on:
      - db
      - redis

  db:
    image: postgres:13
    volumes:
      - postgres_data:/var/lib/postgresql/data
    environment:
      - POSTGRES_USER=netbox
      - POSTGRES_PASSWORD=netbox
      - POSTGRES_DB=netbox

  redis:
    image: redis:6
    volumes:
      - redis_data:/data

volumes:
  postgres_data:
  redis_data:

启动服务：

bash
docker-compose up -d

环境变量配置

注意事项

• 首次启动需等待数据库初始化完成，可能需要3-5分钟
• 生产环境中建议配置持久化存储卷，避免容器重启导致数据丢失
• 请根据实际需求调整资源限制（CPU/内存）
• 建议使用HTTPS加密传输，可通过反向代理（如Nginx）实现