Repolode
Enviar
glenndehaan

glenndehaan/unifi-voucher-site

Aplicativo web e API REST para criar, gerenciar e imprimir vouchers de WiFi para convidados em redes UniFi.

Ver no GitHub
Estrelas
312
Forks
37
Issues abertas
1
Último commit
há 3 dias

O que é?

O UniFi Voucher Site é um aplicativo web auto-hospedado que gera e gerencia vouchers de acesso para convidados em redes UniFi. Os administradores criam vouchers com validade configurável, limites de uso único ou múltiplo, limites de velocidade de upload e download e cotas de transferência de dados, e depois os entregam aos convidados.

Os vouchers podem ser distribuídos de várias formas: impressos em PDF ou em impressoras de recibos de rede ESC/POS com papel de 80 mm, enviados por e-mail via SMTP ou gerados pelos próprios convidados em uma página de quiosque para espaços públicos. O projeto roda em Node.js com Express e EJS e pode ser implantado via Docker ou como um app do Home Assistant. A autenticação pode usar a senha integrada, o login único com OpenID Connect ou ser desativada.

Ele se conecta a um console UniFi OS usando uma chave de API da UniFi e, na versão 8.x, requer UniFi OS v4.2.8+ e UniFi Network v9.1.119+.

Recursos principais

  • 01Criar vouchers com validade configurável, uso único ou múltiplo e limites de velocidade e de dados.
  • 02Imprimir vouchers em PDF ou em impressoras de rede ESC/POS com papel de 80 mm.
  • 03Enviar vouchers por e-mail via SMTP.
  • 04Oferecer uma página de quiosque em que os convidados geram seus próprios vouchers.
  • 05Permitir login interno, SSO com OpenID Connect ou desativar a autenticação.
  • 06Disponibilizar uma API REST protegida por um bearer token.

Casos de uso

  • Fornecer códigos de acesso ao WiFi para convidados em cafés, hotéis ou espaços de coworking.
  • Permitir que a equipe da recepção imprima vouchers em impressoras de recibos.
  • Automatizar a criação de vouchers pelo Home Assistant ou por outros sistemas via API.
  • Oferecer acesso à internet por autoatendimento em áreas públicas com um quiosque.

Início rápido

  1. 1

    Configure o UniFi Hotspot Portal com a autenticação por voucher ativada

  2. 2

    Crie um docker-compose.yml com base no exemplo do README e preencha as configurações do UniFi

Antes de usar

  • A versão 8.x requer UniFi OS e não funciona com o UniFi Network Server legado.
  • As chaves da Local Network API e da Site Manager API não são intercambiáveis.
  • É necessário ter o UniFi Hotspot Portal com a autenticação por voucher ativada.

Tópicos

#unifi#wifi#guest-access#voucher#express#nodejs#docker#home-assistant#unifi-voucher-site

Perguntas frequentes

O que é unifi-voucher-site?
Aplicativo web e API REST para criar, gerenciar e imprimir vouchers de WiFi para convidados em redes UniFi. O UniFi Voucher Site é um aplicativo web auto-hospedado que gera e gerencia vouchers de acesso para convidados em redes UniFi. Os administradores criam vouchers com validade configurável, limites de uso único ou múltiplo, limites de velocidade de upload e download e cotas de transferência de dados, e depois os entregam aos convidados.
unifi-voucher-site é gratuito? Qual é a licença?
unifi-voucher-site é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
unifi-voucher-site ainda é mantido?
Manutenção ativa. O último commit de unifi-voucher-site foi em 4 de nov. de 2026.
Para que posso usar unifi-voucher-site?
Fornecer códigos de acesso ao WiFi para convidados em cafés, hotéis ou espaços de coworking. Permitir que a equipe da recepção imprima vouchers em impressoras de recibos. Automatizar a criação de vouchers pelo Home Assistant ou por outros sistemas via API. Oferecer acesso à internet por autoatendimento em áreas públicas com um quiosque.
Como instalar unifi-voucher-site?
Configure o UniFi Hotspot Portal com a autenticação por voucher ativada Crie um docker-compose.yml com base no exemplo do README e preencha as configurações do UniFi
Onde consigo unifi-voucher-site?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/glenndehaan/unifi-voucher-site

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados