babim/netbox

docker-netbox

镜像概述

docker-netbox是NetBox的Docker化部署镜像。NetBox是一款开源的IP地址管理(IPAM)和数据中心基础设施管理(DCIM)工具，旨在帮助网络管理员高效管理IP地址空间、网络设备和数据中心资源。该镜像通过容器化方式简化了NetBox的部署流程，支持灵活的运行时配置。

核心功能与特性

• IPAM/DCIM功能：提供完整的IP地址管理和数据中心基础设施管理能力
• 数据库支持：仅支持PostgreSQL数据库（不支持MySQL）
• 环境变量配置：通过环境变量实现运行时参数配置，无需修改配置文件
• 默认凭据：提供初始管理员账户，便于快速上手
• 持久化存储：支持通过卷挂载保存配置数据

使用场景

适用于需要集中管理IP地址空间、网络设备和数据中心物理基础设施的场景，如：

• 企业网络管理部门
• 数据中心运维团队
• 网络服务提供商
• IT基础设施管理团队

使用方法

快速启动

通过以下命令快速部署NetBox容器：

bash
docker run --name netbox -v /netbox_etc:/etc/netbox-nginx -p 80:80 -e [环境变量] babim/netbox

默认凭据

初始登录系统的默认凭据：

• 用户名：admin
• 密码：admin

配置说明

可通过环境变量在运行时配置应用（完整配置可参考docker-compose.yml）。支持的环境变量包括：

SUPERUSER_NAME         # 超级用户名
SUPERUSER_EMAIL        # 超级用户邮箱
SUPERUSER_PASSWORD     # 超级用户密码
ALLOWED_HOSTS          # 允许访问的主机列表
DB_NAME                # 数据库名称
DB_USER                # 数据库用户
DB_PASSWORD            # 数据库密码
DB_HOST                # 数据库主机地址
DB_PORT                # 数据库端口
SECRET_KEY             # 应用密钥
EMAIL_SERVER           # 邮件服务器地址
EMAIL_PORT             # 邮件服务器端口
EMAIL_USERNAME         # 邮件服务器用户名
EMAIL_PASSWORD         # 邮件服务器密码
EMAIL_TIMEOUT          # 邮件发送超时时间
EMAIL_FROM             # 发件人邮箱地址
LOGIN_REQUIRED         # 是否需要登录才能访问
MAINTENANCE_MODE       # 是否启用维护模式
NETBOX_USERNAME        # NetBox用户名
NETBOX_PASSWORD        # NetBox密码
PAGINATE_COUNT         # 分页大小
TIME_ZONE              # 时区设置
DATE_FORMAT            # 日期格式
SHORT_DATE_FORMAT      # 短日期格式
TIME_FORMAT            # 时间格式
SHORT_TIME_FORMAT      # 短时间格式
DATETIME_FORMAT        # 日期时间格式
SHORT_DATETIME_FORMAT  # 短日期时间格式

注意：NetBox仅支持PostgreSQL数据库，不支持MySQL。