radugrecu/netbox

NetBox (arm64) 镜像文档

镜像概述

本镜像为NetBox的arm64架构版本，专为arm64平台设计，基于运行Ubuntu 20.04的树莓派4（RPi4）构建。NetBox是一款开源网络自动化平台，主要用于IP地址管理（IPAM）、数据中心基础设施管理（DCIM）及网络自动化，提供直观Web界面和REST API，适用于网络工程师和运维团队进行网络资源集中管理。

核心功能与特性

• arm64架构支持：针对arm64平台优化，可在树莓派4等arm64设备上高效运行
• NetBox核心功能：包含IP地址管理、设备管理、机架管理、VLAN管理、电路管理等
• 稳定基础环境：基于Ubuntu 20.04构建，确保系统兼容性和运行稳定性
• 容器化部署：简化部署流程，支持快速启动和灵活扩展

使用场景与适用范围

• 树莓派4及其他arm64架构设备上的网络管理部署
• 小型网络环境的IP地址和网络设备集中管理
• 开发/测试环境中的NetBox功能验证与原型搭建
• 边缘计算环境或ARM服务器上的网络自动化应用

使用方法与配置说明

基本运行命令

bash
docker run -d --name netbox-arm64 -p 8000:8000 [镜像名称]:[标签]

推荐docker-compose部署

NetBox运行需依赖PostgreSQL数据库和Redis缓存，建议使用docker-compose进行完整部署：

docker-compose.yml示例

yaml
version: '3'

services:
  netbox:
    image: [镜像名称]:[标签]
    ports:
      - "8000:8000"
    depends_on:
      - postgres
      - redis
    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-media:/opt/netbox/netbox/media

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

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

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

关键环境变量配置

访问与初始化

1. 启动服务：docker-compose up -d
2. 访问Web界面：http://<主机IP>:8000
3. 创建管理员账户：

   bash
   docker-compose exec netbox python manage.py createsuperuser
   

4. 按照提示输入用户名、***和密码，完成管理员账户创建

数据持久化

通过挂载卷（volumes）确保数据持久化，包括：

• netbox-media：存储上传的媒体文件
• postgres-data：PostgreSQL数据库数据
• redis-data：Redis缓存数据