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机房里一根线断了没人说得清另一头接在哪要分配网段翻遍表格才发现两个团队把同一个 /26 记成了自己的。NetBox 就是解决这类问题的免费网络资产管理平台它把机架、设备、线缆、IP 地址、VLAN 和电路整理成一套可查询的数据模型并提供 REST 与 GraphQL 两个接口供自动化系统调用。你不需要一开始就搞懂全部功能先按下面的顺序把它跑起来用到哪块再深入哪块。先跑起来NetBox 的定位可以用一句话概括它是网络的图书馆目录——只负责记录网络应该长什么样不直接碰任何设备。目录本身不做盘点动作但你随时能查到每一本书在哪一层架子上你的 Ansible、监控或告警系统负责真正干活NetBox 把数据喂给它们。社区提供了 Docker 镜像方案是最省事的路线克隆仓库改一下docker-compose.yml里的 PostgreSQL 和 Redis 地址然后启动git clone https://gitcode.com/gh_mirrors/ne/netbox cd netbox # 编辑 docker-compose.yml填入数据库与 Redis 连接信息 docker compose up -d如果想从源码装需要 Python 3.123.13、3.14 也支持、PostgreSQL 14 及以上、Redis 5.0 及以上装完执行python manage.py migrate建表、createsuperuser建管理员账号即可完整步骤见仓库内的 安装文档。你想做什么三个高频场景录入一台新设备新建设备前先建好设备类型模板把端口数量、命名和机架尺寸定义清楚之后再录入实例时就只是选型号、填机架位置。同一批交换机只建一个设备类型端口模板复用后录入一台新设备通常只要一分钟录完用机架的前视图 / 后视图核对位置比翻列表更直观查清一条线路两头接在哪设备之间的物理路径不需要人肉爬线槽。选中端口做电缆追踪TraceNetBox 会沿着线缆逐跳展开本端端口、配线架跳线、对端交换机的哪个口一路到链路尽头。给配线架端口和电缆起统一的名字比如PDU-A12-口3追踪和搜索都更快每个对象都有变更记录谁在什么时候动过这根线可以直接查到看 IP 还剩多少前缀列表页会直接给出利用率容器前缀按子前缀占用的地址空间计算叶子前缀按已分配的地址和 IP 范围计算不用自己拿计算器核对。先建聚合aggregate再从中切前缀前缀从属于聚合层级对了利用率统计才准网关、VIP 这类特殊地址单独建小前缀并备注用途避免和常规业务网段混在一起从手工记录到自动化REST API全部对象挂在/api/下例如/api/dcim/devices/和/api/ipam/ip-addresses/运行实例的/api/schema/swagger-ui/提供交互式文档GraphQL API一次请求取回关联对象适合减少多轮调用事件规则对象创建、修改或删除时自动触发 webhook 或自定义脚本比如新增设备后自动通知监控系统配置渲染上传 Jinja2 模板后NetBox 可以按自身数据渲染设备配置供 Ansible 之类的工具下发CI/CD 集成把申请 IP 段 → 创建前缀 → 分配地址写成流水线步骤而不是每次手动登录网页一条命令验证 API 是否连通TOKEN换成你的 API 令牌curl -s -H Authorization: Token $TOKEN \ http://你的主机/api/ipam/ip-addresses/?q192.168 | jq .count更多接口说明见 REST API 文档插件机制的文档在 插件指南。经验笔记NetBox 不主动连接设备数据不会自己更新把改完配置必须回来补录写进变更流程否则目录会悄悄过期源码部署的完整栈是 Gunicorn 加 Nginx外加一个rqworker后台工作进程少了它后台任务会一直排队不执行权限粒度到字段级可以只让某人维护线缆而禁止他动 IP也可以把团队限定在某个租户范围内备份三件套PostgreSQL 数据转储、上传的媒体文件、configuration.py含密钥和数据库口令别只备数据库关注版本支持窗口PostgreSQL 14 和 Redis 6.0 之前的版本在 NetBox v4.7 起将不再受支持升级前先对表大规模部署时列表变慢优先检查搜索框是否被当成全字段模糊查询在滥用按站点、角色等结构化字段过滤会快得多自定义字段和标签可以挂到几乎所有对象上采购批次、维保到期日这类信息用它们存比塞进备注字段好维护NetBox 解决的核心问题只有一个让网络现在长什么样有一个权威答案并且这个答案可以被程序直接读取。建议下一步先拿一个真实机架练手录 2 台交换机、1 台配线架把 3 根线建出来再做一次电缆追踪——跑通这一圈你就知道它 80% 的功能了。【免费下载链接】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），仅供参考 NetBox 网络资产管理实用指南：从部署到查清每根线
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机房里一根线断了没人说得清另一头接在哪要分配网段翻遍表格才发现两个团队把同一个 /26 记成了自己的。NetBox 就是解决这类问题的免费网络资产管理平台它把机架、设备、线缆、IP 地址、VLAN 和电路整理成一套可查询的数据模型并提供 REST 与 GraphQL 两个接口供自动化系统调用。你不需要一开始就搞懂全部功能先按下面的顺序把它跑起来用到哪块再深入哪块。先跑起来NetBox 的定位可以用一句话概括它是网络的图书馆目录——只负责记录网络应该长什么样不直接碰任何设备。目录本身不做盘点动作但你随时能查到每一本书在哪一层架子上你的 Ansible、监控或告警系统负责真正干活NetBox 把数据喂给它们。社区提供了 Docker 镜像方案是最省事的路线克隆仓库改一下docker-compose.yml里的 PostgreSQL 和 Redis 地址然后启动git clone https://gitcode.com/gh_mirrors/ne/netbox cd netbox # 编辑 docker-compose.yml填入数据库与 Redis 连接信息 docker compose up -d如果想从源码装需要 Python 3.123.13、3.14 也支持、PostgreSQL 14 及以上、Redis 5.0 及以上装完执行python manage.py migrate建表、createsuperuser建管理员账号即可完整步骤见仓库内的 安装文档。你想做什么三个高频场景录入一台新设备新建设备前先建好设备类型模板把端口数量、命名和机架尺寸定义清楚之后再录入实例时就只是选型号、填机架位置。同一批交换机只建一个设备类型端口模板复用后录入一台新设备通常只要一分钟录完用机架的前视图 / 后视图核对位置比翻列表更直观查清一条线路两头接在哪设备之间的物理路径不需要人肉爬线槽。选中端口做电缆追踪TraceNetBox 会沿着线缆逐跳展开本端端口、配线架跳线、对端交换机的哪个口一路到链路尽头。给配线架端口和电缆起统一的名字比如PDU-A12-口3追踪和搜索都更快每个对象都有变更记录谁在什么时候动过这根线可以直接查到看 IP 还剩多少前缀列表页会直接给出利用率容器前缀按子前缀占用的地址空间计算叶子前缀按已分配的地址和 IP 范围计算不用自己拿计算器核对。先建聚合aggregate再从中切前缀前缀从属于聚合层级对了利用率统计才准网关、VIP 这类特殊地址单独建小前缀并备注用途避免和常规业务网段混在一起从手工记录到自动化REST API全部对象挂在/api/下例如/api/dcim/devices/和/api/ipam/ip-addresses/运行实例的/api/schema/swagger-ui/提供交互式文档GraphQL API一次请求取回关联对象适合减少多轮调用事件规则对象创建、修改或删除时自动触发 webhook 或自定义脚本比如新增设备后自动通知监控系统配置渲染上传 Jinja2 模板后NetBox 可以按自身数据渲染设备配置供 Ansible 之类的工具下发CI/CD 集成把申请 IP 段 → 创建前缀 → 分配地址写成流水线步骤而不是每次手动登录网页一条命令验证 API 是否连通TOKEN换成你的 API 令牌curl -s -H Authorization: Token $TOKEN \ http://你的主机/api/ipam/ip-addresses/?q192.168 | jq .count更多接口说明见 REST API 文档插件机制的文档在 插件指南。经验笔记NetBox 不主动连接设备数据不会自己更新把改完配置必须回来补录写进变更流程否则目录会悄悄过期源码部署的完整栈是 Gunicorn 加 Nginx外加一个rqworker后台工作进程少了它后台任务会一直排队不执行权限粒度到字段级可以只让某人维护线缆而禁止他动 IP也可以把团队限定在某个租户范围内备份三件套PostgreSQL 数据转储、上传的媒体文件、configuration.py含密钥和数据库口令别只备数据库关注版本支持窗口PostgreSQL 14 和 Redis 6.0 之前的版本在 NetBox v4.7 起将不再受支持升级前先对表大规模部署时列表变慢优先检查搜索框是否被当成全字段模糊查询在滥用按站点、角色等结构化字段过滤会快得多自定义字段和标签可以挂到几乎所有对象上采购批次、维保到期日这类信息用它们存比塞进备注字段好维护NetBox 解决的核心问题只有一个让网络现在长什么样有一个权威答案并且这个答案可以被程序直接读取。建议下一步先拿一个真实机架练手录 2 台交换机、1 台配线架把 3 根线建出来再做一次电缆追踪——跑通这一圈你就知道它 80% 的功能了。【免费下载链接】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），仅供参考