Docker로 오픈소스 푸시알람 프로젝트 ntfy.sh 설치 및 사용하기.(Feat. Uptimekuma)

안녕하세요 달소입니다.

이번에는 앞소 소개해드린 오픈소스 푸시알람 프로젝트인 ntfy.sh를 도커로 직접 설치해보고 간단한 사용예제를 통해 사용방법을 알아보도록 하겠습니다.

ntfy.sh에 대해서는 아래 글을 참고해주시기 바랍니다.

https://svrforum.com/svr/398810

여기서는 설정값 저장이 용이한 docker-compose를 사용해서 설치해보겠습니다.

사용할 이미지는 https://hub.docker.com/r/binwiederhier/ntfy 이며 꽤 유명한 프로젝트 답게 arm 이미도 있으니 라즈베리파이나 oracle 무료서버에서도 충분히 사용가능합니다.

컨테이너 생성하기

먼저 docker-compose.yml을 사용할 디렉터리를 만들어주고 설정값을 작성해주겠습니다.

mkdir -p /data/ntfy
cd /dadta/ntfy
vi docker-compose.yml

yml파일 작성이 완료되었으면 컨테이너 생성전에 ntfy에서 사용할 설정파일을 만들어줘야합니다.

*상세내용은 https://github.com/binwiederhier/ntfy/blob/main/server/server.yml 을 참고해주시면됩니다.

여기서는 간단한 설정값만 넣겠습니다.

vi ./ntfy/server.yml

base-url: "http://ntfy.example.com"
cache-file: "/var/cache/ntfy/cache.db"
attachment-cache-dir: "/var/cache/ntfy/attachments"

docker-compose up -d 명령어로 컨테이너를 실행합니다.

이제 8081 포트로접근하시면 아래처럼 ntfy가 반겨줍니다.

좌측에도 보이듯이 제대로 사용하기위해서는 https를 사용해야하는데요.

홈서버를 운영하시는 분이라면.. NPM이나 DSM의 리버스프록시를 통해 적용해주시면됩니다.

https로 접속하면 이렇게 알림이 사라집니다.

ntfy 설정하기

이제 셋팅된 ntfy를 제대로 사용하기 위해 셋팅하는 단계입니다.

ntfy의 경우 슬랙등과 비슷하게 채널개념이 있는데요.

주제 구독을 통해서 알림을 받고 보낼수있습니다.

주제가 구독되면 사용방법도 화면에 잘 설명됩니다.

아래처럼 curl로 사용방법도 있지만 간단하게 테스트하는건 아래에 게시알림입니다.

게시알람을 누르면 아래와같은 양식이 나오는데

topic name 정도만 주제에맞게 설정해서 메시지를 보내주시면됩니다.

정상적으로 메시지가 잘갔다면 바로 화면에 이렇게 보이게됩니다.

우측에 체크버튼을 누르면 알림이 사라집니다.

실 사용시에는 앱을 주로 사용할테니 앱도 테스트해보겠습니다

앱설치 및 서버 연결하기

각 환경에 따라서 스토어에서 ntfy.sh앱을 받아주시면됩니다.

사용방법은 크게 어려운게 없어서.. 공홈걸 추천드립니다.

https://ntfy.sh/docs/subscribe/phone/

uptimekuma의 알람을 ntfy.sh로 받기.

ntfy.sh를 사용하는 근본적인 목적입니다 ㅎㅎ

업타임쿠마에 접속해서 설정 -> 알람설정으로 가줍니다.

그리고 아래처럼 주제와 url등을 잘 설정해주세요.

테스트 버튼을 누르면 메시지가 잘 들어오는걸 확인하실 수 있습니다.

끝..!