일정에 따라 호스트와 서비스를 검색하고 네트워크 연결을 매핑해 네 가지 뷰를 최신 상태로 유지하는 셀프 호스팅 네트워크 스캐너입니다.
Pouzor/homelable
기기를 시각화하고 네트워크를 스캔하며 Zigbee, Z-Wave, Proxmox 정보를 가져오고 실시간 상태를 모니터링하는 셀프 호스팅 홈랩 시각화 도구입니다.
대체할 수 있는 제품:Lucidchart
draw.io
- 스타
- 4,509
- 포크
- 204
- 열린 이슈
- 34
- 마지막 커밋
- 5일 전
어떤 프로젝트인가요?
Homelable은 홈랩을 시각화하고 문서화하는 셀프 호스팅 도구입니다. nmap 기반 네트워크 스캔으로 발견한 머신과 서비스를 승인 대기열에 추가하며, 여기서 승인된 항목은 인터랙티브 캔버스에 표시됩니다. MQTT를 통해 Zigbee2MQTT와 Z-Wave JS UI에서 기기 토폴로지를 가져오고, REST API를 통해 Proxmox VE의 인벤토리도 가져올 수 있습니다.
캔버스의 각 노드는 ping, HTTP/HTTPS, TCP, SSH, Prometheus 메트릭 또는 /health 엔드포인트로 상태를 확인할 수 있으며, 결과는 다이어그램에 실시간으로 표시됩니다. 네트워크 맵 외에도 U 단위로 기기를 배치하고 포트를 패치할 수 있는 랙 캔버스와, 각 기기의 문서를 자동 생성하고 사용자가 작성한 페이지도 함께 관리하는 Markdown 문서 공간을 제공합니다.
앱은 Swagger 문서가 포함된 REST API, 키로 보호되는 읽기 전용 Live View 및 문서 뷰, gethomepage용 통계 엔드포인트, 그리고 AI 어시스턴트가 토폴로지를 읽고 수정할 수 있는 MCP 서버를 제공합니다.
핵심 기능
- 01nmap으로 네트워크를 스캔하고 발견한 기기를 승인 대기열에 추가
- 02ping, HTTP, TCP, SSH, Prometheus 또는 /health를 통한 노드별 실시간 상태 확인
- 03MQTT를 통한 Zigbee2MQTT 및 Z-Wave JS UI 가져오기
- 04호스트, VM, LXC 컨테이너를 Proxmox VE에서 가져오기
- 05U 높이 배치 및 포트 간 패치를 지원하는 랙 캔버스
- 06버전 기록과 기기별 문서를 제공하는 Markdown 문서 공간
- 07Swagger UI가 포함된 REST API 및 AI 어시스턴트용 MCP 서버
활용 사례
- 홈랩의 머신, 스위치, 서비스를 하나의 다이어그램에 시각화
- 대시보드에서 셀프 호스팅 서비스의 온라인 상태 모니터링
- 소규모 서버실의 물리적 랙 배치와 케이블 연결 관리
- 스마트홈 Zigbee 및 Z-Wave 기기를 동일한 네트워크 맵으로 가져오기
빠른 시작
- 1
사전 빌드된 GHCR 이미지를 사용해 Docker로 설치하세요(INSTALLATION.md 참조).
- 2
또는 포함된 스크립트를 사용해 Debian/Ubuntu 호스트에 베어메탈로 설치하세요.
sudo bash scripts/install-baremetal.sh
사용 전 알아둘 점
- 백엔드가 Docker 브리지 네트워크에서 실행되면 스캐너가 MAC 주소를 보고하지 않습니다.
- SYN 스캔 및 OS 감지와 같은 일부 nmap 스캔 유형에는 root 권한이 필요합니다.
- Zigbee 및 Z-Wave를 가져오려면 별도로 실행 중인 MQTT 브로커가 필요합니다.
포함된 컬렉션
토픽
자주 묻는 질문
- homelable은(는) 무엇인가요?
- 기기를 시각화하고 네트워크를 스캔하며 Zigbee, Z-Wave, Proxmox 정보를 가져오고 실시간 상태를 모니터링하는 셀프 호스팅 홈랩 시각화 도구입니다. Homelable은 홈랩을 시각화하고 문서화하는 셀프 호스팅 도구입니다. nmap 기반 네트워크 스캔으로 발견한 머신과 서비스를 승인 대기열에 추가하며, 여기서 승인된 항목은 인터랙티브 캔버스에 표시됩니다. MQTT를 통해 Zigbee2MQTT와 Z-Wave JS UI에서 기기 토폴로지를 가져오고, REST API를 통해 Proxmox VE의 인벤토리도 가져올 수 있습니다.
- 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
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
Proxmox, Docker, Kubernetes, TrueNAS, vSphere를 실시간으로 모니터링하는 셀프 호스팅 대시보드
Proxmox VE VM과 컨테이너를 조회·시작·중지·스냅샷 생성·모니터링하는 단일 파일 Bash TUI입니다.
Docker와 Podman 컨테이너의 경로를 자동으로 설정하고 Let's Encrypt 인증서, SSO, 유휴 절전 기능을 제공하는 WebUI 기반 경량 리버스 프록시입니다.
Zigbee 스마트 홈 기기를 MQTT에 연결해 제조사 전용 허브나 게이트웨이 없이 사용할 수 있게 해주는 브리지입니다.
브라우저에서 클라이언트 측 JavaScript로 실행하고 자체 호스팅할 수 있는 다이어그램 및 화이트보드 편집기입니다.