비용 0원으로 서버 에러 및 자동화 알림을 스마트폰 푸시로 받는 법
홈서버나 크롤링 스크립트를 돌리다 보면, 에러가 났는지 작업이 끝났는지 확인하려고 자꾸 터미널이나 로그를 들여다보게 됩니다. 슬랙이나 텔레그램 봇을 쓰자니 앱을 따로 깔고 봇을 설정해야 해서 번거롭고, 문자 API나 유료 모니터링 도구는 비용이 듭니다.
이 글에서는 유료 결제나 복잡한 서버 구축 없이, HTTP 요청 한 줄로 스마트폰에 푸시 알림을 띄우는 무료 오픈소스 도구 ntfy의 설정 방법과 실전 활용 코드를 정리했습니다.
ntfy란
ntfy는 HTTP 요청만으로 푸시 알림을 보내는 오픈소스 알림 서비스입니다. 작동 방식이 단순합니다. 스마트폰 앱에서 토픽이라는 이름의 채널을 구독해두고, 서버에서 그 토픽 주소로 메시지를 보내면 구독한 폰에 푸시가 울립니다.
아이폰과 안드로이드를 모두 지원하고, 공용 서버는 회원가입 없이 무료로 쓸 수 있습니다. 서버를 직접 운영하고 싶다면 자체 호스팅도 가능합니다. 알림을 보내는 쪽은 curl이나 파이썬처럼 HTTP 요청을 보낼 수 있는 수단이면 무엇이든 됩니다.
3분 세팅 방법
설정은 앱 설치, 토픽 구독, 테스트 전송 세 단계면 끝납니다.

- 먼저 앱스토어나 플레이스토어에서 ntfy를 검색해 설치하고 실행합니다. (알림 권한 허용, 배터리최적화 비활성화)
- 앱에서 +버튼을 눌러 구독할 주제(Topic) 이름을 정합니다. 남들이 추측하기 어려운 고유한 이름이 좋습니다. 예를 들어
alert_9823_server_log처럼 숫자를 섞은 이름을 씁니다. - 다음으로 터미널에서 테스트 알림을 보내봅니다.
curl -d "서버 백업이 완료되었습니다!" https://ntfy.sh/alert_9823_server_log
명령어를 실행하면 스마트폰 화면에 푸시 알림이 바로 뜹니다. 이 한 줄이 전부입니다. 별도의 API 키 발급이나 계정 설정이 필요 없습니다.

실전 활용 코드
테스트가 됐다면, 이제 실제 작업에 알림을 붙여봅니다.
파이썬 스크립트 에러 감지
크롤링이나 데이터 수집 코드가 중간에 죽었을 때, 에러 메시지와 함께 알림을 받으면 원인을 바로 확인할 수 있습니다. try-except로 감싸고 실패했을 때만 알림을 보내는 방식입니다.
import requests
TOPIC = "https://ntfy.sh/alert_9823_server_log"
def notify(message, priority="default"):
requests.post(
TOPIC,
data=message.encode("utf-8"),
headers={"Priority": priority},
)
try:
collect_data()
notify("수집이 완료되었습니다.")
except Exception as e:
notify(f"수집 실패: {e}", priority="high")
raise
리눅스 셸 스크립트와 크론 연동
매일 새벽에 도는 백업처럼 주기적인 작업은, 실패했을 때만 알림이 오게 만드는 게 편합니다. 성공할 때마다 알림이 오면 금방 무감각해지기 때문입니다.
# 백업이 실패했을 때만 알림 전송
./backup.sh || curl -d "백업 실패! 로그를 확인하세요" -H "Priority: high" https://ntfy.sh/alert_9823_server_log
크론에 등록할 때는 같은 한 줄을 crontab에 넣으면 됩니다.
0 3 * * * /home/user/backup.sh || curl -d "백업 실패! 로그를 확인하세요" -H "Priority: high" https://ntfy.sh/alert_9823_server_log
추가 응용
앱 하나만 설치하면 원하는 메시지를 스마트폰 알림으로 받을 수 있다는 걸 응용하면 다양한 사례에 이용할 수 있습니다.
- 웹 크롤링 중 원하는 값이 나왔을 때 알림 생성 및 페이지 이동(Click기능 사용)
- 서버 재부팅이나 상태 이상 발견시 알림 생성
- 작업 종료시 알림 생성
- NFC 스티커 태그시 알림 생성
- QR 코드 인식시 알림 생성
- n8n 등 자동화 도구에서 상태 및 결과 알림
알림 꾸미기
헤더를 추가하면 알림의 제목과 중요도, 이모지, 클릭 동작을 바꿀 수 있습니다.
curl -d "배포가 완료되었습니다" \
-H "Title: 배포 알림" \
-H "Priority: high" \
-H "Tags: white_check_mark" \
-H "Click: https://example.com/logs" \
https://ntfy.sh/alert_9823_server_log
중요도는 5단계가 있습니다. 단계가 높을수록 소리와 진동이 강해집니다.
| 단계 | 이름 | 용도 |
|---|---|---|
| 5 | urgent | 서비스 다운 같은 긴급 알림 |
| 4 | high | 백업 실패, 디스크 경고 |
| 3 | default | 일반적인 알림 |
| 2 | low | 조용히 남기는 알림 |
| 1 | min | 소리와 진동 없이 기록만 남기는 알림 |
아이폰이라면 Bark도 있다
아이폰만 쓴다면 Bark라는 대안도 있습니다. 애플의 APNs를 직접 이용해 푸시를 보내기 때문에 배터리 소모가 적고 반응 속도가 빠릅니다. 앱을 설치하면 고유 키가 담긴 URL이 나오고, 그 URL에 GET 요청만 보내면 알림이 옵니다.
curl "https://api.day.app/기기키/백업 완료/서버 백업이 끝났습니다"
Bark는 아이폰 전용이라 안드로이드에서는 쓸 수 없습니다. 자체 호스팅 서버와 암호화 푸시도 지원합니다. 안드로이드와 아이폰을 함께 쓰거나, 나중에 기종을 바꿀 가능성이 있다면 ntfy가 무난합니다.
주의할 점
공용 서버를 쓸 때는 토픽 이름이 곧 비밀번호라는 점을 기억해야 합니다. 토픽 이름만 알면 누구나 그 토픽의 메시지를 보고 알림을 보낼 수 있습니다. alert나 server처럼 추측하기 쉬운 이름은 피하고, 긴 무작위 문자열을 섞어서 씁니다.
더 철저하게 관리하고 싶다면 ntfy 서버를 직접 호스팅해서 계정과 접근 토큰으로 접근을 제한하는 방법도 있습니다. 자세한 설정은 ntfy 공식 문서에서 확인할 수 있습니다.
정리
ntfy를 이용하면 유료 알림 서비스 없이도 서버 에러와 자동화 작업 결과를 스마트폰 푸시로 바로 받아볼 수 있습니다. 앱에서 토픽을 구독하고 HTTP 요청 한 줄을 보내는 것만으로 미니 모니터링 시스템이 완성됩니다. 스크립트에 알림 한 줄을 붙이는 습관만 들여도, 터미널 앞에서 로그를 기다리는 시간이 크게 줄어듭니다.
여러분은 어떤 자동화 작업에 알림을 붙이고 싶으신가요? 댓글로 남겨주세요!