Repolode
glenndehaan

glenndehaan/unifi-voucher-site

Веб-приложение и REST API для создания, управления и печати гостевых WiFi-ваучеров в сетях UniFi.

Звёзды
312
Форки
37
Открытые issues
1
Последний коммит
3 дня назад

Что это?

UniFi Voucher Site — это веб-приложение для самостоятельного размещения, которое создает и управляет ваучерами гостевого доступа для сетей UniFi. Администраторы создают ваучеры с настраиваемым сроком действия, ограничением на одно или несколько использований, лимитами скорости загрузки и скачивания и квотами на передачу данных, а затем выдают их гостям.

Ваучеры можно выдавать несколькими способами: печатать в PDF или на сетевых принтерах чеков ESC/POS на бумаге шириной 80 мм, отправлять по SMTP или позволить гостям создавать их самостоятельно через страницу киоска в общественных местах. Проект работает на Node.js с Express и EJS и разворачивается через Docker или как приложение Home Assistant. Для аутентификации можно использовать встроенный пароль, единый вход OpenID Connect или отключить ее.

Приложение подключается к консоли UniFi OS с помощью ключа UniFi API. Для версии 8.x требуется UniFi OS v4.2.8+ и UniFi Network v9.1.119+.

Ключевые возможности

  • 01Создание ваучеров с настраиваемым сроком действия, ограничением на одно или несколько использований, а также лимитами скорости и объема данных.
  • 02Печать ваучеров в PDF или на сетевых принтерах ESC/POS на бумаге шириной 80 мм.
  • 03Отправка ваучеров по электронной почте через SMTP.
  • 04Страница киоска, где гости могут создавать ваучеры самостоятельно.
  • 05Поддержка внутренней авторизации, SSO через OpenID Connect или работы без аутентификации.
  • 06REST API с защитой токеном bearer.

Сценарии использования

  • Выдача кодов доступа к WiFi гостям кафе, отелей и коворкингов.
  • Печать ваучеров сотрудниками стойки регистрации на принтерах чеков.
  • Автоматизация создания ваучеров через API из Home Assistant или других систем.
  • Организация самообслуживания с доступом в интернет в общественных местах через киоск.

Быстрый старт

  1. 1

    Настройте UniFi Hotspot Portal, включив аутентификацию по voucher

  2. 2

    Создайте docker-compose.yml на основе примера из README и укажите настройки UniFi

Что важно знать

  • Для версии 8.x требуется UniFi OS; она не работает с устаревшим UniFi Network Server.
  • Ключи Local Network API и Site Manager API нельзя использовать взаимозаменяемо.
  • Требуется UniFi Hotspot Portal с включенной аутентификацией по voucher.

Темы

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

Частые вопросы

Что такое unifi-voucher-site?
Веб-приложение и REST API для создания, управления и печати гостевых WiFi-ваучеров в сетях UniFi. UniFi Voucher Site — это веб-приложение для самостоятельного размещения, которое создает и управляет ваучерами гостевого доступа для сетей UniFi. Администраторы создают ваучеры с настраиваемым сроком действия, ограничением на одно или несколько использований, лимитами скорости загрузки и скачивания и квотами на передачу данных, а затем выдают их гостям.
unifi-voucher-site можно использовать бесплатно? Какая у него лицензия?
unifi-voucher-site распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
unifi-voucher-site всё ещё поддерживается?
Активно поддерживается. Последний коммит в unifi-voucher-site — 4 нояб. 2026 г..
Для чего можно использовать unifi-voucher-site?
Выдача кодов доступа к WiFi гостям кафе, отелей и коворкингов. Печать ваучеров сотрудниками стойки регистрации на принтерах чеков. Автоматизация создания ваучеров через API из Home Assistant или других систем. Организация самообслуживания с доступом в интернет в общественных местах через киоск.
Как установить unifi-voucher-site?
Настройте UniFi Hotspot Portal, включив аутентификацию по voucher Создайте docker-compose.yml на основе примера из README и укажите настройки UniFi
Где скачать unifi-voucher-site?
Исходный код и инструкции по установке — на GitHub: https://github.com/glenndehaan/unifi-voucher-site

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Открытая прошивка для ESP32, позволяющая управлять адресными RGB-лентами, 2D-матрицами и панелями HUB75 по WiFi.

19 тыс.+47 за неделю4,4 тыс.C++EUPL-1.2Активно поддерживаетсяОбновлён позавчера