biubiubiu
KO
GitHub 배포

오픈 소스 · Cloudflare에서 동작

어디서 보내든, 휴대폰으로 곧장.

biubiubiu는 Cloudflare Workers와 D1에서 동작하는 가벼운 셀프 호스팅 Web Push 서버입니다. 스크립트, cron 작업, CI, AI 에이전트에서 HTTP 요청 한 번이면 휴대폰이 울립니다. 관리할 서버도, 설치할 네이티브 앱도 없습니다.

Cloudflare에 배포 GitHub에서 보기

약 1분이면 배포 완료. 무료 플랜에서도 사용할 수 있습니다.

한 줄로 전송

HTTP 요청을 보낼 수 있다면, 당신에게 닿을 수 있습니다.

간단한 알림은 URL에 디바이스 키만 넣으면 됩니다. JSON API로는 토큰, 디바이스 그룹, Markdown, 예약 전송, 종단 간 암호화, 버튼·직접 입력·패스키 확인을 지원하는 질문까지 사용할 수 있습니다. 웹훅 템플릿으로 GitHub, Grafana, Alertmanager를 그대로 받고, 긴급 알림은 열어 볼 때까지 반복됩니다.

디바이스 키로 간단히 GET
curl https://push.example.com/<deviceKey>/Backup%20done
API 토큰으로 모든 디바이스에 JSON 전송
curl -X POST https://push.example.com/api/send \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"title":"Deploy","body":"v2.3.1 is live"}'
질문을 보내고 답을 기다리기
curl -X POST https://push.example.com/api/send \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"title":"Deploy?","choices":["Ship it","Hold"]}'
긴급: 열어 볼 때까지 다시 전송
curl -X POST https://push.example.com/api/send \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"title":"Prod down","level":"critical","retry":120}'

기능

작은 서버, 필요한 건 모두.

모든 플랫폼

iOS 16.4+ 홈 화면 웹 앱, Android, 최신 데스크톱 브라우저. 앱 스토어가 필요 없습니다.

디바이스별 키

디바이스마다 폐기 가능한 키를 발급하고, 스크립트용 범위 지정 API 토큰과 전체를 관리하는 마스터 키를 제공합니다.

유연한 대상 지정

전체 전송, 디바이스 그룹 전송, 특정 디바이스 지정 전송을 지원합니다.

메시지 센터

모든 푸시를 보관하며 Markdown 렌더링, 카테고리 필터, 읽지 않음 배지, TTL 만료를 지원합니다.

알림 덮어쓰기

같은 id를 쓰면 새 알림을 쌓지 않고 기존 알림을 갱신합니다. 빌드 진행 상황 표시에 딱 맞습니다.

예약 전송

scheduledAt으로 메시지를 대기열에 넣으면 매분 실행되는 cron이 제시간에 전달합니다.

종단 간 암호화

Bark 호환 AES-CBC 페이로드를 기기에서 복호화합니다. 서버는 암호문만 봅니다.

안정적인 전달

자동 재시도, 만료된 구독 정리, 구독 자가 복구, 디바이스별 전달 로그.

웹훅 템플릿

?template=github만 붙이면 GitHub, Grafana, Alertmanager 웹훅을 서버로 바로 받을 수 있습니다. Slack, Discord, ntfy로 보내는 도구도 그대로 동작합니다.

확인할 때까지 재알림

retry를 붙인 critical 메시지는 누군가 열어 볼 때까지 몇 분마다 다시 전송됩니다.

AI 에이전트를 위해

터미널을 떠나도 괜찮습니다. 에이전트가 불러 줍니다.

코딩 에이전트는 당신이 자리를 비운 사이에 작업을 끝내거나, 실패하거나, 막히곤 합니다. biubiubiu는 에이전트가 당신에게 연락하고, 당신이 답할 수 있는 길을 열어 줍니다.

MCP 서버

/mcp의 Streamable HTTP로 모든 MCP 클라이언트에 send_notification 도구를 제공합니다. Claude Code에는 명령어 한 줄로 추가됩니다.

ask_human

에이전트가 응답 버튼이나 답장 칸이 달린 질문을 보냅니다. 답하는 즉시 도구 호출이 답을 돌려줍니다. 위험한 선택지는 Face ID나 Touch ID를 요구할 수 있습니다.

스킬과 훅

Agent Skill은 에이전트에게 언제 알릴지 알려 주고, Claude Code 훅은 작업이 멈추거나 권한을 요청할 때마다 알림을 보냅니다.

Claude Code
claude mcp add --transport http biubiubiu \
  https://push.example.com/mcp \
  --header "Authorization: Bearer $BIUBIUBIU_TOKEN"
Agent Skill
npx skills add chada/biubiubiu --skill biubiubiu-notify
에이전트 설정하기

계정 모드

가족이나 팀과 서버 하나를 함께 쓰세요.

계정 모드를 켜면 각자 자신의 계정으로 로그인하고 다음을 사용할 수 있습니다.

  • 초대로 참여자를 직접 관리
  • 각자의 디바이스와 받은 편지함
  • 스크립트용 개인 전송 토큰
  • 푸시 또는 이메일로 비밀번호 재설정

선택 기능이며 기본값은 꺼짐입니다. Workers 유료 플랜이 필요하며, 끄면 마스터 키 하나로 무료 플랜에서 동작합니다.

계정 모드 알아보기

앱

홈 화면에 두는 받은 편지함.

'응답 필요', 날짜별 섹션, 그룹 필터가 있는 받은 편지함
에이전트의 질문에 탭 한 번으로 답하기
id로 갱신되는 Markdown 메시지

시작하기

세 단계로 나만의 푸시 서버를.

  1. 배포

    버튼을 누르면 저장소를 GitHub 또는 GitLab으로 복사하고, D1 데이터베이스 생성, 마이그레이션, Worker 배포까지 진행합니다.

  2. 마스터 키 설정

    관리자 비밀번호 MASTER_KEY를 입력합니다(예: openssl rand -base64 32). VAPID 키는 자동으로 생성됩니다.

  3. 휴대폰에서 열기

    앱을 홈 화면에 추가하고 알림을 허용한 뒤 디바이스 키를 복사하세요. 첫 biu를 보내 보세요.

Deploy to Cloudflare

명령줄이 편하다면 수동 배포를 참고하세요.

자주 묻는 질문

자주 묻는 질문.

더 궁금한 점이 있다면 GitHub에서 물어보세요.

biubiubiu는 무엇인가요?

biubiubiu는 Cloudflare Workers와 D1에서 직접 호스팅하는 무료 오픈 소스 Web Push 알림 서버입니다. 스크립트, cron 작업, CI 파이프라인, AI 에이전트가 HTTP 요청 한 번을 보내면 표준 Web Push 프로토콜로 휴대폰, 태블릿, 데스크톱에 알림을 보냅니다.

비용이 드나요?

biubiubiu 자체는 무료입니다. 본인의 Cloudflare 계정에서 실행되며, 기본 마스터 키 모드는 Workers 무료 플랜으로 충분합니다. 선택 사항인 계정 모드만 비밀번호 해싱에 무료 플랜보다 많은 CPU 시간이 필요해서 Workers Paid가 필요합니다.

앱을 설치하지 않고 iPhone에서 쓸 수 있나요?

네. iOS와 iPadOS 16.4 이상에서 Safari로 서버를 열고 홈 화면에 추가한 뒤 알림을 허용하면 됩니다. Android와 데스크톱에서는 Chrome, Edge, Firefox, Safari가 브라우저에서 바로 푸시를 받습니다.

Android에서도 Bark 대신 쓸 수 있나요?

네. biubiubiu는 Bark의 URL과 JSON API 스타일을 따르므로 서버 주소와 기기 키만 바꾸면 기존 Bark 스크립트와 iOS 단축어가 그대로 동작하고, 같은 메시지가 Android와 데스크톱에도 도착합니다. 사용자 지정 사운드나 중요 알림의 경보음처럼 Web Push로는 불가능한 Bark 옵션도 일부 있지만, 긴급 메시지는 열어 볼 때까지 재알림할 수 있습니다.

Claude Code 같은 AI 에이전트는 어떻게 알림을 보내나요?

/mcp의 MCP 서버를 아무 MCP 클라이언트에 추가하면(Claude Code는 명령 하나) 에이전트가 send_notification 도구와, 답변 버튼이나 답장 칸이 달린 질문을 보내고 답하는 즉시 결과를 돌려주는 ask_human 도구를(위험한 답변은 패스키로 Face ID나 Touch ID 확인을 요구 가능) 쓸 수 있습니다. Agent Skill(npx skills add chada/biubiubiu로 설치)과 Claude Code 훅도 함께 제공됩니다.

ntfy, Gotify, Pushover와 무엇이 다른가요?

Pushover는 유료 호스팅 서비스이고, 직접 호스팅하는 ntfy나 Gotify는 계속 켜 두어야 하는 서버가 필요합니다. biubiubiu는 본인의 Cloudflare 계정에서 서버리스로 실행되므로 패치하거나 상시 운영할 것이 없습니다. 네이티브 앱 없이 표준 Web Push로 전달하며 AI 에이전트용 MCP 서버도 내장하고 있습니다. ntfy를 지원하는 도구는 디바이스 키를 토픽으로 써서 그대로 게시할 수 있고, 긴급 메시지는 Pushover의 긴급 우선순위처럼 확인할 때까지 재알림됩니다.

내 알림은 누가 읽을 수 있나요?

본인만 읽을 수 있습니다. 메시지는 본인 Cloudflare 계정의 D1 데이터베이스에 저장됩니다. 종단 간 암호화를 켜면 내용이 전송 전에 암호화되고 기기에서 복호화되므로 서버는 암호문만 봅니다.

문서

문서 읽기.

API 레퍼런스

인증, 모든 엔드포인트와 매개변수, MCP, 암호화.

배포

로컬 개발, 시크릿, D1, 사용자 지정 도메인, 계정 모드.

AI 에이전트

MCP 설정, 알림 스킬, Claude Code 훅.

플랫폼별 참고

iOS 설정과 Web Push의 한계.

자세한 문서는 영어로 제공됩니다. 한국어 README 읽기

시작하기

요청 한 번이면, 휴대폰으로.

나만의 푸시 서버를 약 1분 만에 배포하세요. 무료이고 오픈 소스이며, 온전히 당신의 것입니다.

Cloudflare에 배포 GitHub에서 보기