Aller au contenu
CloudZH

Docs / Réseau

UniFi OS Server

Fais tourner l'application UniFi Network pour tes points d'accès et switchs sur le serveur CloudZH.

Installation

zh unifi install

UniFi OS Server tourne sans root avec Podman sous son propre utilisateur. Ouvre-le sur https://unifi.example.com derrière ta connexion, ou à la maison sur https://<server-ip>:11443, par exemple https://192.168.1.200:11443.

Adresse inform

Tes appareils UniFi se signalent à l'adresse indiquée dans Inform host override. CloudZH y inscrit lui-même l'adresse filaire du serveur et la vérifie à chaque démarrage et toutes les 6 heures, pour que les appareils ne se signalent jamais à une adresse Wi-Fi ou de conteneur. Affiche-la ou modifie-la sur le serveur :

zh unifi inform              # show
zh unifi inform <server-ip>   # a fixed address instead
zh unifi inform auto         # back to automatic

Migrer depuis un autre contrôleur

Un appareil n'obéit qu'à un seul contrôleur. Garde-en exactement un actif.

  1. Crée une sauvegarde dans l'ancien contrôleur (Network → Settings → System → Backups) et restaure-la dans l'app Network sur CloudZH.
  2. Vérifie l'adresse inform avec zh unifi inform.
  3. Fais pointer chaque appareil vers le nouveau contrôleur via SSH. <device-ip> est l'adresse du point d'accès ou du switch, <server-ip> celle du serveur :
    ssh admin@<device-ip>
    set-inform http://<server-ip>:8080/inform
    La session SSH se coupe pendant le provisionnement de l'appareil. C'est normal.
  4. Vérifie avec info sur l'appareil : Connected (http://<server-ip>:8080/inform). Puis arrête l'ancien contrôleur.
Branche le serveur par câble

Si le serveur atteint ton réseau via le point d'accès qu'il gère, une mise à jour du firmware ou un mauvais réglage le coupe de lui-même. Désactive les mises à jour automatiques des appareils tant que le serveur est en Wi-Fi.

UniFi OS Server prend en charge l'application Network. Protect, Access et Talk nécessitent une console UniFi.