FCM 푸시 메시지 테스트 서버
안녕하세요! 오늘은 제가 사용하려고 개발한 FCM 푸시 메시지 테스트 서버를 소개하려고 합니다.
🎯 이런 분들께 추천합니다
- 모바일 앱 개발 중 푸시 알림 기능을 테스트하고 싶은 개발자
- FCM 메시지 포맷을 빠르게 실험해보고 싶은 분
- 대량의 푸시 메시지 발송 테스트가 필요한 분
- 간단한 웹 인터페이스로 푸시를 보내고 싶은 분
💡 왜 만들었나요?
앱 개발 중 푸시 알림 기능을 테스트할 때마다 매번 코드를 작성하거나 복잡한 툴을 사용해야 하는 번거로움이 있었습니다.
"그냥 토큰만 입력하면 바로 푸시를 보낼 수 있는 간단한 도구가 있으면 좋겠다"는 생각으로 이 프로젝트를 시작했습니다.
✨ 주요 기능
1. 심플한 웹 인터페이스
별도의 클라이언트 설치 없이 브라우저에서 바로 사용할 수 있습니다.
2. 다중 토큰 지원
여러 디바이스에 동시에 푸시를 보낼 수 있습니다. 각 토큰당 원하는 개수만큼 메시지를 발송할 수 있어 부하 테스트에도 유용합니다.
3. 메시지 커스터마이징
JSON 형식으로 푸시 메시지를 자유롭게 커스터마이징할 수 있습니다.
- Notification (제목, 내용)
- Custom Data (key-value 형태의 커스텀 데이터)
- Android/iOS 특정 설정
4. REST API 지원
웹 인터페이스뿐만 아니라 REST API로도 사용할 수 있어 CI/CD 파이프라인이나 자동화 테스트에 통합하기 쉽습니다.
🚀 사용하기
정말 간단합니다! 필요한 건 딱 두 가지:
-
Firebase 서비스 계정 JSON 파일
Firebase 서비스 계정 키(JSON 파일) 발급 방법
Firebase Console에 접속
프로젝트 선택
프로젝트 설정 > 서비스 계정 탭으로 이동
"새 비공개 키 생성" 클릭하여 JSON 파일 다운로드
JSON 파일을 안전하게 보관 -
FCM 디바이스 토큰
모바일 환경에서 Firebase SDK 를 통해 각 Device 별로 부여되는 FCM Token
# 설치
npm install
# 환경 변수 설정 (.env 파일)
FIREBASE_SERVICE_ACCOUNT_PATH=./your-firebase-service-account.json
# 실행
npm start
이제 http://localhost:3000에 접속하면 바로 사용할 수 있습니다!🌟 특징
쉬운 설정: 복잡한 설정 없이 Firebase 서비스 계정 파일만 있으면 됩니다
실시간 결과: 각 토큰별 발송 성공/실패 여부를 실시간으로 확인
대량 테스트: 토큰당 최대 100개까지 메시지를 동시에 발송 가능
사용자 친화적: 직관적인 UI와 JSON 유효성 검사 기능
🔧 기술 스택
Backend: Node.js, Express.js
Push Service: Firebase Admin SDK
Frontend: Vanilla JavaScript (의존성 없음!)
📦 GitHub에서 확인하기
더 자세한 내용은 GitHub 저장소에서 확인하실 수 있습니다: 👉 https://github.com/stevey-sy/push_test_server
💬 마치며
개발하면서 제가 필요했던 기능들을 담아 만든 도구입니다. 푸시 알림 테스트로 시간을 낭비하시는 분들께 조금이나마 도움이 되었으면 좋겠습니다. 😊
