ntfy — 경량 푸시 알림
ntfy — 경량 푸시 알림 — 공식 문서를 기반으로 한 이해하기 쉬운 가이드
ntfy — 가벼운 푸시 알림
스크립트가 끝나는 순간, 앱 하나 설치하지 않고도 휴대폰으로 알림을 받을 수 있다면 얼마나 좋을까요? 그 일상의 마법을 실현해 주는 게 바로 ntfy입니다. ntfy는 어떤 주제(topic)든 pub-sub 채널로 바꿔서, 간단한 HTTP 요청 한 번으로 알림을 보낼 수 있게 해 줍니다.
Hermes Agent 사용자라면, ntfy는 AI 에이전트를 주머니에 넣고 다니는 가장 쉬운 방법입니다. SDK도, 데몬도, Node.js도 필요 없어요. 그냥 토픽 이름 하나와 무료 ntfy 모바일 앱만 있으면 됩니다. 연결 방법을 알려드릴게요.
왜 ntfy가 Hermes와 찰떡일까
Hermes는 가벼운 자동화에 모든 것을 집중합니다. ntfy도 그 철학과 완벽하게 맞아떨어져요.
- 의존성 제로 — 어댑터는 Hermes에 이미 포함된
httpx만 사용합니다. - 어떤 HTTP 클라이언트든 동작 — curl, Python, 심지어 스마트워치까지.
- 셀프 호스팅 가능 — 프라이빗 토픽을 위해 자체 ntfy 서버를 운영하거나, 무료 공개 서버인
ntfy.sh를 사용할 수 있습니다.
휴대폰에서 토픽을 구독하고, Hermes에서 그 토픽으로 메시지를 보내면 알림으로 받아보는 구조입니다. 불필요한 기능 없이 푸시 메시징만 딱, 필요한 만큼 제공합니다.
빠른 시작: 설정 마법사
가장 빠른 방법은 안내에 따라 설정하는 것입니다.
hermes gateway setup메뉴에서 ntfy를 선택하고, 토픽 이름(예: hermes-myname-2026)을 입력하면 끝입니다. 마법사가 ~/.hermes/.env에 설정을 자동으로 작성해 줍니다.
환경 변수로 직접 설정하기
파일을 직접 편집하는 걸 선호하시나요? 그렇다면 ~/.hermes/.env에 다음 내용을 추가하세요.
NTFY_TOPIC=hermes-myname-2026
NTFY_ALLOWED_USERS=hermes-myname-2026
NTFY_HOME_CHANNEL=hermes-myname-2026이것이 최소 설정입니다. 각 변수가 무엇을 하는지 설명드릴게요.
| 변수 | 필수 여부 | 용도 |
|---|---|---|
NTFY_TOPIC |
예 | 구독할 토픽 (수신 메시지) |
NTFY_SERVER_URL |
아니요 | 기본값 https://ntfy.sh; 프라이버시를 위해 자체 호스팅 서버로 변경 가능 |
NTFY_TOKEN |
아니요 | 인증용 Bearer 토큰 (tk_xyz) 또는 user:pass |
NTFY_PUBLISH_TOPIC |
아니요 | 응답 전송용 별도 토픽 (기본값: NTFY_TOPIC) |
NTFY_MARKDOWN |
아니요 | true로 설정하면 X-Markdown: true 헤더로 응답 전송 |
NTFY_ALLOWED_USERS |
권장 | 사용자 ID로 취급할 토픽 이름 목록 (쉼표로 구분) |
NTFY_ALLOW_ALL_USERS |
아니요 | 모든 발행자 허용 — 프라이빗 토픽에서만 안전 |
NTFY_HOME_CHANNEL |
아니요 | cron / 알림용 기본 토픽 |
NTFY_HOME_CHANNEL_NAME |
아니요 | 홈 채널의 사람이 읽기 쉬운 이름 |
정체성 모델: 배포 전에 꼭 읽어보세요
ntfy의 한계가 하나 있습니다. 실제 사용자 계정이 없다는 점이에요. 메시지의 title 필드는 발행자가 마음대로 정할 수 있어서, 누구나 위조할 수 있습니다. 그래서 Hermes는 인증에 title을 사용하지 않습니다.
대신 토픽 이름 자체가 정체성이 됩니다. 해당 토픽의 모든 메시지는 동일한 논리적 사용자에게서 온 것으로 간주됩니다. NTFY_ALLOWED_USERS는 보통 토픽 이름 자체 하나만 넣는 단일 항목 허용 목록입니다.
보안 관련 중요 사항: 토픽 이름을 아는 사람이라면 누구나 에이전트와 대화할 수 있습니다. 이를 진정한 신뢰 경계로 만들려면:
- ntfy를 자체 호스팅하고 액세스 제어로 토픽을 잠그세요.
- 인증된 클라이언트만 게시하거나 구독할 수 있게 됩니다.
일상 사용을 위한 실용적인 팁
ntfy 앱에서 굵은 글씨, 목록, 코드 블록 같은 서식이 있는 응답을 보기 좋게 렌더링하려면 NTFY_MARKDOWN=true로 설정하세요. 긴 에이전트 응답을 휴대폰 화면에서 훨씬 읽기 편해집니다.
마무리
ntfy는 Hermes에 매우 간단한 푸시 채널을 제공합니다. 휴대폰에서 구독하고, 환경 변수 세 개만 설정하면 바로 사용할 수 있어요. 클라우드 계정도, 추가 서비스도, 배우는 데 시간을 쓸 필요도 없습니다.
마지막 팁: hermes-<이름>-<연도>처럼 고유한 토픽 이름으로 시작해 보세요. 공개 서버에서 사실상 충돌할 일이 없습니다. 그런 다음 워크플로우에 익숙해지면 ntfy를 자체 호스팅하고 액세스 제어를 추가해 진정한 프라이빗 채널을 구축하세요. 이제 에이전트가 한 번의 진동으로 여러분을 찾아갑니다.
📖 공식 문서
この記事は Hermes Agent の공식 문서に基づいています：공식 문서 › user-guide/messaging/ntfy