szechyjs/netbox

Netbox Docker镜像

Netbox Docker镜像是用于部署和运行https://github.com/digitalocean/netbox的容器化解决方案，NetBox是一款开源的网络设备管理工具，旨在帮助网络管理员跟踪和管理网络基础设施。

镜像概述和主要用途

本镜像提供了NetBox的容器化部署方式，简化了传统部署流程，使管理员能够快速搭建NetBox服务。通过Docker容器，可实现环境隔离、版本控制和便捷的服务管理，适用于各类网络管理场景。

核心功能和特性

• 容器化部署：无需手动配置依赖环境，通过Docker快速部署NetBox
• docker-compose支持：提供示例配置文件，简化多容器服务（NetBox、数据库等）的管理
• 环境变量配置：支持通过环境变量自定义NetBox配置，如允许的主机名、密钥等
• 数据持久化：通过Docker卷实现数据持久化，确保服务重启后数据不丢失

使用场景和适用范围

• 网络管理团队快速部署NetBox进行网络设备跟踪和管理
• IT基础设施管理中需要集中管理网络资源的场景
• 开发或测试环境中快速搭建NetBox实例
• 需要隔离部署环境的企业或组织

使用方法和配置说明

使用docker-compose部署

步骤1：复制示例配置文件

复制 docker-compose.example.yml 文件到本地：

console
$ cp docker-compose.example.yml docker-compose.yml

步骤2：配置环境变量

至少需要修改以下环境变量：

• ALLOWED_HOSTS：接受多个主机名，使用空格分隔（例如："netbox.example.com 192.168.1.100"）
• SECRET_KEY：必填项，应随机生成且https://github.com/digitalocean/netbox/blob/8563e2aca30fd160b62bbf1f734b2b3b0cf24cfe/docs/configuration.md#secret_key

可选修改数据库密码，通过修改以下两个环境变量（需保持一致）：

• POSTGRES_PASSWORD：PostgreSQL数据库密码
• DB_PASS：NetBox连接数据库的密码

步骤3：创建超级用户

执行以下命令创建NetBox超级用户：

console
$ sudo docker-compose run --rm netbox createsuperuser

根据提示输入用户名、***和密码。

步骤4：启动服务栈

启动所有服务容器：

console
$ sudo docker-compose up -d

服务启动后，NetBox将通过8000端口可用，可通过浏览器访问 http://<主机IP>:8000。