Installer et configurer un contrôleur Unifi sur Raspberry Pi

Ça fait des années que je gère des points d’accès en tant qu’admin système, et croyez-moi, dès qu’on dépasse les 10 appareils connectés, ça peut vite tourner au cauchemar. UniFi a réglé ce problème pour nous, mais leurs passerelles dédiées coûtent cher. La bonne nouvelle, c’est qu’un Raspberry Pi peut très bien jouer le rôle de contrôleur à leur place. Voici comment mettre ça en place.

L’application UniFi Network peut être installée sur Raspberry Pi en ajoutant un dépôt Debian et en utilisant apt pour installer les paquets nécessaires. Un paquet .deb est également disponible directement sur le site officiel. La configuration se fait ensuite via une interface web pratique.

L’installation en elle-même est simple. On l’installe comme n’importe quel paquet Debian. Mais la configuration des points d’accès est plus délicate, et je n’ai trouvé aucun article qui l’explique clairement. Comme je l’utilise au travail, je peux vous montrer toutes les étapes de configuration avec de vrais points d’accès et de vrais clients. C’est parti !

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 !

Les produits Ubiquiti Networks

Présentation d’Ubiquiti Networks

Ubiquiti Networks est une entreprise américaine qui vend du matériel pour les technologies sans fil : points d’accès, routeurs, caméras, etc.

Ils ont commencé avec les appareils sans fil, et ils diversifient maintenant leur gamme de produits. Leur dernière innovation concerne d’ailleurs la technologie solaire, pour aider à gérer des fermes solaires.

Bref, ce qui nous intéresse aujourd’hui, c’est leur célèbre gamme UniFi d’appareils réseau sans fil. Ces derniers sont pilotés par un logiciel : l’application UniFi Network (anciennement connue sous le nom de UniFi Controller).

Le but de l’application UniFi Network, c’est de gérer plusieurs points d’accès et appareils sans fil depuis une seule interface web. Depuis là, vous voyez tous vos points d’accès et diffusez un SSID unique. Le contrôleur gère lui-même le roaming entre les points d’accès et la répartition de charge.

Pourquoi ces produits sont-ils utiles ?

Ces produits visent surtout les entreprises et les grands espaces, mais on peut avoir les mêmes besoins « prosumer » à la maison si votre Wi-Fi pose problème (pièces sans réseau, roaming, instabilité, etc.).

Avant de passer aux produits Ubiquiti, j’ai testé pas mal de marques pour résoudre mes soucis, mais aucune ne tenait la charge au-delà de 10-20 utilisateurs en même temps (j’ai même testé un modèle ignifugé de D-Link, un truc comme ça sur Amazon ^^). Du coup, je recommande vraiment d’essayer Ubiquiti : c’est bien moins cher que les marques pro, et les performances sont au rendez-vous.

Par exemple, imaginons que vous ayez besoin de trois points d’accès chez vous. Si vous transformez votre Raspberry Pi en contrôleur Unifi, vous n’aurez qu’un seul SSID Wi-Fi (extérieur compris), au lieu de trois. Et vous pouvez vous déplacer d’un bout à l’autre sans jamais être déconnecté.

Les produits Ubiquiti

Les produits Ubiquiti sont distribués par des revendeurs, mais on les trouve aussi sur plusieurs sites e-commerce :

Pour tester ces produits, pas besoin de grand-chose. Achetez juste un ou plusieurs points d’accès et montez votre réseau sans fil pro.
Voici le lien : point d’accès Ubiquiti UniFi sur Amazon.

Plusieurs packs sont disponibles : un seul point d’accès, 2 AP, 4 AP, etc.
Choisissez celui qui vous convient, mais il n’y a pas de grosse économie à acheter en gros. Vous pouvez donc commencer avec un ou deux, et commander les autres après.

Si vous avez un switch PoE (comme celui-ci sur Amazon), vous pouvez les brancher directement avec le câble réseau. Un switch Ubiquiti n’est pas obligatoire, celui-ci de Cisco est moins cher par exemple. Tout dépend de ce que vous voulez faire et du nombre d’AP que vous avez.

Quel que soit votre choix, un switch PoE simplifiera vraiment l’installation.
Si vous voulez commencer sans, il y a une autre option : Ubiquiti fournit un adaptateur avec l’AP (câble d’alimentation + réseau = PoE Network), mais il vous faudra une prise électrique et deux câbles RJ45 au lieu d’un seul câble pour tout.

Voici le lien vers l’injecteur PoE sur Amazon. Petit conseil : vérifiez bien les besoins en alimentation de votre AP, car ils ne sont pas tous identiques (un AP Pro a besoin de PoE-48 par exemple).

Installation de l’application UniFi Network

Maintenant que vous savez ce que sont les produits UniFi, on peut passer à l’installation du logiciel. Voici un aperçu des étapes pour transformer votre Raspberry Pi en contrôleur UniFi :

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

Pas de panique, je détaille tout ça juste après.

Installation sur Raspberry Pi OS

Comme pour tout tutoriel sur ce site, vous devez d’abord installer Raspberry Pi OS sur votre Raspberry Pi.
N’importe quelle version fait l’affaire (moi 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 systemctl start ssh
Comme ça, vous pouvez suivre ce tutoriel depuis votre ordinateur (si besoin, jetez un œil à cet article pour en savoir plus).

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 !

Configurer une adresse IP statique

Comme notre Raspberry Pi va jouer le rôle de serveur sur notre réseau, il nous faut :

• Une connexion filaire
  Si vous voulez un réseau Wi-Fi rapide, votre contrôleur et vos points d’accès doivent être sur une bonne connexion. Je ne recommande donc pas de configurer le contrôleur en Wi-Fi.
  Consultez ce tutoriel si vous avez besoin d’aide sur cette étape : comment connecter le port Ethernet du Raspberry Pi (2 méthodes).
  
• Une adresse IP statique
  Le Raspberry Pi va devenir un nœud important sur votre réseau, donc il faut fixer son IP.
  Par défaut, le Raspberry Pi utilise le DHCP pour obtenir une IP au hasard parmi celles disponibles.

Vous pouvez soit configurer une IP statique dans le serveur DHCP (probablement sur votre routeur), soit le faire directement depuis la configuration du Raspberry Pi. Si vous ne savez pas comment faire, j’explique déjà tout ça à la fin de cet article. N’hésitez pas à y jeter un œil avant de continuer : configurer une adresse IP statique sur votre Raspberry Pi.

Installation de l’application UniFi Network

Maintenant que votre Pi a une IP fixe, on est prêt à démarrer l’installation.

Note : l’application UniFi Network nécessite des dépendances qui entrent souvent en conflit sur Raspberry Pi. Les solutions de contournement sont devenues compliquées, alors pour se simplifier la vie, on va utiliser un script d’installation automatisé.

Ce script est fourni par GlennR, qui le maintient depuis huit ans maintenant.

Voici comment installer l’application UniFi Network sur Raspberry Pi :

• Trouvez le script le plus récent disponible sur la page de GlennR : ici.
  Le script détecte votre distribution Linux et fonctionne même sur Raspberry Pi OS.
  
• Copiez le lien de la dernière version et téléchargez-la avec wget :
  wget https://get.glennr.nl/unifi/install/unifi-10.5.67.sh
• Lancez le script en utilisant le nom du fichier téléchargé :
  sudo bash unifi-10.5.67.sh
• Le script démarre et un écran d’accueil apparaît.
  Le script détecte votre Raspberry Pi (et applique des étapes spéciales adaptées à son matériel).
  Il commence par installer quelques paquets prérequis.
• On vous pose ensuite quelques questions de configuration :
  • Voulez-vous envoyer automatiquement les fichiers de support ? N
  • Voulez-vous garder le script sur votre système ? Y
  • Quel logiciel voulez-vous installer ? 2 (UniFi Network Application)
  • Voulez-vous utiliser MongoDB compilé ? Y
    
  • Voulez-vous procéder à la mise à jour de votre système ? Y
• Puis vient l’étape la plus importante : le script commence à installer les dépendances (principalement MongoDB et Java) compatibles avec votre système.
• Enfin, l’application UniFi Network s’installe.
  À la fin, le script vous donne le lien pour accéder au portail admin dans votre navigateur.
  

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

Et voilà ! Si tout est ok, passons à la section suivante pour apprendre à s’en servir.

Configuration du contrôleur UniFi

Dans cette section, vous allez apprendre à configurer l’application UniFi Network.
Plus précisément, on va voir comment :

• Accéder au portail web d’administration.
• Ajouter un point d’accès.
• Créer un réseau sans fil.

Voyons chaque étape en détail.

Premier accès

Pour accéder à l’interface web, allez sur https://<IP>:8443
Vous devriez avoir récupéré ce lien à la fin de l’installation.
Par exemple, dans mon cas c’est https://192.168.30.19:8443/

N’oubliez pas le https:// sinon vous aurez une erreur du genre « bad request…requires TLS. »
Au chargement de la page, un avertissement apparaît car on n’a pas de certificat sécurisé. C’est normal. Approuvez l’exception pour continuer.

On vous demande maintenant de configurer les paramètres initiaux de votre serveur :

• Commencez par donner un nom à votre serveur UniFi.
  
• Connectez-vous à votre compte UniFi.
  Ça dépend de ce que vous voulez faire ici.
  
  • Si vous avez besoin de l’interface cloud, utile pour administrer des sites distants, cliquez sur Create Account puis connectez-vous avec votre compte UI.
  • Si vous êtes toujours sur le même réseau (à la maison par exemple) et que vous n’avez pas besoin du panneau cloud, comme moi, cliquez sur Advanced Setup > Skip pour éviter de créer un compte. On vous demandera alors de créer un compte local pour vous connecter.
• Étape 3 : une fois le chemin choisi terminé, vous êtes redirigé vers votre tableau de bord.

Bien joué ! On peut enfin voir tout ça et configurer d’autres options si besoin.

Aperçu de l’interface web

Une fois connecté à l’interface web, vous avez plein de sous-menus pour tout gérer.
Pour l’instant, ça devrait être plutôt vide, mais dans la barre de gauche vous trouverez :

• Dashboard : un aperçu de votre réseau, comme le nombre d’AP, de clients, et les performances de votre réseau.
  
• Topology : ici vous pouvez charger un plan de votre bâtiment, et placer tous les AP dessus.
  Comme ça, vous savez où ils se trouvent et vous voyez la couverture Wi-Fi globale (approximativement).
• UniFi Devices : cette page montre tous les appareils réseau UniFi présents sur votre réseau.
  C’est la page la plus importante, c’est ici que vous gérez les AP.
• Clients : pareil mais pour les clients. Vous voyez ici tous les clients connectés avec leurs infos (IP, AP, utilisation réseau…) :
  

  

• Insights : vous y trouvez diverses informations.
  Je m’en sers surtout pour voir les clients connus (pas connectés actuellement, mais on peut consulter leur historique, les bloquer ou les débloquer).
• Admins : cette page permet de gérer les utilisateurs qui peuvent administrer ce portail.
• Settings : c’est assez important, je ne sais pas pourquoi c’est tout en bas. C’est la page où vous configurez tout. On va s’en servir pour créer le réseau sans fil.
• Logs : ici vous pouvez consulter les journaux pour voir si quelque chose cloche.

Maintenant que vous avez fait le tour de l’interface, on peut passer à la configuration du 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.
• C’est tout, en gros.
  Le voyant de statut devrait s’allumer et vous pouvez passer à l’étape suivante.

Sans switch PoE :

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

  

  (disponible sur Amazon si vous n’en avez pas avec votre point d’accès : à consulter ici).
• Connectez le port LAN à votre switch ou à une prise réseau murale.
• Connectez le port POE au point d’accès.
• Si le voyant du point d’accès se met à clignoter, c’est bon signe.

Configuration logicielle

Maintenant que le point d’accès est alimenté, on retourne sur l’interface web Unifi pour les étapes suivantes :

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

  

  Le contrôleur le voit, mais il faut lui 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 démarre, et après quelques secondes, vous devriez obtenir le statut « Connected ».
  

  

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

  

Bref, le premier point d’accès est prêt, et on peut 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 pour 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 passons à la création du SSID.

Créer un réseau sans fil

Créer un réseau sans fil, c’est en gros définir un SSID, un mot de passe et un type de sécurité.
Vous faites ça dans le menu « Settings » de la barre de gauche :

• Allez dans Settings et cliquez sur WiFi.
• Puis cliquez sur le bouton Create New :
  

  

• Dans la nouvelle fenêtre, choisissez un nom de SSID, une phrase de passe réseau (idéalement longue, entre 15 et 30 caractères, pour que votre Wi-Fi ne se fasse pas pirater), et plein d’autres options, comme la diffusion en dual-band.
  

  

• Si vous voulez peaufiner encore plus les réglages, passez Advanced en Manual. Vous pouvez alors choisir le type de sécurité, comme WPA2/WPA3.
• Une fois terminé, cliquez sur Create tout en bas pour sauvegarder.

Les points d’accès vont redémarrer 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 la changer dans Settings > LAN.

Retournez ensuite dans les différents menus pour voir les informations et statistiques de votre appareil.
Profitez-en 🙂

Et voilà, vous savez maintenant installer et configurer un contrôleur Unifi sur votre Raspberry Pi.
Ce contrôleur tourne parfaitement sur mes Raspberry Pi (3B+ et 4).
Je ne sais pas combien de clients il pourrait supporter, mais à la maison, c’est largement suffisant.

Questions fréquentes

Comment mettre à jour l’application UniFi Network ?

GlennR, le mainteneur du script, propose aussi un script de mise à jour bien pratique :

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

Si vous voulez que ce script pratique continue de fonctionner sur votre Pi dans le futur, pensez à soutenir GlennR. Il crée une nouvelle version à chaque mise à jour, à retrouver ici.

Faut-il laisser le Raspberry Pi allumé en permanence ?

Pas vraiment. Dès que le Raspberry Pi s’arrête, le portail admin du contrôleur devient inaccessible, mais les points d’accès continuent de fonctionner. Vous gardez l’accès au réseau Wi-Fi, mais vous perdez les fonctionnalités du contrôleur comme le roaming entre les AP.

Le serveur UniFi a-t-il des fonctionnalités avancées que vous n’avez pas mentionnées ?

Oui, beaucoup trop même. J’ai fait un tuto rapide, mais on peut faire bien plus : programmer des coupures, créer un accès invité avec ou sans VLAN, du Radius avec Active Directory, filtrer par 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 si vous rencontrez des scénarios bizarres pendant le processus d’adoption, vous pouvez le réinitialiser aux paramètres d’usine. Pour ça, utilisez le bouton reset près de la prise RJ45. Pendant que le point d’accès est allumé, maintenez le bouton appuyé 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