title: UniFi Voucher Site created: 2026-06-07 updated: 2026-06-07 type: app tags: [catalogue, networking, unifi, hotspot, voucher, php, wifi] confidence: high contested: false sources: [https://selfh.st/apps/?tag=networking, https://github.com/davidmbyers/ubiquity-unifi-voucher-site]

UniFi Voucher Site 🎟️

Générateur de vouchers hotspot pour routeurs/pare-feux UniFi (Ubiquiti) avec interface PHP simple et impression facile.

Métadonnée	Valeur
Site web	https://github.com/davidmbyers/ubiquity-unifi-voucher-site
GitHub	https://github.com/davidmbyers/ubiquity-unifi-voucher-site
License	MIT
Langage	PHP
Étoiles	33 ⭐
Dernière MAJ	2023
Catégorie	cat-networking

Description

UniFi Voucher Site est une application PHP légère qui s'interface avec un contrôleur UniFi (UniFi Network Application) pour générer des vouchers hotspot (codes d'accès invités). Le but : remplacer la console d'administration officielle par une page web simplifiée, accessible à des non-techniciens (réception d'hôtel, accueil d'une association, gérant de café), pour créer et imprimer des codes temporaires.

L'interface propose typiquement : choix de la durée (1h, 1 jour, 1 semaine), du débit (limité ou non), du nombre de vouchers à générer, et un bouton « imprimer » qui sort une feuille A4 prête à découper. Les vouchers générés apparaissent immédiatement dans l'UniFi Controller et fonctionnent avec n'importe quel AP UniFi configuré en mode hotspot.

Idéal pour les petites structures d'hébergement (gîtes, chambres d'hôtes, coworkings, fablabs) qui veulent offrir un Wi-Fi invité propre sans former le personnel à l'admin UniFi complète. Le code est volontairement minimal pour pouvoir être modifié facilement.

Installation

Docker Compose (recommandé)

services:
  unifi-voucher:
    image: ghcr.io/davidmbyers/unifi-voucher-site:latest
    container_name: unifi-voucher
    restart: unless-stopped
    environment:
      - UNIFI_URL=https://unifi-controller.local:8443
      - UNIFI_USER=admin
      - UNIFI_PASS=changeme
      - UNIFI_SITE=default
    ports:
      - "8086:80"

⚠️ L'image Docker n'est pas officielle : construire depuis les sources si nécessaire (docker build .).

Manuelle (PHP + Apache/Nginx)

git clone https://github.com/davidmbyers/ubiquity-unifi-voucher-site.git
cd ubiquity-unifi-voucher-site
cp config.example.php config.php  # éditer les credentials UniFi
# Servir le dossier via Apache/Nginx + PHP 7.4+

Configuration

Dans config.php (ou variables d'environnement en mode Docker) :

UNIFI_URL : URL du contrôleur UniFi (souvent https://controller.local:8443)
UNIFI_USER/PASS : compte admin local (pas un compte UniFi Cloud)
UNIFI_SITE : nom du site (par défaut default)
Le contrôleur UniFi doit être accessible depuis le conteneur (même réseau ou routage).

Alternatives

Open Source : unifi-voucher-generator (Python, plus complet), UniFi-API-browser (browser de l'API complète)
UniFi officiel : la console du contrôleur permet déjà de générer des vouchers, mais sans la simplicité d'une page dédiée imprimable.
Propriétaire : portail captif Ubiquiti intégré (déjà natif, mais interface plus complexe).
Autres portails captifs : CoovaChilli, pfSense Captive Portal.

Sécurité

Compte admin UniFi : créer un compte dédié à l'app avec droits limités (et non le compte admin principal).
HTTPS obligatoire : placer derrière un reverse-proxy (Traefik, Nginx Proxy Manager) avec certificat Let's Encrypt.
Stockage des credentials : variables d'environnement, jamais en clair dans le repo.
Logs : surveiller l'accès à l'interface, car elle permet de générer des accès réseau.
Durée des vouchers : limiter volontairement (ex. 24h) pour éviter l'abus.

Ressources

Pages Liées

cat-networking
recettes-docker-compose
app-unifi-poller — métriques UniFi (autre outil du même écosystème)

4.5 KiB Raw Blame History