NetBox 数据中心资产管理搭建教程

NetBox 是由 DigitalOcean 团队开发的开源数据中心基础设施管理（DCIM）和 IP 地址管理（IPAM）工具。它被广泛应用于网络工程和运维领域，可以记录和管理网络设备、IP 地址分配、机架布局、线缆连接等信息。本文将介绍如何在搬瓦工 VPS 上通过 Docker 部署 NetBox。

一、NetBox 核心功能

IPAM（IP 地址管理）：管理 IP 地址、子网、VLAN 和 VRF 的分配和使用。
DCIM（数据中心管理）：记录机架、设备、电源、线缆等物理基础设施。
设备管理：维护设备型号库、序列号、资产标签等设备台账信息。
线路管理：记录网络线路、运营商信息和服务合同。
虚拟化：管理虚拟机集群、虚拟机和虚拟接口。
REST API：完整的 REST API 支持，方便与自动化工具集成。
自定义字段：可以根据需要添加自定义属性字段。

二、环境准备

搬瓦工 VPS 一台，建议 2GB 以上内存（使用优惠码 NODESEEK2026 享受 6.77% 折扣）。
已安装 Docker 和 Docker Compose（参考 Docker 安装教程）。
域名一个（推荐配置 HTTPS）。

三、使用官方 Docker 部署

3.1 克隆官方仓库

git clone -b release https://github.com/netbox-community/netbox-docker.git /opt/netbox
cd /opt/netbox

3.2 创建环境配置

cat > /opt/netbox/docker-compose.override.yml <<'EOF'
version: '3.8'

services:
  netbox:
    ports:
      - "8000:8080"
    environment:
      ALLOWED_HOSTS: netbox.yourdomain.com
      SUPERUSER_NAME: admin
      SUPERUSER_EMAIL: admin@yourdomain.com
      SUPERUSER_PASSWORD: your_admin_password
      SUPERUSER_API_TOKEN: your_api_token_here
EOF

3.3 生成密钥

# 生成 SECRET_KEY
python3 -c "import secrets; print(secrets.token_urlsafe(50))"

将生成的密钥写入 .env 文件或环境变量中。

四、启动 NetBox

cd /opt/netbox
docker compose up -d

NetBox 启动需要一些时间来初始化数据库和静态文件。查看日志确认启动完成：

docker compose logs -f netbox

当看到类似 Listening at: http://0.0.0.0:8080 的输出时，表示服务已就绪。访问 http://VPS_IP:8000 并使用之前设置的管理员账号登录。

五、配置 Nginx 反向代理

cat > /etc/nginx/sites-available/netbox <<'EOF'
server {
    listen 80;
    server_name netbox.yourdomain.com;

    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    location /static/ {
        proxy_pass http://127.0.0.1:8000/static/;
        expires 30d;
    }

    client_max_body_size 25m;
}
EOF

ln -sf /etc/nginx/sites-available/netbox /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d netbox.yourdomain.com

六、基础使用指南

6.1 添加站点和机架

在「组织」菜单中创建站点（Sites），例如「北京数据中心」。
在站点下创建机架（Racks），设置机架高度（U 数）。
可以查看机架正视图和背视图，管理设备安装位置。

6.2 管理 IP 地址

在「IPAM」菜单中创建前缀（Prefixes），如 10.0.0.0/8。
在前缀下分配 IP 地址，关联到设备接口。
NetBox 会自动跟踪 IP 使用率，方便规划地址空间。

6.3 设备管理

先创建设备厂商和设备类型（如 Dell PowerEdge R740）。
然后添加具体设备，关联到机架位置。
为设备添加接口、IP 地址和线缆连接信息。

七、API 使用

NetBox 提供完整的 REST API，可以与 Ansible、Terraform 等自动化工具集成：

# 获取所有设备列表
curl -H "Authorization: Token your_api_token" \
  https://netbox.yourdomain.com/api/dcim/devices/

# 获取 IP 地址列表
curl -H "Authorization: Token your_api_token" \
  https://netbox.yourdomain.com/api/ipam/ip-addresses/

八、数据备份

# 备份 PostgreSQL 数据库
docker compose exec postgres pg_dump -U netbox netbox > /opt/netbox/backup_$(date +%Y%m%d).sql

# 备份媒体文件
docker cp $(docker compose ps -q netbox):/opt/netbox/netbox/media /opt/netbox/media_backup

九、常见问题

静态文件 404

如果页面样式丢失，重新收集静态文件：

docker compose exec netbox python manage.py collectstatic --no-input

数据库迁移错误

版本升级后如果出现数据库迁移问题：

docker compose exec netbox python manage.py migrate

总结

NetBox 是网络工程师和运维人员管理基础设施的利器，特别适合需要管理大量 IP 地址和网络设备的场景。配合 Snipe-IT 资产管理可以覆盖更全面的 IT 资产管理需求。选购搬瓦工 VPS 请访问 bwh81.net，使用优惠码 NODESEEK2026 享受 6.77% 折扣。