gole/netbox

Netbox Docker镜像文档

概述

本镜像为个性化的Netbox Docker镜像，旨在简化Netbox网络设备管理平台的部署流程。Netbox是一款开源的网络设备管理工具，用于IP地址管理（IPAM）和数据中心基础设施管理（DCIM）。该镜像包含预安装的必要模块，用户可通过查看requirements.txt文件了解所有已安装组件，适用于快速搭建网络管理环境。

核心功能与特性

• 预配置模块：集成Netbox运行所需的核心依赖，无需手动安装模块
• 简化部署：通过Docker容器化部署，减少环境配置复杂度
• 透明组件：可通过requirements.txt文件清晰查看所有预安装模块信息
• 兼容性：与Netbox官方功能保持兼容，支持标准网络管理功能

使用场景

• 中小型企业网络设备资产管理与配置
• 数据中心基础设施可视化与文档化
• 网络架构设计与IP地址规划
• 开发/测试环境中Netbox的快速部署验证

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+版本）
• 已安装Docker Compose（可选，用于多容器部署）
• 具备基本的Docker命令操作能力

快速启动（单容器模式）

使用以下命令直接启动Netbox容器：

bash
docker run -d \
  --name netbox \
  -p 8000:8000 \
  golesuite/netbox-docker

访问 http://localhost:8000 即可打开Netbox Web界面。

Docker Compose部署（推荐）

创建docker-compose.yml文件，配置完整服务栈：

yaml
version: '3.8'

services:
  netbox:
    image: golesuite/netbox-docker
    container_name: netbox
    ports:
      - "8000:8000"
    environment:
      - DATABASE_URL=postgres://netbox:netbox@db:5432/netbox
      - SECRET_KEY=your_secure_secret_key_here
      - ALLOWED_HOSTS=localhost,192.168.1.100
    depends_on:
      - db
    restart: unless-stopped

  db:
    image: postgres:14-alpine
    container_name: netbox_db
    environment:
      - POSTGRES_USER=netbox
      - POSTGRES_PASSWORD=netbox
      - POSTGRES_DB=netbox
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres_data:

启动服务：

bash
docker-compose up -d

关键配置参数

环境变量

查看已安装模块

容器运行后，可通过以下命令查看所有预安装模块：

bash
docker exec -it netbox cat requirements.txt

注意事项

• 生产环境中必须设置强安全密钥（SECRET_KEY）
• 建议使用外部数据库持久化数据，避免容器删除导致数据丢失
• 首次启动后需创建管理员账户：docker exec -it netbox python manage.py createsuperuser
• 定期备份数据库数据以防止数据丢失