IPv4 / MAC 查询
当前文档版本 1.0.2 支持按 IPv4 或 MAC 查询终端接入位置。
已开源 / 可安装
NetBox Endpoint Locator
NetBox Endpoint Locator 主打 NetBox 联动 LibreNMS 的终端定位：通过 IP / MAC / VLAN / 端口证据映射回 NetBox 设备，减少手工查表和跨系统切换。
NetBox Endpoint Locator 是什么
NetBox Endpoint Locator 是 NetBox 插件，通过联动 LibreNMS 的 IP、MAC、VLAN 和端口证据，在 NetBox 界面中直接定位终端接入位置，减少跨系统手工查表。
适合谁使用
- 需要从 IP 或 MAC 定位终端接入交换机端口的 NetBox 用户
- 希望复用 LibreNMS 证据减少跨系统手工查询的网络团队
解决什么问题
终端接入位置常常需要跨 NetBox、LibreNMS、ARP、MAC 表和接口信息手工关联。
核心能力
LibreNMS 证据关联
通过 LibreNMS 查询 IP、MAC、VLAN、端口和设备证据，过滤聚合、路由和 trunk 类端口。
NetBox 设备映射
把 LibreNMS 返回的设备与接口证据映射回 NetBox 设备记录，减少跨系统手工查表。
终端端口过滤
候选端口会排除聚合、路由和 trunk 类接口，优先保留可能的终端接入口。
典型工作流
- 在 NetBox 中输入 IPv4 或 MAC
- 调用 LibreNMS 查询 IP、MAC、VLAN、端口和设备证据
- 过滤聚合、路由和 trunk 类端口
- 将最终设备映射回 NetBox 并展示接入结果
适用场景
- 终端定位
- 接入端口追踪
- 网络资产核查
输入
- IPv4 或 MAC 地址
- LibreNMS API 数据
- NetBox 设备资产
输出
- 候选和最终接入设备
- 交换机接口与 VLAN 证据
- 映射后的 NetBox 设备链接
部署和数据边界
- 插件安装在用户自己的 NetBox 环境
- 查询依赖用户配置的 LibreNMS URL 和令牌
- 不会替代 NetBox 或 LibreNMS 的资产与监控职责
克隆仓库
git clone https://github.com/Jaycelu/netbox_-endpoint_locator.git
cd netbox_-endpoint_locator安装插件
pip install -e .启用插件
PLUGINS = ["netbox_endpoint_locator"]
PLUGINS_CONFIG = {
"netbox_endpoint_locator": {
"librenms_url": "http://127.0.0.1:8000",
"librenms_token": "YOUR_TOKEN"
}
}重启 NetBox
sudo systemctl restart netbox netbox-rq系统要求
- NetBox 4.4.x
- Python 3.10 或更高版本
- 可访问的 LibreNMS API 与访问令牌
当前版本和更新时间
1.0.2
发布日期：2026-03-23
内容更新时间：2026-07-14
已知限制
- 目标环境为 NetBox 4.4.x
- 查询结果依赖 LibreNMS 中 ARP、FDB、VLAN 和接口数据的完整性
与同类工具对比
手工查询 ARP/MAC 表
手工查表需要跨 NetBox、LibreNMS 和交换机命令行。Endpoint Locator 一键关联证据并映射回 NetBox 设备。
LibreNMS 的原生终端查询
LibreNMS 提供设备级数据，但结果不关联 NetBox 资产。Endpoint Locator 把 LibreNMS 发现映射为 NetBox 设备记录和链接。
商业终端定位方案
商业方案通常需要独立许可和部署。Endpoint Locator 作为开源 NetBox 插件免费安装，利用已有 NetBox 和 LibreNMS 环境。
常见问题
可以通过什么信息查询终端？
当前支持使用 IPv4 或 MAC 地址查询。
为什么同时需要 NetBox 和 LibreNMS？
LibreNMS 提供动态 IP、MAC、VLAN 与端口证据，NetBox 提供规范化设备资产和可回链对象。
插件会修改网络设备配置吗？
不会。它读取 LibreNMS 和 NetBox 数据用于定位，不执行设备配置变更。
需要单独安装 LibreNMS 吗？
需要。插件读取 LibreNMS 的 API 数据作为证据源，不替代 LibreNMS 的监控职责。
查询结果准确吗？
准确度取决于 LibreNMS 中 ARP、FDB、VLAN 和接口数据的完整性。插件会过滤聚合、路由和 trunk 类端口以缩小范围。
产品截图
