Pouzor/homelable

这是什么？

核心功能

• 01基于 nmap 的网络扫描，发现的设备进入待确认队列
• 02按节点配置 ping、HTTP、TCP、SSH、Prometheus 或 /health 等方式实时检测状态
• 03通过 MQTT 导入 Zigbee2MQTT 和 Z-Wave JS UI 的设备拓扑
• 04从 Proxmox VE 导入宿主机、虚拟机和 LXC 容器
• 05机柜视图支持按 U 位摆放设备并连接端口
• 06Markdown 文档空间，支持历史版本和设备文档自动生成
• 07提供 REST API、Swagger 文档和供 AI 助手使用的 MCP 服务器

适用场景

• 在一张图中梳理家庭实验室的机器、交换机和服务
• 通过看板监控各项自托管服务是否在线
• 为小型机房记录机柜布局和线缆连接
• 把智能家居的 Zigbee 和 Z-Wave 设备纳入同一张网络拓扑图

快速上手

1. 1

   使用预构建的 GHCR 镜像通过 Docker 安装（参见 INSTALLATION.md）

2. 2

   或者在 Debian/Ubuntu 主机上使用随附脚本进行裸机安装

   sudo bash scripts/install-baremetal.sh

使用前须知

• !当后端运行在 Docker bridge 网络中时，扫描结果不包含 MAC 地址。
• !部分 nmap 扫描类型（如 SYN 扫描和操作系统检测）需要 root 权限。
• !Zigbee 和 Z-Wave 导入需要另外运行一个 MQTT 代理。

收录于专题

标签

常见问题

homelable 是什么？

自托管的 homelab 基础设施可视化工具，支持网络扫描、Zigbee/Z-Wave/Proxmox 导入和在线状态监控。 Homelable 是一款自托管工具，用于绘制和记录家庭实验室（homelab）的基础设施。它基于 nmap 进行网络扫描，把发现的机器和服务放入待处理队列，确认后即可添加到交互式画布上。它还能通过 MQTT 从 Zigbee2MQTT 和 Z-Wave JS UI 导入设备拓扑，并通过 Proxmox VE 的 REST API 导入虚拟机和容器清单。

homelable 可以免费使用吗？用的什么许可证？

homelable 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

homelable 还在维护吗？

活跃维护中。homelable 最近一次提交是在 2026年10月19日。

homelable 适合用来做什么？

在一张图中梳理家庭实验室的机器、交换机和服务 通过看板监控各项自托管服务是否在线 为小型机房记录机柜布局和线缆连接 把智能家居的 Zigbee 和 Z-Wave 设备纳入同一张网络拓扑图

homelable 怎么安装和运行？

使用预构建的 GHCR 镜像通过 Docker 安装（参见 INSTALLATION.md） 或者在 Debian/Ubuntu 主机上使用随附脚本进行裸机安装: sudo bash scripts/install-baremetal.sh

在哪里获取 homelable？

源代码和安装说明在 GitHub 上：https://github.com/Pouzor/homelable