Installer UniFi Network Controller sur un NAS Synology en 5 minutes

Si Ubiquiti et sa gamme UniFi sont au cœur de vos préoccupations, alors cet article devrait vous intéresser. En effet, nous allons voir comment installer UniFi Network Controller sur un NAS Synology. C’est simple, rapide et efficace grâce à l’utilisation de Docker. Explications…

UniFi Controller et Synology

Pour piloter un ensemble de produit réseau UniFi, il faut un contrôleur. C’est une sorte de cerveau du réseau : installation, paramétrage, surveillance… mais aussi mise à jour des périphériques (point d’accès, switch…). On retrouve UniFi Controller généralement dans les routeurs de la marque : Dream Machine, Dream Machine Pro… Le fabricant Ubiquiti le fournit également sous forme d’une clé autonome appelée UniFi Cloud Key. La chose intéressante, c’est que l’application est fournie gratuitement par le fabricant. Ainsi, il est possible de l’installer sur n’importe quel appareil.

Basé sur Java, cela peut-être lourd de lancer l’application depuis un ordinateur… Surtout que certaines fonctions nécessitent qu’elle fonctionne 24h/24 comme le précise le fabricant : statistiques, rapports, groupes d’utilisateurs, portail invité, etc. C’est pour cette raison qu’il existe des alternatives.

Avec un NAS QNAP, vous avez la possibilité de trouver un paquet tout prêt mis à disposition par Stéphane (Qoolbox) en suivant ce lien. Si vous avez un Raspberry Pi, vous avez également le projet UniFiPi, mais ce dernier ne semble vraiment maintenu. Une petite recherche sur internet et une installation openjdk devrait être suffire. Enfin, il est possible d’installer UNMS dans une machine virtuelle.

Pour les NAS Synology, ce n’est pas forcément beaucoup compliqué. Si vous avez Docker, c’est encore plus simple. Nous allons utiliser l’image de jacobalberty. À noter que LinuxServer (plus généraliste) propose aussi une excellente image. C’est fou tout ce qu’on peut faire avec Docker sur un NAS…

UniFi et Docker

Connectez-vous à l’interface d’administration du NAS, puis lancer Docker… Si le paquet Docker n’est pas encore installé, passez par le Centre de Paquets 😉

Docker unifi

Allez sur Registre (menu de gauche) et tapez dans la zone de recherche (en haut à droite) : unifi. On double-clic sur le deuxième élément proposé. 

[edit] Suite à un problème de suivi, j’ai fait le choix de basculer sur une image linuxserver/unifi-controller (3e position dans la liste ci-dessus).

latest docker

Sélectionnez bien latest qui correspond à la dernière version de l’image Docker. Cela facilitera les mises à jour ultérieures…

jacobalberty unifi

Déplacez-vous dans la section Image (menu de gauche) et attendez que le téléchargement soit terminé. Une fois téléchargée, double cliquez sur l’image, vous devriez avoir cette fenêtre apparaître. Tout d’abord, vous pouvez réduire l’usage des ressources (priorité du processeur et de la mémoire).

unifi synology docker

Ensuite, appuyez sur le bouton Paramètres avancés. Puis déplacez-vous sur l’onglet Volume. Là, vous passerez par File Station pour créer dans le dossier docker un sous-dossier unifi. Puis dans ce dernier, vous créez 2 nouveaux dossiers data et log (sous le dossier unifi).

On reporte comme ci-dessous les chemins d’accès…

volume unifi

Ensuite, on se déplace sur l’onglet Réseau. Là, on doit obligatoirement cocher la case Docker Host en bas à gauche.

Enfin, on se déplace sur l’onglet Environnement. On désactive les valeurs BIND_PRIV et RUAS_UID0 en mettant false comme valeur à la place de true.

Selon l’auteur du conteneur, ses variable ne sont plus à utiliser sur les dernières images et peuvent générer des erreurs. La documentation a été mise à jour dans ce sens.

On appuie sur le bouton Appliquer, la petite fenêtre se referme. Puis, on appuie de nouveau sur le bouton Suivant et enfin le bouton Effectué.

Démarrage UniFi

Le lancement se fait automatiquement. On patiente 1 à 2 minutes le temps que le conteneur se lance correctement. Ensuite, ouvrez un nouvel onglet et tapez le nom ou l’adresse IP de votre NAS dans la barre d’adresse suivi de :8080 (ou le port choisi) ou :8443 si vous passez en HTTPS. Vous devriez avoir quelque chose du genre  : http://192.168.1.100:8080 ou bien https://192.168.1.100:8443

Pensez à ajouter les ports au niveau du Pare-feu du NAS si besoin 😉

UniFi Docker sur autres NAS

À noter que ce tutoriel peut tout à fait s’appliquer à d’autres NAS du marché… à condition d’avoir Docker 😀

  1. Hello et merci pour le tuto. J’utilisais le controleur en Docker avant mais je suis passé sur la clé depuis quelques temps. Ca m’évite d’avoir encore un conteneur qui tourne 😉

    Unifi c est le top, je conseille toujours. Et au final prix sont abordables

  2. c’est pas mal mais très cher. je prend l’exemple d’un switch 48 ports POE pour la maison.
    c’est moins de 500 Euro TTC chez la concurence.

    https://www.amazon.fr/Netgear-gs752tp-Port-Gigabit...

    https://www.amazon.fr/ZYXEL-Smart-Switch-Gigabit-GS1900-48HP/dp/B00KT3BCNW

    Pour la maison, il en faut 2 (un en backup en cas de pépin)
    J’en ait pour moins de 1000 Euro (avec les 2 switch). Combien pour un matériel équivalent chez Unify ?

    j’avais trouvé mieux chez Zyxel avec Nebula mais c’est hors de prix (927 Euro TTC)

    https://www.amazon.de/-/en/Gigabit-Ethernet-Managed-Switch-XGS1930-52HP/dp/B07HFB7CJR

    1. Bonsoir Paradise,

      j’ai connu les produits Ubiquiti au bouleau.
      J’ai beaucoup apprécié l’interface de la gamme Unifi (il faut savoir si je ne m’abuse qu’un des fondateurs de la marque est un ancien d’Apple, je ne suis pourtant pas utilisateur Apple).

      Les produits sont tout à fait concurrentiels

      https://eu.store.ui.com/collections/unifi-network-...

      Regarde chez MikroTik qui propose de ce que j’ai lu de bons produits

      https://www.senetic.fr/product/CRS354-48G-4S+2Q+RM

      Quelques dizaines d’euros de moins qui ne seront pas négligeables sur 2 produits.

    2. @paradise: tu ne peux pas du tout comparer. j’ai eu Dlink, Netgear et j’ai du Zyxel au bureau. On est à des années lumières de Unifi ! L’interface d’admin, les options bref Unifi c est du pro pro. Le suivi est remarquable, y a des mise à jour tout le temps. Dlink ou netgear j’ai du le jeter car au bout de quelques années aucune mise à jour et seulement manageable avec Internet explorer (vachement pratique…) Zyxel ca va mais pas de mise à jour ou très peu. Admin old school mais utilisable.
      Unifi c est https://www.cachem.fr/ubiquiti-unifi-interface-adm...

      et tout l ecosystème est top: bornes wifi top (entre 80-120e donc ca va), routeur etc…

      Pour info, si vous regardez dans les hotels ou ressort c est bcp bcp de unifi (on reconnait les bornes wifi exterieur ou dans couloir d hotels)

  3. UNMS = Ubiquiti Network Management System, et c’est pour la gamme Edge d’Ubiquiti, ce n’est pas le controleur Unifi.

  4. J’ai suivi ce tuto mais tel quel ça ne peux malheureusement pas fonctionner car la recherche des équipements se fait sur le réseau docker en 172.xxx…. et pas sur le LAN.
    Il faut donc le passer en mode host et ça fonctionne chez moi 🙂

  5. Salut à tous,

    Merci pour ton site 😉

    J’utilise l’UniFi Controller en docker sur mon RPI2 et depuis quelques temps mes 2 devices se déconnectent et reconnectent plusieurs fois dans une même journée.

    J’avais déjà eu ça sur mon US-8-60W et j’avais du le réinitialiser et forcer la provision en SSH.
    A présent ceux sont les 2 devices (U6 lite et US-8-60W).
    J’hésite à passer le contrôleur sur mon ASUSTOR AS6102T ou carrément me prendre un CLOUD KEY.

    Cela vous est déjà arrivé ?
    Merci 🙂

  6. Je voulais te remercie pour ce tuto ! Je suis heureux possesseur d’un AP depuis 5 jours et je cherchais à tirer parti de mon Synology pour avoir le Unifi Controller.

    Juste une petite question, est-ce que c’est normal que je perde la partie statistiques lorsque j’arrête et redémarre le container ? Est-ce que je me suis loupé au niveau de mes fichiers de configuration ou c’est normal ?

  7. Bonjour,
    J’ai réussi à installer le controller sur dans docker sur mon nas, mais je rencontre un gros problème impossible de connecter un device sur les réseaux wifi.
    Les devices tentent de se connecter mais ils n’arrivent pas à obtenir une adresse IP.
    J’ai testé pleins de trucs mais je n’ai plus d’idée 🙁

  8. Bonjour, merci pour ce tuto que j’ai suivi il y a quelques temps. Actuellement j’ai un message m’indiquant qu’il y a une mise à jour et cela me fait télécharger un fichier .deb ( 1c14-debian-6.4.54-0bb324db149c4793bd93c23d0f9be683.deb ).
    Comment fait-on la mise à jour avec ce fichier ?
    Merci

  9. Bonsoir,

    je souhaiterais à mettre à jour mon conteneur mais je n’y arrive pas et je ne souhaite pas perdre mes données.

    Merci de vos aides.
    Nico.

  10. Bonjour, super tuto merci.
    Je souhaite me lancer avec unifi…pas simple quand pour un novice.
    j’ai installé la version « linuxserver/unifi-controller » j’ai demarré et me suis connecté avec mes identifiant Unifi, je peux bien ajouter des périphique switch flex 5 ports.
    Le soucis c’est que je n’ai accès a internet sur le controleur et j’ai un message sur chaque page qui « Configurations will not be applied until you set up a gateway or switch »
    Comment créer un gateway? et comment peut-il detecter mon LAN et mon routeur?
    Merci

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Ce site utilise Akismet pour réduire les indésirables. En savoir plus sur comment les données de vos commentaires sont utilisées.