Installer et configurer un contrôleur Unifi sur Raspberry Pi

Si vous avez déjà plusieurs points d’accès Wi-Fi, vous savez que leur gestion peut être un cauchemar. Mais en transformant votre Raspberry Pi en contrôleur Unifi, cette tâche devient plus facile : vous pouvez gérer tous vos points d’accès en un seul endroit. Dans ce guide, je vais vous montrer comment installer cette solution.

L’application réseau Unifi peut être installée sur Raspberry Pi en ajoutant un dépôt Debian et en installant les paquets nécessaires via « apt ». Un paquet .deb est également disponible sur le site web. La configuration peut ensuite être effectuée via une interface web pratique.

L’installation est simple, vous pouvez l’installer comme tout paquet Debian. Mais la configuration des points d’accès n’est pas si facile, et je n’ai vu aucun article l’expliquant. Comme je l’utilise au travail, je peux vous montrer toutes les étapes de configuration avec de vrais points d’accès et clients. Voyons comment faire cela !

Si vous débutez avec Raspberry Pi ou Linux, j’ai quelque chose qui peut vous aider !
Téléchargez ma fiche mémo des commandes Linux gratuitement – c’est un guide de référence rapide avec toutes les commandes essentielles dont vous aurez besoin utiliser votre Raspberry Pi. Cliquez ici pour l’obtenir gratuitement !

Produits Ubiquiti Networks

Présentation d’Ubiquiti Networks

Ubiquiti Networks est une entreprise américaine, vendant du matériel pour les technologies sans fil comme les points d’accès, les routeurs et les caméras.

Ils ont commencé avec des appareils sans fil, et ils se diversifient maintenant avec une gamme plus large de produits. Le dernier produit innovant concerne la technologie solaire qui vous aide à gérer les parcs solaires.

Quoi qu’il en soit, le produit qui nous intéresse aujourd’hui est leur célèbre gamme UniFi de dispositifs réseau sans fil. Ceux-ci seront contrôlés par un logiciel : Unifi Network Application (anciennement connu sous le nom de Unifi Network Controller).

L’objectif de l’Unifi Network Application est de gérer plusieurs points d’accès et appareils sans fil à partir d’une seule interface web. À partir de là, vous pouvez voir tous les points d’accès et diffuser un SSID unique. Le contrôleur gérera l’itinérance entre les points d’accès et la répartition de la charge.

Pourquoi ai-je besoin de ces produits ?

Ces produits ciblent principalement les entreprises et les grandes surfaces, mais vous pouvez avoir les mêmes besoins « prosumer » à la maison si vous avez des problèmes avec votre connexion Wi-Fi (pièces sans réseau, itinérance, stabilité, etc.).

Avant de passer aux produits Ubiquiti, je me souviens avoir testé de nombreuses marques pour résoudre mes problèmes, mais aucune d’entre elles ne pouvait supporter plus de 10-20 utilisateurs simultanément (j’ai même testé un modèle anti-feu de D-Link, quelque chose comme celui-ci sur Amazon ^^). Donc, je recommande fortement d’essayer Ubiquiti, car c’est peu coûteux comparé aux marques d’entreprise mais très performant.

Par exemple, disons que vous avez besoin de trois points d’accès à la maison. Si vous transformez votre Raspberry Pi en contrôleur Unifi, vous n’aurez qu’un seul SSID Wi-Fi (extérieur inclus) — au lieu de trois. Et vous pouvez passer d’un côté à l’autre sans déconnexion.

Produits Ubiquiti

Les produits Ubiquiti sont distribués par des revendeurs mais sont également disponibles sur plusieurs sites de e-commerce :

Pour tester ces produits, vous n’avez pas besoin de beaucoup de choses. Achetez simplement un ou plusieurs points d’accès et construisez votre réseau sans fil professionnel.
Voici le lien : Ubiquiti Unifi AP on Amazon.

Vous avez plusieurs packs disponibles : un seul, 2 AP (point d’accès), 4 AP, etc.
Choisissez celui que vous préférez, mais il n’y a pas de grosses économies à acheter en gros, vous pouvez donc commencer avec un ou deux, et commander les autres après.

Si vous avez un commutateur PoE (comme celui-ci sur Amazon), vous pouvez les brancher uniquement au câble réseau. Un switch Ubiquiti n’est pas obligatoire, celui-ci de Cisco est moins cher par exemple. Cela dépend de ce que vous voulez en faire et du nombre de points d’accès que vous avez.

Quel que soit votre choix, un commutateur PoE facilitera l’installation.
Si vous voulez commencer sans, il y a une autre option : Ubiquiti fournit un adaptateur avec le point d’accès (cordon d’alimentation + réseau = réseau PoE), mais vous avez besoin d’une prise électrique et de deux câbles RJ45 au lieu d’un seul câble pour tout.

Voici le lien vers l’injecteur PoE sur Amazon, assurez-vous de vérifier les exigences d’alimentation du point d’accès car elles ne sont pas toutes identiques (par exemple, un point d’accès Pro nécessite PoE-48).

Installation de l’application UniFi Network

Maintenant que vous comprenez ce que sont les produits UniFi, nous pouvons passer à la configuration du logiciel. Voici un aperçu de la façon de transformer votre Raspberry Pi en contrôleur UniFi :

• Installer et mettre à jour Raspberry Pi OS.
• Définir une adresse IP statique.
• Télécharger le script d’installation automatique de l’application Unifi Network.
• Exécuter le script d’installation automatique UniFi.

Ne vous inquiétez pas, je vais tout expliquer en détail ensuite.

Installation sur Raspberry Pi OS

Comme pour tout tutoriel sur ce site, vous devez d’abord installer Raspberry Pi OS sur votre Raspberry Pi.
Toute version fera l’affaire (j’utilise Raspberry Pi OS Lite).
Si vous ne savez pas comment faire, lisez mon article sur Comment installer Raspberry Pi OS sur votre Raspberry Pi.

Une fois installé, mettez à jour votre système et redémarrez :
sudo apt update
sudo apt upgrade
sudo reboot

Et activez l’accès SSH avec :
sudo service ssh start
De cette façon, vous pouvez suivre ce tutoriel depuis votre ordinateur (si besoin, consultez cet article pour en savoir plus à ce sujet).

Si les commandes Linux ce n’est pas trop votre truc, n’hésitez pas à jeter un œil à cet article qui vous explique les commandes qu’il faut absolument connaître. Je vous donne aussi une antisèche à télécharger pour les avoir toujours sous la main !

Remarque : Si vous n’utilisez pas Raspberry Pi OS, j’ai aussi un article sur comment installer UniFi sur Ubuntu (en anglais). Cette méthode devrait fonctionner pour la plupart des distributions basées sur Debian.

Définir une adresse IP statique

Comme notre Raspberry Pi va agir en tant que serveur sur notre réseau, nous devons utiliser :

• Une connexion filaire
  Si vous voulez un réseau Wi-Fi rapide, vous devez avoir votre contrôleur et votre point d’accès sur une bonne connexion. Je ne recommande donc pas de configurer le contrôleur avec une connexion Wi-Fi.
  Consultez ce tutoriel si vous avez besoin d’aide pour cette étape : Comment connecter le port Ethernet du Raspberry Pi (2 manières).
  
• Une adresse IP statique
  Le Raspberry Pi deviendra un nœud important sur votre réseau, nous devons donc fixer son IP.
  Par défaut, le Raspberry Pi utilise un serveur DHCP pour obtenir une IP aléatoire parmi celles disponibles.

Vous pouvez soit définir une IP statique dans le serveur DHCP (probablement sur votre routeur) ou le faire depuis la configuration du Raspberry Pi. Si vous ne savez pas comment faire, je l’explique déjà à la fin de cet article. N’hésitez pas à y jeter un coup d’œil avant d’aller plus loin : Set a static IP address on your Raspberry Pi.

Installation de l’application Unifi Network

Maintenant que votre Pi a une IP statique, nous sommes prêts à commencer l’installation.

Remarque : Les changements de dépendances ont fait que les versions les plus récentes de l’application Unifi Network ne fonctionnent plus sur Raspberry Pi. Les solutions de contournement nous ont obligés à installer des paquets obsolètes et non sécurisés.

Pour simplifier les choses, nous allons utiliser un script d’installation automatique fourni par GlennR, qui l’a maintenu pendant les six dernières années.

Voici comment installer l’application UniFi Network sur Raspberry Pi en utilisant un script d’auto-installation :

• Trouvez le script le plus récent disponible sur la page de GlennR : ici
  
• Copiez le lien pour la version souhaitée et téléchargez le script :
  wget https://get.glennr.nl/unifi/install/unifi-9.0.108.sh
• Lancez le script en utilisant le nom de fichier téléchargé :
  sudo bash unifi-9.0.108.sh
• Le script va démarrer et un écran d’accueil apparaîtra.
  Le script va détecter votre Raspberry Pi (et utiliser des étapes spéciales pour son matériel).
  Il commencera par installer quelques paquets prérequis.
• Lorsque vous serez invité à utiliser MongoDB compilé, répondez Oui.
  
• Vous serez posé quelques questions supplémentaires. Vous pouvez simplement appuyer sur Entrée pour accepter les paramètres par défaut:
  • Voulez-vous partager votre configuration ? N
  • Voulez-vous garder le script sur votre système ? Y
  • Voulez-vous mettre à jour votre système ? Y
• Ensuite vient la partie la plus importante : le script installe des dépendances qui fonctionnent sur le Pi.
  – un binaire serveur MongoDB. (Cela a causé beaucoup de problèmes lors des installations précédentes.)
  – OpenJDK. (Java était un autre problème commun qui causait des interruptions.)
• Enfin, l’application UniFi Network est installée.
  

Maintenant que l’installation est terminée, vérifions si le serveur UniFi est en ligne :
systemctl status unifi

Succès ! Si tout est bon, passez à la section suivante pour apprendre à utiliser le logiciel.

Configuration du contrôleur Unifi

Premier accès

Pour accéder à l’interface web, allez à https://<IP>:8443
Par exemple, dans mon cas, c’est https://192.168.1.25:8443/
(N’oubliez pas le https:// ou vous recevrez une erreur indiquant « bad request…requires TLS. »)

Lors du chargement, vous aurez un avertissement car nous n’avons pas de certificat sécurisé pour le moment.

Acceptez l’exception et passez à la page suivante pour configurer tout ce dont vous avez besoin pour commencer :

• Étape 1 : Commencez par donner un nom à votre contrôleur.
  Cochez la case de l’accord de licence et cliquez sur « Next »
  
• Étape 2 : Choisissez si vous souhaitez activer l’interface cloud (par défaut) ou non (avancé).
  Cela dépend de ce que vous essayez de faire.
  Si vous êtes toujours sur le même réseau (à la maison ou dans une entreprise), vous n’avez pas vraiment besoin du panneau cloud. Mais cela peut être utile pour les sites distants.
  • Si vous gardez l’option par défaut, remplissez le formulaire pour créer un compte Unifi.
  • Dans l’option avancée, vous avez un formulaire comme ceci :
    
    Si vous activez une option, vous devez créer un compte cloud ET un compte local.
    Je n’en ai pas besoin pour mon test, donc je désactive tout.
• Étape 3 : Connectez-vous ou configurez les options.
  Cette étape est également différente selon votre choix à l’étape précédente.
  Vous pouvez avoir besoin de vous connecter à votre compte, ou simplement de configurer deux options supplémentaires (sauvegarde automatique et auto-optimisation).
  Laissez-les activées si on vous le demande.
• Étape 4 : Configurez vos appareils.
  
  Vous pouvez simplement passer ceci, ce n’est pas nécessaire pour le moment. Vous pouvez ajouter des appareils à tout moment dans l’interface.
• Étape 5 : Vous pouvez enfin configurer vos paramètres Wi-Fi maintenant.
  
  Vous pouvez également changer cela dans l’interface, alors choisissez simplement quelque chose pour commencer.
• Étape 6 : Enfin, vous devez également revoir vos paramètres et vous aurez fini.
  

Bon travail ! Vous serez maintenant redirigé vers le panneau web.
Nous pouvons enfin le voir et configurer plus de choses si nécessaire.

Aperçu de l’interface web

Une fois connecté à l’interface web, vous aurez de nombreux sous-menus pour tout gérer.
Pour le moment, cela devrait être assez vide, mais dans la barre de gauche, vous pouvez voir :

• Dashboard : Ici, vous pouvez avoir un aperçu de la performance de votre réseau (nombre de PA et de clients).
  La majeure partie de ce tableau de bord nécessite la « Unifi Security Gateway », donc ce n’est pas une page importante.
• Statistics : Sur cette page, vous pouvez surveiller les clients et le trafic de tout le réseau.
  Pour le moment, rien ici 🙂
• Map : Dans celle-ci vous pouvez télécharger une carte de votre bâtiment, et y placer tous les AP.
  De cette façon, vous pouvez savoir où ils se trouvent et voir la couverture Wi-Fi globale (approximativement).
• Devices : Cette page vous montre tous les appareils Unifi que vous avez sur votre réseau.
  C’est la page la plus importante, vous allez gérer les AP d’ici.
• Clients : Même chose pour les clients. Vous verrez ici tous les clients connectés avec des informations les concernant (IP, AP, utilisation réseau, …):
  

  

• Insights : Ici, vous pouvez voir des informations diverses.
  Je l’utilise principalement pour voir les clients connus (non connectés actuellement, mais vous pouvez vérifier l’historique, les bloquer ou les débloquer).
• Events : Cette fenêtre vous montre tous les journaux récents sur votre réseau
  Cela peut être les connexions clients, les mises à jour AP, l’itinérance, …
• Alerts : Même chose avec les erreurs et avertissements.
• Settings : Et c’est la page où vous configurerez tout.
  Nous l’utiliserons pour créer le réseau sans fil.
• Chat support : Si vous avez besoin d’aide de la part de Unifi, vous pouvez demander de l’aide ici.

Maintenant que vous avez visité l’ensemble de l’interface, nous pouvons avancer pour configurer le point d’accès.

Ajouter le premier point d’accès

Préparation physique

Il y a deux possibilités pour le câblage du point d’accès.

Avec un switch PoE :

• Branchez le point d’accès au Switch PoE avec un câble RJ45.
• Fondamentalement, c’est tout.
  La lumière de statut devrait s’allumer et vous pouvez passer à l’étape suivante.

Sans switch PoE :

• Vous devez avoir un adaptateur PoE comme celui-ci :
  

  

  (il est disponible sur Amazon si vous n’en avez pas avec votre point d’accès : vérifiez ici).
• Connectez le port LAN à votre commutateur ou prise réseau murale.
• Connectez le port POE au point d’accès.
• Si la LED du point d’accès commence à clignoter, c’est bon.

Configuration logicielle

Maintenant que nous avons alimenté le point d’accès, nous pouvons revenir à l’interface web Unifi pour les étapes suivantes :

• Accédez à l’interface web : https://IP:8443.
• Cliquez sur « Devices » dans le menu de gauche.
• Vous devriez maintenant voir votre point d’accès dans la liste :
  

  

  Le contrôleur le détecte, mais nous devons indiquer que c’est un point d’accès pour ce contrôleur.
• Cliquez sur « Adopt » à la fin de la ligne.
  Le processus d’adoption commence, après quelques secondes, vous devriez obtenir le statut « Connected ».
  

  
  
  

• Si nécessaire (probablement), vous pouvez mettre à jour le firmware de l’AP vers la dernière version en cliquant sur « Upgrade« .
  Votre point d’accès prendra quelques minutes pour télécharger et mettre à jour le firmware.
  

  

Quoi qu’il en soit, le premier point d’accès est prêt, et nous pouvons maintenant créer le réseau sans fil (SSID).

Vous pouvez cliquer sur la ligne pour voir et modifier d’autres paramètres du point d’accès (à droite).

Par exemple, vous pouvez définir un alias pour chaque point d’accès afin de savoir lequel est lequel.
Dans la fenêtre des propriétés, cliquez sur l’onglet config et définissez un alias.

Modifiez tout ce que vous voulez sur le point d’accès et passez à la création du SSID.

Créer un réseau sans fil

Créer un réseau sans fil revient essentiellement à définir un SSID, un mot de passe et un type de sécurité.
Vous pouvez le faire dans le menu « Settings » de la barre de gauche :

• Dans le menu settings, cliquez sur « Wireless Networks« .
• Ensuite, cliquez sur le bouton « Create a new wireless network » :
  

  

• Dans la nouvelle fenêtre, choisissez un SSID, un type de sécurité et un mot de passe :
  

  

  Choisissez WPA-Personal (ou WPA2/WPA3) pour la sécurité, car WEP n’est pas sécurisé.
  Et préférez un mot de passe long (idéalement une phrase de 15 à 30 caractères).
• Cliquez sur « Save ».

Les points d’accès redémarreront avec les nouveaux paramètres.
Après quelques secondes, le nouveau réseau sans fil est disponible pour tous vos appareils.

Connectez-vous et vérifiez que tout fonctionne bien.
Par défaut, le contrôleur Unifi vous donnera une adresse IP dans votre réseau principal.
Vous n’avez rien d’autre à faire, mais vous pouvez le changer dans Settings > LAN.

Ensuite, retournez dans les différents menus pour voir les informations et les statistiques concernant votre appareil.
Profitez-en 🙂

C’est tout, vous savez comment installer et configurer un contrôleur Unifi sur votre Raspberry Pi.
Ce contrôleur fonctionne parfaitement sur mon Raspberry Pi (3B+ et 4).
Je ne sais pas combien de clients il pourrait gérer, mais à la maison c’est largement suffisant.

Questions connexes

Comment mettre à jour l’application Unifi Network ?

GlennR, le mainteneur du script, propose également un script de mise à jour facile :

• Téléchargez le programme de mise à jour de l’application Unifi Network :
  wget https://get.glennr.nl/unifi/update/unifi-update.sh
• Exécutez le script :
  sudo bash unifi-update.sh

Si vous souhaitez que ce script facile continue de fonctionner sur votre Pi à l’avenir, envisagez de soutenir GlennR. Il crée de nouvelles versions pour chaque mise à jour que vous pouvez trouver ici.

Dois-je laisser le Raspberry Pi allumé ?

Pas vraiment. Dès que le Raspberry Pi s’arrête, le contrôleur n’est plus disponible, mais les points d’accès continueront de fonctionner. Vous pouvez toujours accéder au réseau Wi-Fi, mais vous perdez les fonctionnalités du contrôleur comme le roaming entre les AP.

Le contrôleur Unifi a-t-il des fonctionnalités avancées que vous n’avez pas mentionnées ?

Oui, beaucoup. J’ai fait un tutoriel rapide, mais vous pouvez faire bien plus : programmer des temps d’arrêt, créer un accès invité avec VLAN ou non, Radius avec Active Directory, filtrer adresse MAC, bloquer et débloquer des clients, etc…

Comment réinitialiser un point d’accès Unifi ?

Si vous perdez l’accès à un point d’accès ou rencontrez des scénarios étranges lors du processus d’adoption, vous pouvez le réinitialiser aux paramètres d’usine. Pour ce faire, utilisez le bouton de réinitialisation près de la prise RJ45. Pendant que le point d’accès est sous tension, maintenez le bouton enfoncé pendant 10 secondes, puis attendez la réinitialisation.

Ressources supplémentaires pour votre Raspberry Pi

Initiation au Raspberry Pi en vidéo
Si vous débutez et voulez passer rapidement à la vitesse supérieure, j’ai exactement ce qu’il vous faut.
Regardez ma formation vidéo qui vous aidera à démarrer du bon bien, choisir votre matériel, installer les meilleures applications et vous lancer directement dans vos premiers projets avec mon aide.
Regarder les vidéos dès maintenant

Maîtrisez votre Raspberry Pi en 30 jours
Vous avez besoin de plus ? Si vous êtes à la recherche des meilleures astuces pour devenir expert sur Raspberry Pi, ce livre est fait pour vous. Développez vos compétences sous Linux et pratiquez via de nombreux projets en suivant mes guides étape par étape. 10% de remise aujourd’hui !
Télécharger le livre au format PDF ici

Maîtrisez Python sur Raspberry Pi
Pas besoin d’être un génie pour coder quelques lignes pour votre Raspberry Pi.
Je vous apprends juste ce qu’il faut sur Python afin de réaliser n’importe quel projet. La seconde partie du livre est d’ailleurs consacrée à des exemples de projets où je vous guide pas à pas.
Ne perdez pas de temps, apprenez le strict nécessaire et économisez 10% avec ce lien :
Télécharger maintenant

Autres ressources pour profiter de votre Raspberry Pi
J’ai regroupé toutes mes recommandations de logiciels, sites utiles et de matériel sur cette page de ressources. Je vous invite à la consulter régulièrement pour faire les bons choix et rester à jour.
Visiter les pages ressources