3行命令跑通NetBox网络管理平台一篇讲透【免费下载链接】netboxThe premier source of truth powering network automation. Open source under Apache 2. Try NetBox Cloud free: https://netboxlabs.com/products/free-netbox-cloud/项目地址: https://gitcode.com/gh_mirrors/ne/netbox凌晨三点一条跨机架链路挂了。那根光纤在哪个机架、插在哪个交换机端口、对端是什么IP拓扑在一份40页的Excel里IP分配在另一个表格接线记录在一个半年没人更新的wiki页面。NetBox 是开源网络基础设施管理平台把资产、地址、接线这三类数据统一收进一个结构化数据库查任何一端都能一步跳到另一端。NetBox是什么不是什么建模与运维的分界线NetBox 属于网络基础设施建模层也就是传统意义上的 DCIM IPAM把机架、设备、端口、IP、电缆全部存进关系型数据库作为网络的唯一真相源。它的边界很清楚不连接网络设备、不推送配置、不做流量监控只负责回答网络应该长什么样然后把这份数据开放给自动化、监控、告警工具去消费。和多张Excel加wiki页面的做法相比区别在于对象之间互相引用打开一个 IP能看到它挂在哪个接口、哪台设备、哪个机架打开一个端口能直接看到线缆另一端接在哪里。3行命令跑起一个实例前置条件是 Python 3.12、PostgreSQL 14、Redis 5.0安装指南 里有完整依赖说明。git clone https://gitcode.com/gh_mirrors/ne/netbox cd netbox python3 -m venv venv source venv/bin/activate pip install -r requirements.txt python netbox/manage.py migrate python netbox/manage.py runserver 0.0.0.0:8000运行前记得把netbox/netbox/configuration_example.py复制为netbox/netbox/configuration.py把数据库指向你的 PostgreSQL 和 Redis。浏览器打开 http://localhost:8000 看到登录页、manage.py createsuperuser建号后能进入首页就算跑通了。能力地图按你要做的事组织记录物理资产从站点到U位站点、位置、机架的层级对应你的真实数据中心。先建设备类型厂商、型号、端口模板再从它批量创建设备实例。机架有前/后视图设备按 U 位占空间插满会直接报错——不会等搬完设备才发现放不下。管好地址空间层级切分加冲突拦截前缀管理是分层的录入 10.0.0.0/16在它下面切出 /24再切 /26都是一次点击。系统记录每个子网属于哪个站点、哪个租户把 IP 分配给接口时自动校验——不在前缀池里、或者已被占用当场拒绝。搞清楚线是怎么接的一步连线一步追踪用电缆对象把设备接口和交换机端口连起来即可。核心是电缆追踪输入任一端端口自动给出完整路径——经过几台设备、每跳的哪个端口排障时直接看图不用拿光笔一根根测。登记外部依赖与供电运营商专线电路、电路组、配电面板和电源馈线都能登记电源馈线可以挂到机架和插座上做容量规划时能看到一条链路的完整供电上下级。一条新设备上线的完整实操链路建站点层级依次创建站点、位置、机架指定机架高度与安装位置。定义设备类型填厂商、型号、端口模板同型号再上线时端口直接复用。创建设备选择设备类型和机架指定 U 位填序列号。绑定 IP从对应前缀池中给接口选地址池外地址会被系统拦下。画电缆把端口连到上游交换机端口选择线缆类型与长度。验证对该端口执行电缆追踪路径指向正确的交换机端口即完成。这套数据是互相校验的想删掉一个还连着电缆的接口 IP会被自动阻止从机制上减少文档和现场对不上。接入现有自动化API对接的最低成本方式如果你已经在用 Ansible 或自研工具最小接入路径是 REST API在界面里创建 API Token然后curl -s -H Authorization: Token your-token \ http://localhost:8000/api/dcim/devices/?namecore-sw01返回的 JSON 里包含每台设备的接口、线缆状态和已绑定的 IPplaybook 可以直接消费。所有对象类型都有对应端点自带 OpenAPI 描述细节见 REST API 文档。内置的 Webhook 与事件规则则解决了反向通知新建设备时自动向指定地址发 POST对接监控系统不用写轮询脚本。数据模型之外有额外需求还可以写插件扩展。踩坑记录最高频的3个坑1. 启动后页面全报 500现象runserver起来后访问任何页面都报错原因没有configuration.py应用读不到数据库配置解法cp netbox/netbox/configuration_example.py netbox/netbox/configuration.py改好连接信息再 migrate2. IP 分配报冲突现象给接口分配地址时提示不在前缀池内或已被分配原因父前缀状态标成了使用中而非池状态或地址确实绑在别的接口上解法把前缀状态改为 Container / Pool或查该地址确认当前绑定对象3. 生产环境样式丢失现象线上静态资源 404页面裸奔原因开发模式靠内存分发静态文件生产必须收集解法python netbox/manage.py collectstatic并把 Web 服务器指向静态目录下一步录入一个真实机架挑你负责的一台机架把设备和线缆全录进去用电缆追踪检验数据完整性。打通一次 API 调用创建 Token用 curl 查一台设备再换成 Python requests。配一条事件规则让新设备创建时自动触发 Webhook 通知内部渠道。两个文档入口安装与部署、REST API 参考。NetBox 作为网络基础设施管理平台价值在于把那根光纤插在哪个口从打电话问人变成一次查询——数据在库里答案永远是一步之遥。【免费下载链接】netboxThe premier source of truth powering network automation. Open source under Apache 2. Try NetBox Cloud free: https://netboxlabs.com/products/free-netbox-cloud/项目地址: https://gitcode.com/gh_mirrors/ne/netbox创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考