产品范围与边界
本文档定义 MiBee Steward 是什么、不是什么、以及它在行业中的位置。功能列表与快速上手见项目概述。
MiBee Steward 是什么
MiBee Steward 是一个设备/网络层的资产发现、识别与登记工具。它回答三个问题：
- 网络上有哪些设备？，通过 ICMP / TCP 端口扫描 / SNMP / HTTP / RTSP / ONVIF / mDNS / WS-Discovery 探测自动发现，外加可选的 eBPF 被动观测
- 它们是什么？，通过 banner / HTTP / RTSP / ONVIF / SNMP / Prometheus 指纹分类，推断设备类型、品牌、型号
- 持续跟踪，登记/管理 + 基于心跳的资产鲜活度（在线/离线 + 延迟 + 历史）
它是面向网络与 IoT 资产的轻量 CMDB，以单个零依赖二进制交付（Go + SQLite + 内嵌 SvelteKit SPA）。
MiBee Steward 不是什么（有意的产品边界）
MiBee Steward 有意不构建成熟工具已经做得更好的能力。这些是产品边界，不是缺口：
| 能力 | 请使用 | 我们不做的原因 |
|---|---|---|
| 告警 | Prometheus Alertmanager | 我们通过 /metrics 暴露数据；告警什么、何时告警由 Alertmanager 决定 |
| 仪表盘 / 可视化 | Grafana | 内置 ECharts 仅用于资产概览，不替代 Grafana |
| 状态页 | Uptime Kuma | 不同的赛道，那是它的核心能力 |
| 主机深度监控（CPU/内存/磁盘） | Netdata / node_exporter | 我们发现 node_exporter；我们不是 node_exporter |
| 服务层发现 | Consul / eureka | 我们发现的是设备（L2-L4），不是服务实例（L7） |
如果你需要上述任何能力，把对应工具与 MiBee Steward 一起部署即可--它们原生消费我们的 /metrics 和 /sd 端点。
核心能力
自动发现 + 身份识别 + 登记，面向网络与 IoT 设备。
差异化在于身份识别的准确度与广度：通过协议指纹认出"这台 IP 是海康摄像头、那是华为交换机、那是 APC UPS、那是树莓派"。这通过社区可贡献的指纹/规则库随时间积累构建。
衍生能力（准确资产数据的副产品）
- 心跳，保持资产登记鲜活（在线/离线 + 延迟 + 历史）。不是为了告警，是为了资产鲜活度。心跳数据通过
/metrics流向 Prometheus；告警由 Alertmanager 处理。 - 设备配置备份，定时 SSH 拉取 running-config（Oxidized/RANCID 式），版本化 + diff；配置变更进入变更检测引擎。是设备登记之上的网络运维工作流，不是配置管理（不向设备下发任何配置）。
- 拨测，blackbox 风格的显式配置外部端点周期探测（可用性/延迟/证书到期），把 TLS 清点能力复用到局域网之外。
- 变更通知，规则驱动地把设备/配置变更事件投递到 webhook/邮件渠道；是投递链路而非告警引擎（无阈值、无静默、无路由树）。
- Prometheus 出口，
/metrics（资产状态指标 + 心跳计数器）+/sd（HTTP 服务发现，自动把资产注册到 Prometheus） - 单二进制部署，零运行时依赖，CGO-free，可交叉编译到 linux/amd64 + arm64
MiBee Steward 的位置
MiBee Steward 站在已有类别的交叉点，这些类别都不是它的本体：
| 类别 | 例子 | 它们缺失的 |
|---|---|---|
| 资产登记（CMDB） | NetBox、Snipe-IT | 手动录入，无自动发现 |
| 服务发现 | Consul、eureka | L7 服务，不是 L2-L4 设备 |
| 扫描器 | nmap | 无管理界面、无持续登记、无身份识别 |
| 网络监控 | LibreNMS、Zabbix | SNMP 重、监控导向、无身份识别 |
MiBee Steward 的独特格子：自动发现（nmap 级）+ 身份识别（基于指纹）+ 登记/管理（CMDB-lite）+ 单二进制。上述类别都没有占据这个组合。
常见误解：MiBee Steward 有时被拿来与轻量监控工具（Beszel / Uptime Kuma / Netdata）比较。这是类别错误，那些工具监控你已经知道的主机/服务；MiBee Steward 是去发现"那里到底有什么"。
使用场景
- 网络资产清单，自动发现并登记网络上的设备，识别品牌/型号
- IoT / 摄像头舰队发现，按品牌/型号识别 IP 摄像头、传感器、控制器（摄像头是当前的优先场景，因为 RTSP+ONVIF 指纹清晰、需求明确，不代表 MiBee Steward 是摄像头专属工具）
- 分支机构 / SOHO 网络画像，在 LibreNMS 显得过重的小型网络中足够轻量
- 实验室 / 边缘资产跟踪，用灵活的探测配置和持续鲜活度跟踪研究或边缘设备
设计原则
- 单二进制，零运行时依赖，
scp后运行。无需 Docker/数据库/Node。 - CGO-free，可交叉编译到 linux/amd64 + arm64。
- Prometheus 原生出口，资产数据流入 Prometheus 生态；我们不与它竞争。
- 插件化发现，添加协议只需注册一个分类器 + 一个处理器（见
scannerv2/架构）。 - 身份识别是差异化点，投入优先级是指纹/规则库的广度与准确度。
- 边界即特性，我们不做什么和我们做什么一样经过深思熟虑。不要在 MiBee Steward 内部重造 Alertmanager/Grafana/Kuma。