홈랩 & 셀프 호스팅

집에서 무슨 일이 생기면 언제든 알려 드려요.

Home Assistant, Uptime Kuma, 또는 어떤 셀프 호스팅 기기든 포트를 전혀 노출하지 않고 휴대폰으로 알림을 보낼 수 있어요. 무료 플랜으로 개인 홈랩을 운영할 수 있어요.

아웃바운드 HTTPS포트 포워딩 불필요Kuma · Proxmox · HA 업데이트
기능

홈랩을 위한 모니터링

셀프 호스팅도 꾸준히 살펴봐야 해요. 홈랩을 휴대폰과 연결하고 클라우드 모니터링 요금은 줄여 보세요.

사용 중인 스택과 바로 연동

Uptime Kuma, Home Assistant, Proxmox, Pi-hole, *arr 앱에서 웹훅을 전달하거나 curl을 연결하기만 하면 돼요.

노출되는 포트 없음

아웃바운드 HTTPS만 사용해요. 공인 IP가 필요 없고 NAT나 VPN 뒤에서도 문제없이 동작해요.

기기별 채널

기기마다 애플리케이션을 하나씩 두면 NAS, Proxmox, Pi-hole 알림이 각자의 채널에 도착해요.

어디서든 스크립트로 호출

bash, systemd 유닛, Docker 헬스체크, 크론 작업 어디에서든 호출할 수 있어요.

취미용으로 무료

무료 플랜으로 개인 홈랩을 운영할 수 있고, 좌석당 요금도 없어요.

1초 미만 전달

1초 이내에 전달되므로 집에서 생긴 문제를 어디에 있든 바로 알 수 있어요.

시작하기

홈랩 알림 설정까지 세 단계

1

URL 또는 CLI 준비

애플리케이션 웹훅 URL을 복사하거나, 기기에 Pocket Alert CLI를 설치하세요.

2

기기 연결하기

스크립트에 curl을 연결하거나, Kuma나 Home Assistant의 웹훅을 전달하거나, systemd OnFailure를 사용하세요.

3

어디에서든 모니터링

이벤트를 발생시키면 NAT 뒤에 있고 포트를 열지 않았어도 휴대폰이 진동해요.

홈랩 연결하기

1. bash 또는 크론 스크립트에서 (CLI)

pocketalert auth YOUR_API_KEY
pocketalert send -t "NAS · disk degraded" -m "pool tank · drive 2 FAULTED"

CLI 없이 어떤 스크립트에서든 메시지 API로 바로 curl 요청을 보낼 수도 있어요:

curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Proxmox backup failed","message":"vzdump job on pve1 exited 1","level":"high"}'

2. Home Assistant에서

rest_command:
  pocketalert:
    url: "https://api.pocketalert.app/v1/messages"
    method: POST
    headers:
      Token: "YOUR_API_KEY"
    content_type: "application/json"
    payload: '{"title":"{{ title }}","message":"{{ message }}"}'

3. Uptime Kuma에서 (웹훅)

웹훅 페이지에서 웹훅을 만들고 수신 URL을 복사하세요. 예: https://p4a.me/wh/1234abcd. Uptime Kuma에서 해당 URL을 대상으로 webhook 알림을 추가한 다음, %monitor.name% is %heartbeat.status%와 같은 GJSON 템플릿으로 Kuma의 페이로드를 매핑하세요.

모든 통신은 아웃바운드 HTTPS로 이루어지므로 포트 포워딩은 전혀 필요 없어요. 문서를 참고하세요.

FAQ

궁금한 점을 답해드려요

HTTP 요청을 보낼 수 있는 셀프 호스팅 기기라면 무엇이든 알림을 보낼 수 있어요. 스크립트에 curl을 연결하거나, Uptime Kuma나 Home Assistant의 웹훅을 전달하거나, systemd 유닛에서 CLI를 호출하면 돼요. 서버가 어디에 있든 알림은 휴대폰으로 전달돼요.

네. Pocket Alert는 Uptime Kuma, Home Assistant, Proxmox 훅, Pi-hole, *arr 앱, 그리고 순수 bash 스크립트와 연동돼요. JSON을 POST할 수 있는 도구라면 사용할 수 있어요.

공인 IP도, 포트 포워딩도 필요 없어요. 서버가 Pocket Alert로 아웃바운드 HTTPS 요청을 보내는 방식이라 NAT, 가정용 공유기, VPN 뒤에서도 동작해요.

기기나 서비스마다 애플리케이션을 하나씩 만들어 보세요. NAS, Proxmox, Pi-hole 알림이 각각 별도 채널로 도착해서 쉽게 구분할 수 있어요.

네. 무료 플랜으로 개인 홈랩을 충분히 운영할 수 있어요. 좌석당 요금도 없고, NAS에 문제가 생겼다는 알림을 받으려고 기업용 모니터링 계약을 맺을 필요도 없어요.

네. critical 레벨로 보내면 Android에서는 방해 금지 모드를 우회하고 전체 화면으로도 표시될 수 있는 전용 알림 채널로 전달돼요. 방해 금지 모드 접근 권한은 한 번만 허용하면 돼요. iPhone에서는 high와 critical 알림이 집중 모드를 뚫고 도착하는 시간 민감 알림으로 전달돼요. 무음 스위치를 무시하는 전체 critical 사운드는 Apple의 권한 승인에 따라 순차적으로 제공될 예정이에요. 무료 플랜에서는 critical이 high로 전달돼요. 즉시 도착하지만 방해 금지 모드 우회 기능은 없어요.

어디에서든 홈랩을 확인하세요.

curl 명령어 한 줄이면 셀프 호스팅 기기를 휴대폰과 연결할 수 있어요. 클라우드 모니터링 요금도 들지 않아요.