Repolode
Enviar
glenndehaan

glenndehaan/unifi-voucher-site

Aplicación web y API REST para crear, administrar e imprimir vouchers de WiFi para invitados en redes UniFi.

Ver en GitHub
Estrellas
312
Forks
37
Issues abiertos
1
Último commit
anteayer

¿Qué es?

UniFi Voucher Site es una aplicación web autohospedada que genera y administra vouchers de acceso para invitados en redes UniFi. Los administradores crean vouchers con vencimiento configurable, límites de uso único o múltiple, límites de velocidad de carga y descarga, y cuotas de transferencia de datos, y luego los entregan a los invitados.

Los vouchers se pueden entregar de varias formas: imprimir como archivos PDF o mediante impresoras de recibos de red ESC/POS con papel de 80 mm, enviar por correo electrónico a través de SMTP o permitir que los invitados los generen por su cuenta desde una página de quiosco para espacios públicos. El proyecto funciona con Node.js, Express y EJS, y se implementa mediante Docker o como una aplicación de Home Assistant. La autenticación puede usar la contraseña integrada, el inicio de sesión único con OpenID Connect o estar desactivada.

Se conecta a una consola UniFi OS mediante una clave de API de UniFi y, para la versión 8.x, requiere UniFi OS v4.2.8+ con UniFi Network v9.1.119+.

Funciones clave

  • 01Crear vouchers con vencimiento configurable, uso único o múltiple y límites de velocidad y datos.
  • 02Imprimir vouchers como archivos PDF o en impresoras de red ESC/POS con papel de 80 mm.
  • 03Enviar vouchers por correo electrónico mediante SMTP.
  • 04Ofrecer una página de quiosco para que los invitados generen sus propios vouchers.
  • 05Admitir inicio de sesión interno, SSO con OpenID Connect o autenticación desactivada.
  • 06Exponer una API REST protegida por un token bearer.

Casos de uso

  • Emitir códigos de acceso WiFi para invitados en cafeterías, hoteles o espacios de coworking.
  • Permitir que el personal de recepción imprima vouchers en impresoras de recibos.
  • Automatizar la creación de vouchers desde Home Assistant u otros sistemas mediante la API.
  • Ofrecer acceso a internet de autoservicio en áreas públicas mediante un quiosco.

Inicio rápido

  1. 1

    Configura UniFi Hotspot Portal con la autenticación por voucher habilitada

  2. 2

    Crea un docker-compose.yml a partir del ejemplo del README e introduce la configuración de UniFi

Antes de usarlo

  • La versión 8.x requiere UniFi OS y no funciona con UniFi Network Server heredado.
  • Las claves de Local Network API y Site Manager API no son intercambiables.
  • Se requiere UniFi Hotspot Portal con la autenticación por voucher habilitada.

Temas

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

Preguntas frecuentes

¿Qué es unifi-voucher-site?
Aplicación web y API REST para crear, administrar e imprimir vouchers de WiFi para invitados en redes UniFi. UniFi Voucher Site es una aplicación web autohospedada que genera y administra vouchers de acceso para invitados en redes UniFi. Los administradores crean vouchers con vencimiento configurable, límites de uso único o múltiple, límites de velocidad de carga y descarga, y cuotas de transferencia de datos, y luego los entregan a los invitados.
¿unifi-voucher-site es gratuito? ¿Qué licencia tiene?
unifi-voucher-site es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿unifi-voucher-site sigue mantenido?
Mantenimiento activo. El último commit de unifi-voucher-site fue el 4 nov 2026.
¿Para qué puedo usar unifi-voucher-site?
Emitir códigos de acceso WiFi para invitados en cafeterías, hoteles o espacios de coworking. Permitir que el personal de recepción imprima vouchers en impresoras de recibos. Automatizar la creación de vouchers desde Home Assistant u otros sistemas mediante la API. Ofrecer acceso a internet de autoservicio en áreas públicas mediante un quiosco.
¿Cómo se instala unifi-voucher-site?
Configura UniFi Hotspot Portal con la autenticación por voucher habilitada Crea un docker-compose.yml a partir del ejemplo del README e introduce la configuración de UniFi
¿Dónde consigo unifi-voucher-site?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/glenndehaan/unifi-voucher-site

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados