跳过主要内容
广告OpenFree logo推广你的产品触达更多潜在用户,助力产品增长与收益提升。投放广告
Favicon of Homelable

Homelable

Free 等级项目

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。在使用、修改或分发项目前,请确认其具体条款。

评论

登录 后发表评论。

更多类似 Homelable 的项目

Favicon of Checkmate

Checkmate

Free 等级项目星标数: 11.1K

开源自托管可用性与基础设施监控

可观测性与追踪

Checkmate 是开源、自托管的监控应用,可实时跟踪服务器硬件、正常运行时间、响应时间和故障事件,并通过可视化界面和告警报告可用性、停机与响应时间;可选 Capture 代理补充 CPU、内存、磁盘和温度数据。