wiki/HowtoUniFi.md
2022-05-02 18:05:14 +02:00

108 lines
3.1 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Howto UniFi
Points d'accès Wi-Fi Ubiquiti : <https://www.ubnt.com/unifi/unifi-ap/>
## Installation
### Debian
Récupérer la dernière version de UniFi Network Controller sur <https://www.ui.com/download/unifi/>
~~~
# apt install ./unifi_sysvinit_all.deb
$ firefox <https://127.0.0.1:8443/>
~~~
### OpenBSD
Il y a un port mais à cause des restrictions d'un point de vue de license, il n'y a pas que paquet
~~~
cd /usr/ports/net/unifi && make install
~~~
## Administration
Attention, l'interface ne détecte la borne qui si elle est dans un même segment réseau (niveau 2, donc pas de routage...).
Une fois la borne configurée, vous pouvez y accéder en SSH (récupérer son IP via l'interface... ou fixer son IP via DHCP) et le login / pass de l'interface, vous avez un OpenWRT :)
~~~
$ ssh root@10.0.0.11
BZ.v3.2.7# info
Model: UAP
Version: 3.2.7.2816
MAC Address: 24:a4:3e:a6:42:a2
IP Address: 10.0.0.11
Hostname: UBNT
Uptime: 2151 seconds
Status: Connected (http://10.0.0.1:8080/inform)
~~~
## Portail Captif
Pour mettre en place un portail captif :
* Aller dans l'onglet "Settings"
* Dans "WiFi", cliquer sur "Create New WiFi Network"
* Compléter les "Name" (SSID) et "Password" (ou le mettre en "Open" sous "Security" si pas de mot de passe souhaité) du réseau, sélectionner un groupe de points d'accès si nécessaire, puis dans "Advanced Configuration" sélectionner "Manual" pour pouvoir choisir le "WiFi Type" comme "Guest Hotspot"
* Configurer les autres paramètres comme souhaité, puis valider
Le portail captif peut être entièrement personnalisé :
* Aller dans l'onglet "Settings"
* Dans "Profiles", sous "Guest Hotspot" cliquer sur "Default"
* L'authentification est facultative
* Personnaliser, au souhait : l'image de fond, le logo, les couleurs, les conditions générales d'utilisation, le texte de bienvenue, la durée après laquelle un utilisateur doit à nouveau accepter les conditions, la langue du portail, les réseaux autorisés sans besoin d'accepter les conditions, les réseaux interdits même après acceptation des conditions, … Puis valider
À la connexion, l'utilisateur sera automatiquement redirigé sur le portail captif avant de pouvoir accéder à Internet.
## FAQ
### Supprimer la preallocation de MongoDB
Si vous avez oublié d'ajuster "nojournal=true" vous aurez 3,3 Go dans data/db/journal/ :
~~~
$ pkill java
$ rm data/db/journal/*
$ vim data/system.properties
unifi.db.nojournal=true
$ java -jar lib/ace.jar start
~~~
### Reset de la borne
Appuyer 10 secondes sur le bouton RESET de la borne, elle pase au rose et reboot.
### Sauvegarde des données de l'interface
Si vous n'avez plus vos données d'interface, il est quasi-impossible d'accéder à la borne sans réinstaller une interface et reset la borne.
Il est donc conseillé de sauvegarder les données :
~~~
$ tar cf unifi-backup.tar data/
~~~
Ces données peuvent être restaurées sur une nouvelle installation pour retrouver les paramètres.
### Commandes existantes
Aide succinte
~~~
$ help
~~~
Pour voir la configuration actuelle
~~~
$ less /tmp/system.cfg
~~~