$ cat ~/map/pi-librenms.md

pi-librenms

面向 pi 的 LibreNMS 网络监控工具：经 REST API 直查设备、端口、告警与 Oxidized 配置，无需 MCP 层。

extensions✓ 9月22日

pi install git:github.com/ninjaltd/pi-librenms（或按 URL 安装），然后重启 pi 或执行 /reload；配置可经 LIBRENMS_URL 与 LIBRENMS_TOKEN 环境变量、PI_LIBRENMS_CONFIG 指定的文件、默认的 ~/.config/pi-librenms/config.env，或项目本地的 .pi/librenms.json

## 速览

pi-librenms 为 pi 增加二十个 LibreNMS 工具，智能体可经 LibreNMS REST API 查询设备、端口、中断记录、syslog、告警、BGP 会话、硬件清单与 Oxidized 配置——无需 MCP 层，用 LIBRENMS_URL 与 API token 配置。

## 要点

• $监控覆盖面：librenms_ping 验证连通性与 token；设备列表可按 up、down、all 过滤；设备维度工具覆盖端口、中断历史、事件日志与 syslog 搜索；按 ID 查端口与按 MAC 地址定位补齐接口侧能力。
• $告警与清单面：当前与历史告警、设备位置、设备组，以及横跨组件、模块与机箱的硬件清单。
• $BGP 与 Oxidized：全部 BGP 会话及单会话详情，外加 Oxidized 三件套——被跟踪的设备、每台设备最近备份的配置、按字符串检索全部已存配置。
• $受守卫的写入路径：device_maintenance_status 报告设备是否处于维护窗口，device_maintenance 负责将设备置入——行动前先请求确认。
• $配置按文档写明的首次命中即胜出顺序解析：环境变量，其次 PI_LIBRENMS_CONFIG 指定的文件路径，再次 ~/.config/pi-librenms 下的默认 config.env，最后项目本地的 .pi/librenms.json。
• $不经过 MCP 层：扩展直接调用 LibreNMS REST API——README 将整个技术栈概括为 pi、一个扩展和一个 read API token。

## 常见问题

## 参考链接

• README ↗

最后更新: 2026年9月22日