andyshinn/netbox

NetBox 镜像文档

镜像概述和主要用途

NetBox是一款IP地址管理(IPAM)和数据中心基础设施管理(DCIM)工具，最初由DigitalOcean的网络工程团队设计开发，专门满足网络和基础设施工程师的需求。它作为Web应用运行在Django Python框架之上，使用PostgreSQL数据库存储数据。完整代码托管于GitHub，详细文档可在Read the Docs获取。

核心功能和特性

• IP地址管理(IPAM): 提供IP地址规划、分配和跟踪功能，支持前缀层次结构可视化管理
• 数据中心基础设施管理(DCIM): 管理数据中心物理基础设施，包括机架位置、设备部署和连接关系
• 技术架构: 基于Django Python框架开发，采用PostgreSQL数据库确保数据可靠性
• 多版本支持: 兼容Python 2.7和3.5（推荐使用Python 3.5版本）
• Web界面: 提供直观的Web管理界面，支持各类基础设施可视化操作

使用场景和适用范围

NetBox适用于以下场景：

• 企业网络环境中的IP地址规划与管理
• 数据中心物理基础设施的配置与监控
• 网络工程师日常运维中的资源分配与跟踪
• 大型网络架构的文档化与可视化管理
• 基础设施即代码(IaC)环境中的网络资源映射

使用方法和配置说明

Docker部署方式

NetBox提供Docker容器化部署选项，可通过社区维护的Docker镜像快速部署：

拉取Docker镜像

bash
docker pull ninech/netbox

docker-compose配置示例

创建docker-compose.yml文件，配置如下：

yaml
version: '3'
services:
  netbox:
    image: ninech/netbox
    ports:
      - "8000:8000"
    environment:
      - DATABASE_URL=postgres://netbox:netbox@postgres:5432/netbox
      - SECRET_KEY=your_secure_secret_key
      - ALLOWED_HOSTS=localhost,127.0.0.1
    depends_on:
      - postgres
  postgres:
    image: postgres:13
    environment:
      - POSTGRES_USER=netbox
      - POSTGRES_PASSWORD=netbox
      - POSTGRES_DB=netbox
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

启动服务

bash
docker-compose up -d

访问与使用

服务启动后，通过http://localhost:8000访问NetBox Web界面。首次登录使用默认管理员账户（用户名：admin，密码：admin），建议立即修改密码。

升级方法

如需升级NetBox，执行以下命令：

bash
docker-compose pull
docker-compose up -d

相关资源

• 官方代码库: https://github.com/digitalocean/netbox
• 完整文档: Read the Docs
• 社区支持:
  • 邮件列表：netbox-discuss
  • Slack频道：NetworkToCode Slack的#netbox频道