Sammanfattning: För en ny UniFi-installation bör du följa Ubiquitis aktuella modell för egen drift i stället för en BigBear-container från 2024
CasaOS-inlägget från 2024 hänvisade användare till ett BigBearCasaOS-paket för UniFi Network Application. Ubiquitis aktuella lösning för egen drift har förändrats: företaget rekommenderar nu UniFi OS Server för egen drift på Linux, Windows och macOS som stöds, och säger uttryckligen att hela UniFi OS Server inte finns som en fristående Docker-/Podman-container eftersom upptäckt, adoption och uppdateringar är beroende av tjänster på värdsystemet. Därför är en gammal community-container en äldre lösning, inte det rekommenderade standardvalet för 2026.
Välj rätt UniFi-produkt först
Om du redan äger en UniFi Cloud Gateway, till exempel en UDM eller UCG, innehåller den redan UniFi Networks kontrollplan och bör inte adopteras av en extern server med egen drift. Om du använder fristående gateways, switchar och åtkomstpunkter kan en UniFi-server med egen drift vara lämplig.
Ubiquitis UniFi-lösning för egen drift beskriver denna avgränsning.
Välj en dedikerad Linux-VM för ZimaOS-värdar
Eftersom den aktuella UniFi OS Server förväntar sig tjänster på värdsystemnivå i stället för en enda Docker-container, passar en liten Debian-/Ubuntu-VM bättre på ZimaOS än att tvinga in hela servern i NAS-värden. Det isolerar uppdateringar, beroenden för Java/Mongo/tjänster samt nätverksupptäckt från ZimaOS-enheten.
ZimaOS VM-krav beskriver resursmodellen på ZimaOS-sidan.
Öppna de nätverksportar som krävs på ett genomtänkt sätt
Upptäckt och adoption av UniFi-enheter kräver mer än webbgränssnittet. Ubiquiti listar bland annat UDP 3478, UDP 10001 och TCP 8080 för klassiska arbetsflöden i Network Application, samt ytterligare portar beroende på fjärråtkomst och funktioner. UniFi-portar som krävs är den aktuella portreferensen.
Se till att servern och enheterna kan nå varandra vid adoption
Om åtkomstpunkter eller switchar finns på ett annat VLAN eller subnät kanske Layer 2-upptäckt inte fungerar. Använd en genomtänkt metod för fjärradoption och se till att routning och brandväggsregler tillåter den nödvändiga styrtrafiken. Försök inte lösa upptäckten genom att öppna alla UniFi-portar mot det offentliga internet.
Säkerhetskopiera UniFi-anläggningen före uppdateringar
Ubiquiti rekommenderar att du laddar ned en säkerhetskopia innan du uppdaterar en Network-server med egen drift. Spara en kopia utanför VM:ens eller systemets disk. ZimaOS-säkerhetskopiering tillhandahåller återställningslagret på NAS-nivå.
Varför det gamla Docker-paketet fortfarande kan fungera
Containeravbildningar från communityn för den klassiska UniFi Network Application kan fortfarande fungera för vissa användare. Det innebär inte att de är likvärdiga med stödet för den aktuella UniFi OS Server. Om du medvetet behåller en sådan lösning bör du låsa versionerna, spara databas- och konfigurationsdata permanent och följa bildunderhållarens uppdateringsanvisningar.
Exponera inte administrationsgränssnittet direkt utan HTTPS
Inloggningsuppgifter för nätverkskontrollern kan ändra Wi-Fi, gateways och VLAN. Begränsa administrationsslutpunkten till LAN/VPN där det är möjligt. Om den måste vara offentlig bör du använda stark autentisering, TLS och begränsad åtkomst från källadresser. ZimaOS HTTPS-proxy täcker gränsen mot det offentliga webbnätet.
När bör du välja en UniFi Console i stället?
Om nätverkshanteringen är verksamhetskritisk och du vill ha Ubiquitis integrerade väg för uppdateringar och support är en UniFi Cloud Gateway eller Console enklare att drifta än egen drift. Välj UniFi på ZimaOS när du specifikt vill drifta controller-infrastrukturen själv.
Planera adoptionen innan du flyttar en befintlig UniFi-anläggning
Om enheterna redan har adopterats av en annan controller ska du inte bara starta en andra server och förvänta dig att den tar över. Exportera en säkerhetskopia av anläggningen eller systemet, notera den aktuella inform-/styradressen och använd Ubiquitis process för migrering och adoption som stöds. En controllerflytt bör bevara enhetsägarskap, WLAN-/VLAN-inställningar och certifikat i stället för att tvinga alla åtkomstpunkter tillbaka till fabriksinställningarna.
Vanliga frågor
Kan jag fortfarande installera UniFi med BigBearCasaOS?
Äldre community-paket kan finnas, men Ubiquitis aktuella vägledning för egen drift bör vara utgångspunkten för en ny installation.
Kan UniFi OS Server köras i Docker?
Ubiquiti säger för närvarande att hela UniFi OS Server inte erbjuds som en fristående Docker-/Podman-container.
Bör jag köra UniFi i en ZimaOS-VM?
En dedikerad Linux-VM ger en tydlig värdgräns för aktuella UniFi-tjänster med egen drift.
Vilka portar måste vara öppna?
Använd Ubiquitis aktuella referens för portar som krävs och exponera endast de portar som behövs för upptäckt, adoption och hantering.
Behöver jag en controller med egen drift om jag har en UDM eller UCG?
Nej. Aktuella UniFi Cloud Gateways innehåller redan UniFi Networks kontrollplan.
