NdoleStudio/httpsms
안드로이드 폰을 SMS 게이트웨이로 쓰는 HTTP API 서비스
원제 NdoleStudio/httpsms
스타 5,716당일 +103Go
Key Point
가상 폰 번호를 구할 수 없는 국가에서 보유한 실제 안드로이드 폰을 API로 제어해 SMS를 자동화하는 오픈소스 인프라로, 클라우드 기반 SMS 서비스가 제공되지 않는 시장의 대안이 될 수 있다.
핵심 요약
- httpSMS는 안드로이드 폰을 SMS 게이트웨이로 사용해 HTTP API를 통해 프로그래밍 방식으로 문자를 주고받는 서비스다.
- 웹 UI는 Nuxt와 Vuetify로 제작하고 Firebase에 SPA로 호스팅되며, API는 Fiber 기반 Go 애플리케이션으로 CockroachDB를 데이터베이스로 Google Cloud Run에서 실행된다.
- 안드로이드 앱은 Kotlin으로 개발한 네이티브 애플리케이션으로, SMS 송수신을 시작하기 전에 반드시 설치해야 한다.
- AES-256 군사급 암호화로 메시지를 엔드-투-엔드 암호화할 수 있으며, 암호화 키는 폰에만 저장되어 서버는 내용을 볼 수 없다.
- 수신한 SMS를 웹훅으로 서버에 포워드하거나, 분당 3건 같은 속도 제한을 설정해 남용을 방지할 수 있다.
- 메시지가 만료되면 알림을 받을 수 있으며, Go와 JavaScript/TypeScript용 공식 API 클라이언트가 준비되어 있다.
- 자체 호스팅을 위해 Firebase, SMTP, Cloudflare Turnstile을 설정한 후 Docker Compose로 API, 웹 UI, 데이터베이스, 캐시를 함께 실행할 수 있다.
- 프로젝트는 Android Studio에서 google-services.json을 교체하는 방식으로 안드로이드 앱을 빌드하며, Docker 스택과 에뮬레이터에서 전체 SMS 송수신 주기를 검증하는 엔드-투-엔드 통합 테스트를 포함한다.
- GNU AGPL 3.0 라이선스로 배포된다.
저장소 보기 ↗github.com