gasbugs/hangul-play repository overview

⁠🎨 한글 놀이 (Hangul Play) - Official Docker Image

아이들의 상상력을 자극하는 한글 학습 플랫폼, "한글 놀이"의 공식 도커 이미지입니다.
이 이미지는 보안 최적화 및 런타임 설정 주입 기술이 적용되어, 어떠한 환경에서도 안전하고 유연하게 실행 가능합니다.

⁠🚀 Quick Start (빠른 시작)

가장 간단하게 서비스를 시작하는 명령입니다:

docker run -d \
  --name hangul-play \
  -p 8080:8080 \
  -e FIREBASE_API_KEY="YOUR_API_KEY" \
  -e FIREBASE_PROJECT_ID="YOUR_PROJECT_ID" \
  gasbugs/hangul-play:latest

이제 브라우저에서 http://localhost:8080으로 접속하세요!

⁠⚙️ Configuration (환경 설정)

본 이미지는 Dynamic Configuration Injection 형식을 사용합니다. 컨테이너 실행 시 다음 환경 변수를 주입하여 자신의 Firebase 프로젝트와 연동할 수 있습니다.

⁠필수 환경 변수 (Required)

⁠선택 환경 변수 (Optional)

⁠🛡️ Security Features (보안 기능)

1. Non-Root Execution: 프로세스가 nginx 비권한 유저로 실행되어 호스트 시스템을 안전하게 보호합니다.
2. Minimal Image: Alpine Linux 기반으로 제작되어 공격 표면을 최소화했습니다.
3. Runtime Asset Injection: 소스 코드 내에 비밀 키를 저장하지 않고, 실행 시점에만 메모리와 임시 실정에 주입됩니다.

⁠📖 Open Source Notice

본 프로젝트는 GNU GPLv3 라이선스를 준수합니다.
전체 소스 코드와 상세 개발 가이드는 GitHub 저장소⁠에서 확인하실 수 있습니다.

Developed with ❤️ for kids everywhere.
문의 사항이나 기여는 GitHub Issue를 통해 남겨주세요.