NetBox是一个开源的基础设施资源管理平台，它的核心价值在于把网络环境中的物理设备、逻辑地址和连接关系集中到一个可查询、可编程的数据模型中。与传统的CMDB不同，NetBox从一开始就面向网络自动化设计，所有对象都支持通过REST API和GraphQL进行读写，这也让它成为许多自动化工作流的单一数据源。无论是规划新的子网、登记新上架的交换机，还是记录服务器到交换机的线缆连接，都可以在NetBox中完成，并为后续的配置生成和变更追踪提供基础。
NetBox的核心定位与数据模型
NetBox并不执行网络设备的实际配置，也不替代SNMP监控或日志分析系统。它的职责是维护网络的预期状态，也就是所谓的权威数据源。设备配置、路由表、接口状态等运行时数据可以发生变化，但NetBox中记录的设备角色、IP地址分配、机柜位置等信息，则是团队共同约定的权威数据。这种定位让NetBox在自动化链路中扮演关键角色：任何自动化脚本都可以用NetBox作为参数来源，避免硬编码和手工维护清单。
在数据模型方面，NetBox采用Django ORM构建了丰富的对象类型，主要包括站点、区域、机柜、设备类型、设备、接口、IP地址、前缀、VLAN、电路、虚拟化等。设备可以归属于一个站点和一个机柜，拥有多个接口；每个接口可以绑定一个IP地址，IP地址又归属于某个前缀；前缀可以关联VLAN；设备类型定义了接口模板和物理规格。这种层层关联的结构让数据之间的引用关系非常清晰，也方便做容量规划，例如统计某个机柜剩余多少U空间，或某个前缀还有多少可用地址。
NetBox还支持自定义字段、标签和配置上下文，允许团队在标准模型之外扩展业务属性。比如可以为设备增加资产编号、采购日期、维保到期时间等字段，或者给不同站点的设备附加不同的配置模板变量。相比普通表格，这种扩展不需要改变数据库结构，却能让同一个平台服务于不同团队的管理需求。
安装部署与初始配置
NetBox官方推荐使用Docker进行部署，因为依赖组件较多，包括PostgreSQL数据库、Redis缓存和可选的LDAP认证。最简单的方式是通过GitHub获取官方的docker-compose仓库，修改环境变量后执行docker compose up。以下是一个精简版的docker-compose编排示例，展示了NetBox服务、数据库和缓存的基本关系。
version: '3.8'
services:
netbox:
image: netboxcommunity/netbox:latest
environment:
- DB_NAME=netbox
- DB_USER=netbox
- DB_PASSWORD=change-me
- REDIS_HOST=redis
ports:
- "8000:8080"
depends_on:
- postgres
- redis
postgres:
image: postgres:15
environment:
- POSTGRES_DB=netbox
- POSTGRES_USER=netbox
- POSTGRES_PASSWORD=change-me
volumes:
- netbox-db:/var/lib/postgresql/data
redis:
image: redis:7
volumes:
netbox-db:
首次启动后，需要创建超级用户并完成基本配置。登录Web界面后，建议先建立组织层级：创建区域、站点、租户，然后定义设备角色和平台，最后录入设备类型。设备类型相当于硬件模板，包含制造商、型号、物理尺寸和接口模板。通过先录入设备类型，后续添加具体设备时可以直接复用接口定义，减少重复录入和人工错误。
NetBox的配置文件位于netbox/configuration.py，可以通过环境变量覆盖其中的SECRET_KEY、ALLOWED_HOSTS、数据库连接等参数。生产环境建议启用HTTPS，并使用独立域名。NetBox也支持SSO认证，可对接企业已有的身份系统，避免为每次操作单独维护账号。
IP地址管理实践
IP地址管理是NetBox最常用的功能。网络管理员可以先创建IP前缀，例如10.0.0.0/16，再为每个业务区域划分子网，比如10.0.1.0/24用于办公网，10.0.2.0/24用于服务器网段。每个前缀可以关联VLAN、站点和角色，并设置描述信息。NetBox会自动计算前缀的可用地址数量、已用数量和利用率，在规划扩容时非常直观。
为设备接口分配IP地址时，可以直接在前缀下点击添加IP地址，或从接口详情页选择所属前缀并建议一个可用地址。NetBox会检查地址是否冲突，如果已被占用会给出提示。相比在Excel中手工标记，这种方式能有效避免重复分配。此外，多个IP地址可以绑定到同一个接口，例如服务器接口同时配置IPv4和IPv6地址，NetBox支持将两者关联到同一物理接口。
NetBox还支持NAT映射、VLAN和VRF。通过VRF可以隔离不同路由域，避免在大型网络中不同客户或业务之间的地址重叠问题。比如两个客户都使用192.168.1.0/24，分别归属不同VRF，NetBox可以区分它们而不会产生冲突。这种逻辑隔离能力对运营商和多租户数据中心尤其重要。
设备与机柜管理
设备管理从创建站点和机柜开始。机柜可以设置高度单位、起始位置和左右朝向，NetBox会以图形化方式显示机柜中的设备位置，帮助机房人员快速定位。设备可以指定机柜和具体U位，例如一台48口交换机占用1U，一台2U服务器占用2U。NetBox会统计机柜剩余空间，并提示空间冲突。
设备接口继承自设备类型，可以在设备创建后自动生成。管理员可以为每个接口设置名称、类型、速率、连接对象等。比如交换机的GigabitEthernet0/1接口连接到服务器eth0接口，连接类型选择直连，还可以记录线缆编号和颜色。这种连接关系在排查物理链路故障时非常有用，不再需要翻看端口表或猜测线缆走向。
为了适应不同团队的管理习惯，NetBox支持自定义字段，例如增加资产编号、维护窗口、上架日期等。标签可以灵活标记设备是否属于生产环境、是否待退役等。这些元数据可以作为自动化过滤条件，例如只对标签为prod的设备执行配置生成。
API与自动化集成
NetBox的所有数据都可以通过REST API访问，同时提供GraphQL查询接口。API遵循标准的HTTP语义，支持分页、过滤和排序。例如要获取所有生产环境中状态为active的设备，可以请求/api/dcim/devices/?status=active&tag=prod。返回结果为JSON格式，方便在脚本中处理。以下Python示例演示了使用requests库查询设备列表，并打印设备名称和主IPv4地址。
import requests
url = "https://netbox.ipipp.com/api"
headers = {"Authorization": "Token your-api-token"}
params = {"status": "active", "tag": "prod"}
response = requests.get(f"{url}/dcim/devices/", headers=headers, params=params)
if response.status_code == 200:
for device in response.json()["results"]:
print(device["name"], device["primary_ip4"])
Ansible用户可以通过NetBox动态库存插件直接读取设备清单。在ansible.cfg中启用netbox插件，并配置API地址和Token，就可以用netbox作为inventory来源。这样当NetBox中添加新设备后，Ansible下一次执行就能自动发现，无需修改库存文件。类似地，Terraform可以使用NetBox provider管理IP地址和前缀，实现基础设施即代码。
Webhooks是NetBox自动化的重要组件。当某个对象创建、更新或删除时，NetBox可以发送HTTP POST请求到指定的Webhook端点，并携带JSON数据。例如可以在新IP地址分配时通知工单系统，或者在设备下线时触发清理脚本。配合自定义字段和标签，Webhook的条件可以设置得非常灵活，从而实现闭环的自动化运维。
NetBox并不是一个开箱即用的完整解决方案，它需要团队投入时间去梳理数据模型和录入规范。但一旦建立起可靠的资源数据基础，NetBox带来的收益会随着自动化程度的提高而不断放大。对于正在从手工表格向网络自动化转型的团队，NetBox是一个值得优先评估的开源平台。