Ralex91/Razzia

어떤 프로젝트인가요?

핵심 기능

• 01관리 인터페이스와 참가자용 방 코드를 통해 실시간 퀴즈 게임을 진행합니다.
• 02퀴즈와 결과를 업데이트 후에도 유지되는 로컬 파일로 저장합니다.
• 03Docker 또는 Docker Compose로 배포하거나 Node.js와 pnpm을 사용해 소스에서 실행합니다.
• 04환경 변수로 설정한 비밀번호로 관리 인터페이스를 보호합니다.
• 05Traefik, Nginx, Caddy 같은 일반적인 리버스 프록시 뒤에서 실행합니다.
• 06문서화된 WebSocket 프로토콜과 HTTP API를 사용해 커스텀 클라이언트를 만듭니다.

활용 사례

• 팀 회의, 수업 또는 소규모 파티에서 퀴즈나 상식 문제 라운드를 진행합니다.
• 개인 서버에서 설문이나 학습 게임을 직접 호스팅합니다.
• WebSocket으로 퀴즈 서버에 연결하는 물리 버저 시스템을 만듭니다.

빠른 시작

1. 1

   Razzia 서비스 정의가 포함된 compose.yml 파일을 만듭니다

2. 2

   MANAGER_PASSWORD를 설정한 .env 파일을 만듭니다

3. 3

   Docker Compose로 서비스를 시작합니다

   docker compose up -d

사용 전 알아둘 점

• !Docker 없이 실행하려면 Node.js 24 이상과 pnpm 10.16 이상이 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

Razzia은(는) 무엇인가요?

소규모 행사를 위한 셀프 호스팅 오픈소스 퀴즈 플랫폼으로, Docker로 배포할 수 있습니다. Razzia는 소규모 행사를 대상으로 하는 셀프 호스팅 퀴즈 플랫폼입니다. 진행자용 관리 인터페이스에서 게임을 만들고 참가자에게 방 코드를 공유한 다음, 참가자가 모두 입장하면 세션을 시작할 수 있습니다. 참가자는 브라우저에서 게임 URL에 접속해 라운드 중 문제에 답합니다.

Razzia은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

Razzia은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

Razzia은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. Razzia의 마지막 커밋은 2026년 11월 3일입니다.

Razzia은(는) 어디에 사용할 수 있나요?

팀 회의, 수업 또는 소규모 파티에서 퀴즈나 상식 문제 라운드를 진행합니다. 개인 서버에서 설문이나 학습 게임을 직접 호스팅합니다. WebSocket으로 퀴즈 서버에 연결하는 물리 버저 시스템을 만듭니다.

Razzia는 어떻게 설치하나요?

Razzia 서비스 정의가 포함된 compose.yml 파일을 만듭니다 MANAGER_PASSWORD를 설정한 .env 파일을 만듭니다 Docker Compose로 서비스를 시작합니다: docker compose up -d

Razzia은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Ralex91/Razzia