blob/netbox

NetBox Docker镜像

镜像概述

NetBox是一款IP地址管理(IPAM)和数据中心基础设施管理(DCIM)工具，最初由DigitalOcean的网络工程团队设计开发，专门满足网络和基础设施工程师的需求。它旨在作为网络运营的特定领域事实来源，帮助工程师高效管理网络资源和数据中心基础设施。

该Docker镜像基于Kubernetes环境优化，运行在Django Python框架之上，依赖PostgreSQL数据库。完整的依赖项列表可参见requirements.txt，源代码托管于https://github.com/netbox-community/netbox%EF%BC%8C%E8%AF%A6%E7%BB%86%E6%96%87%E6%A1%A3%E5%8F%AF%E5%9C%A8Read the Docs获取。

核心功能与特性

• IP地址管理(IPAM): 提供IP地址空间规划、分配和跟踪功能，支持前缀层次结构管理
• 数据中心基础设施管理(DCIM): 管理机架、设备、电缆连接等数据中心物理和逻辑资源
• 领域特定事实来源: 作为网络运营的权威数据源，确保信息准确性和一致性
• Web应用架构: 基于Django框架构建，提供直观的Web界面和API接口
• Kubernetes优化: 容器化设计，适配Kubernetes环境，支持灵活部署和扩展

使用场景

• 网络工程师用于IP地址规划、分配和跟踪
• 数据中心管理员管理机架、设备和连接关系
• 基础设施团队维护网络拓扑和资源 inventory
• 企业IT部门构建网络基础设施的统一管理平台

使用方法

基本部署要求

• PostgreSQL数据库实例
• 适当的网络配置，确保容器可访问数据库
• 必要的环境变量配置

Docker Run示例

bash
docker run -d \
  --name netbox \
  -p 8000:8000 \
  -e DB_HOST=postgres-host \
  -e DB_NAME=netbox \
  -e DB_USER=netboxuser \
  -e DB_PASSWORD=strongpassword \
  -e SECRET_KEY=your-secret-key \
  netboxcommunity/netbox:latest

Docker Compose示例

yaml
version: '3'

services:
  netbox:
    image: netboxcommunity/netbox:latest
    ports:
      - "8000:8000"
    environment:
      - DB_HOST=postgres
      - DB_NAME=netbox
      - DB_USER=netboxuser
      - DB_PASSWORD=strongpassword
      - SECRET_KEY=your-secret-key
    depends_on:
      - postgres

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

volumes:
  postgres_data:

环境变量说明

反馈与贡献

• 功能请求和bug报告: 请通过GitHub Issues提交，并使用https://github.com/netbox-community/netbox/issues/new/choose
• 一般讨论: 可加入netbox-discuss邮件列表或NetworkToCode Slack的#netbox频道
• 开发贡献: 有意贡献代码者，请先阅读贡献指南

相关项目

社区贡献的相关项目列表可参见https://github.com/netbox-community/netbox/wiki/Community-Contributions