glenndehaan/unifi-voucher-site

어떤 프로젝트인가요?

핵심 기능

• 01만료 시점, 1회 또는 다회 사용, 속도 및 데이터 제한을 설정해 바우처를 생성합니다.
• 02바우처를 PDF로 출력하거나 80mm 용지용 ESC/POS 네트워크 프린터로 인쇄합니다.
• 03SMTP를 통해 바우처를 이메일로 보냅니다.
• 04게스트가 직접 바우처를 생성할 수 있는 키오스크 페이지를 제공합니다.
• 05내부 로그인, OpenID Connect SSO 또는 인증 없음을 지원합니다.
• 06Bearer token으로 보호되는 REST API를 제공합니다.

활용 사례

• 카페, 호텔 또는 코워킹 스페이스에서 게스트에게 WiFi 액세스 코드를 발급합니다.
• 프런트 데스크 직원이 영수증 프린터로 바우처를 출력할 수 있게 합니다.
• API를 통해 Home Assistant 또는 다른 시스템에서 바우처 생성을 자동화합니다.
• 키오스크를 통해 공공장소에서 셀프 서비스 인터넷 액세스를 제공합니다.

빠른 시작

1. 1

   voucher 인증을 활성화하여 UniFi Hotspot Portal을 설정하세요

2. 2

   README 예제를 바탕으로 docker-compose.yml을 만들고 UniFi 설정을 입력하세요

사용 전 알아둘 점

• !버전 8.x에는 UniFi OS가 필요하며 레거시 UniFi Network Server에서는 작동하지 않습니다.
• !Local Network API 키와 Site Manager API 키는 서로 바꿔 사용할 수 없습니다.
• !voucher 인증이 활성화된 UniFi Hotspot Portal이 필요합니다.

토픽

자주 묻는 질문

unifi-voucher-site은(는) 무엇인가요?

UniFi 네트워크의 게스트 WiFi 바우처를 생성하고 관리하고 출력하는 웹 앱 및 REST API입니다. UniFi Voucher Site는 UniFi 네트워크의 게스트 액세스 바우처를 생성하고 관리하는 자체 호스팅 웹 애플리케이션입니다. 관리자는 만료 시점, 1회 또는 다회 사용 횟수 제한, 업로드 및 다운로드 속도 제한, 데이터 전송량 할당량을 설정해 바우처를 만든 뒤 게스트에게 제공할 수 있습니다.

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

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

unifi-voucher-site은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. unifi-voucher-site의 마지막 커밋은 2026년 11월 4일입니다.

unifi-voucher-site은(는) 어디에 사용할 수 있나요?

카페, 호텔 또는 코워킹 스페이스에서 게스트에게 WiFi 액세스 코드를 발급합니다. 프런트 데스크 직원이 영수증 프린터로 바우처를 출력할 수 있게 합니다. API를 통해 Home Assistant 또는 다른 시스템에서 바우처 생성을 자동화합니다. 키오스크를 통해 공공장소에서 셀프 서비스 인터넷 액세스를 제공합니다.

unifi-voucher-site는 어떻게 설치하나요?

voucher 인증을 활성화하여 UniFi Hotspot Portal을 설정하세요 README 예제를 바탕으로 docker-compose.yml을 만들고 UniFi 설정을 입력하세요

unifi-voucher-site은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/glenndehaan/unifi-voucher-site