Brandawg93/PeaNUT

어떤 프로젝트인가요?

핵심 기능

• 01NUT를 통해 네트워크상의 여러 UPS 장치 상태와 실시간 통계를 모니터링
• 02UI에서 UPS 장치에 명령을 실행하고 쓰기 가능한 변수를 수정
• 03다른 도구와 연동할 수 있는 REST API 및 WebSocket 엔드포인트
• 04Grafana 대시보드용 Prometheus 메트릭 및 InfluxDB v2 지원
• 05Homepage 및 Glance 대시보드용 위젯
• 06bcrypt로 해시 처리한 비밀번호를 사용하는 단일 사용자 인증

활용 사례

• 브라우저에서 가정이나 사무실 UPS의 배터리 충전량, 예상 가동 시간, 부하 확인
• UPS 메트릭을 기존 Prometheus 또는 Grafana 모니터링 스택으로 전달
• 셀프 호스팅 Homepage 또는 Glance 시작 페이지에 UPS 상태 표시
• NAS나 서버 랙 근처의 Raspberry Pi 4 또는 다른 arm64 호스트에서 실행

빠른 시작

1. 1

   Docker로 PeaNUT 컨테이너를 실행합니다

   docker run -v ${PWD}/config:/config -p 8080:8080 --restart unless-stopped --env WEB_PORT=8080 brandawg93/peanut
2. 2

   브라우저에서 localhost:8080으로 이동해 대시보드를 엽니다

사용 전 알아둘 점

• !모니터링할 UPS 장치가 연결된 NUT 서버가 필요합니다.
• !버전 5.17.0부터 Raspberry Pi 3 및 이전 모델(arm/v7)은 더 이상 지원되지 않습니다.

포함된 컬렉션

토픽

자주 묻는 질문

PeaNUT은(는) 무엇인가요?

Network UPS Tools(NUT)로 관리하는 UPS 장치를 모니터링하는 경량 웹 대시보드입니다. PeaNUT은 NUT 서버에 연결된 UPS(무정전 전원 공급 장치)의 상태와 실시간 통계를 보여주는 웹 대시보드입니다. 여러 UPS 장치를 한눈에 확인하고, 명령을 실행하거나 쓰기 가능한 설정을 변경할 수 있으며, 터미널에서 NUT 서버에 접속할 수도 있습니다.

PeaNUT은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

PeaNUT은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

PeaNUT은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. PeaNUT의 마지막 커밋은 2026년 11월 1일입니다.

PeaNUT은(는) 어디에 사용할 수 있나요?

브라우저에서 가정이나 사무실 UPS의 배터리 충전량, 예상 가동 시간, 부하 확인 UPS 메트릭을 기존 Prometheus 또는 Grafana 모니터링 스택으로 전달 셀프 호스팅 Homepage 또는 Glance 시작 페이지에 UPS 상태 표시 NAS나 서버 랙 근처의 Raspberry Pi 4 또는 다른 arm64 호스트에서 실행

PeaNUT는 어떻게 설치하나요?

Docker로 PeaNUT 컨테이너를 실행합니다: docker run -v ${PWD}/config:/config -p 8080:8080 --restart unless-stopped --env WEB_PORT=8080 brandawg93/peanut 브라우저에서 localhost:8080으로 이동해 대시보드를 엽니다

PeaNUT은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Brandawg93/PeaNUT