Homelable
Homelable 是一款自托管的家庭实验室基础设施可视化工具,可扫描网络并导入 Proxmox、Zigbee 与 Z-Wave 数据,自动生成设备文档,并在交互式图上显示服务的实时健康状态。
访问 Pouzor/homelable项目简介
Homelable 是面向家庭实验室的自托管基础设施可视化与文档解决方案。它会扫描本地网络以及 Zigbee 和 Z-Wave 设备,依据扫描结果生成设备文档,并通过实时健康检查让图上的状态反映实际运行情况。Markdown Library 可在可视化地图旁保存运行手册、事件记录和网络说明。
核心功能
- 使用 nmap 扫描网络并将结果放入待处理设备队列,可批准、隐藏或忽略;自动生成每台设备的文档,并提供用于运行手册、事件记录和网络概览页面的 Markdown Library;通过 ping、HTTP/HTTPS、TCP、SSH、Prometheus 和 /health 方法对节点进行实时健康检查;从 Proxmox VE、Zigbee2MQTT 和 Z-Wave JS UI 导入数据,来源包括 MQTT 或 REST API;提供带 U 高度、面板、端口到端口跳线、平面图和按设备设计定制的机架画布;提供只读 Live View 和
适用场景
- 让家庭实验室文档与网络中实际存在的设备和服务保持同步;绘制网络拓扑,并在交互式画布上直接查看在线或离线状态;导入现有 Proxmox VE 虚拟化清单或 Zigbee/Z-Wave 设备拓扑,避免手动重新录入设备;在局域网内分享只读画布或文档空间,或通过 REST API 和 MCP 服务器连接脚本与 AI 助手。
快速开始
- 下载最新版本或使用预构建的 GHCR Docker 镜像;按照安装文档完成 Docker、Proxmox LXC、裸机 systemd 与 nginx 或源码构建配置;运行网络扫描,然后批准发现的设备以将其加入画布;可选地从 Proxmox VE、Zigbee2MQTT 或 Z-Wave JS UI 导入,配置健康检查,并添加 Library 页面。
部署与要求
- Docker 部署使用预构建的 GHCR 镜像;也记录了 Proxmox LXC 以及在 Debian/Ubuntu 上使用 systemd 和 nginx 的裸机安装方式;Zigbee2MQTT 和 Z-Wave JS UI 导入需要可访问的 MQTT 代理,例如 Mosquitto;Proxmox VE 导入需要可访问的 Proxmox 主机以及具有只读 PVEAuditor 角色的 API 令牌;gethomepage 小部件要求 gethomepage 容器能访问后端 8000 端口;某些 nmap 扫描类型可能需要 root 或
采用前须知
- 许可证:MIT。在使用、修改或分发项目前,请确认其具体条款。