Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- it:unificontrollerinstallieren [2024/11/19 10:59] – [Docker / Container Manager Installation] 192.168.2.44
+++ it:unificontrollerinstallieren [2024/11/19 11:30] (aktuell) – [Geräte-Registrierung] 192.168.2.44
@@ Zeile 37: / Zeile 37: @@
 {{https://blog.andreas-schreiner.de/wp-content/uploads/img-unifi-controller-installation-auf-einer-synology-nas-06.jpg?nolink&800|Docker Image}}
-Im Reiter //Network// wähle ich die Option //Use the same network as Docker Host// aus. Möchte man die Ports des UniFi Controllers auf alternative Ports ändern (z.B. die Web GUI), wählt man in diesem Fenster statt der Checkbox das bridge Netzwerk aus und konfiguriert das Mapping der Local Ports und der Container Ports für die UniFi Ports, die weiter unten im Beitrag genannt sind.
+Im Reiter //Network// wähle ich die Option //Use the same network as Docker Host// aus. Möchte man die Ports des UniFi Controllers auf alternative Ports ändern (z.B. die Web GUI), wählt man in diesem Fenster statt der Checkbox das bridge Netzwerk aus und konfiguriert das Mapping der Local Ports und der Container Ports für die UniFi Ports, die weiter unten im Beitrag genannt sind.\\
+**Achtung: das geht nicht! Netzwerk muss auf Host stehen damit die Geräte den Server finden.\\
+Die Ports können in den Umgebungsvariablen der Containers angepasst werden. Das ist auch nötig damit der Container selbst weiß welche Ports er den Geräten für eine Weiterleitung von http Port 8080 mitteilen muss. Wenn das falsch gemacht wurde siehe unten Wechsel der Netzwerkanbindung des Containers** \\
 {{https://blog.andreas-schreiner.de/wp-content/uploads/img-unifi-controller-installation-auf-einer-synology-nas-07.jpg?nolink&800|Docker Image}}
@@ Zeile 52: / Zeile 53: @@
-==== Sonstige Anpassungen ====
+====== Sonstige Anpassungen ======
 **Ports**
@@ Zeile 58: / Zeile 59: @@
 Falls auf der Disk Station die Firewall aktiv ist, müssen im aktiven Profil folgende Ports freigeschaltet werden:
-* TCP/8443: Web GUI
+  * TCP/8443: Web GUI
+  * TCP/8080: Device/Controller Communication
+  * TCP/8880: HTTP Portal Redirection
+  * TCP/8843: HTTPS Portal Redirection
+  * TCP/6789: UniFi Mobile Speed Test
+  * UDP/3478: STUN (optional, für UniFi VoIP Telefone)
+  * UDP/10001: Device Discovery
+  * UDP/1900: Layer 2 Network Discovery
+  * UDP/5514: Remote Syslog Capture (optional)
-* TCP/8080: Device/Controller Communication
+Zudem dürfen die Ports natürlich nicht anderweitig bereits in Verwendung sein (z.B. durch andere Synology Packages oder andere Docker Container).
-* TCP/8880: HTTP Portal Redirection * TCP/8843: HTTPS Portal Redirection
+Prädestiniert für Konflikte sind besonders die Ports 8080 und 8443, die werden als alternative HTTP/HTTPS Ports auch gerne durch andere Produkte verwendet.
-* TCP/6789: UniFi Mobile Speed Test * UDP/3478: STUN (optional, für UniFi VoIP Telefone)
+Sollte der Container nicht starten oder unerwartet sofort wieder stoppen, ist dies das häufigste Problem.
-* UDP/10001: Device Discovery
+Da UniFi Controller nicht von den Geräten gefunden werden kann wenn als Netzwerktyp Bridge ausgewählt wird lässt sich auch keine Veränderung der Portzuordnung in Docker erreichen. \\ Die Ports können aber in den Umgebungsvariablen des Containers angepasst werden wenn nötig:
-* UDP/1900: Layer 2 Network Discovery
+Aus der Doku von Jacob Alberty:
-* UDP/5514: Remote Syslog Capture (optional) Z
+=== Environment Variables: ===
-udem dürfen die Ports natürlich nicht anderweitig bereits in Verwendung sein (z.B. durch andere Synology Packages oder andere Docker Container).
+You can pass in environment variables using the ''-e''  option when you invoke ''docker run…''  See the ''TZ''  in the example above. Other environment variables:
-Prädestiniert für Konflikte sind besonders die Ports 8080 und 8443, die werden als alternative HTTP/HTTPS Ports auch gerne durch andere Produkte verwendet.
+  * ''UNIFI_HTTP_PORT''  This is the HTTP port used by the Web interface. Browsers will be redirected to the ''UNIFI_HTTPS_PORT''. **Default: 8080**
+  * ''UNIFI_HTTPS_PORT''  This is the HTTPS port used by the Web interface. **Default: 8443**
+  * ''PORTAL_HTTP_PORT''  Port used for HTTP portal redirection. **Default: 80**
+  * ''PORTAL_HTTPS_PORT''  Port used for HTTPS portal redirection. **Default: 8843**
+Es ist aber wichtig dass Port 8080 bleibt, da die Geräte sich automatisch dort melden!
+Aus dem Grunde habe ich alle Ports gleich gelassen. \\ Es gab damit aber einen Port Konflikt mit Synology Contacts / CardDAV mit dem es möglich ist Kontakte z.B. mit Handys im Kommunenetz zu synchronisieren. \\ Daher habe ich CardDAV auf Port 8444 geändert, das muss dann natürlich auch auf allen Geräten zum Sync so angepasst werden. \\ (Mache aktuell nur ich (Gunter) um die Daten von dem Lineage OS Handy zu sichern)
+Nach Änderung des Ports für CardDAV muss entweder die Diskstation oder zumindest Contacts, Calendar und ggf. Webstation neu gestartet werden.
-Sollte der Container nicht starten oder unerwartet sofort wieder stoppen, ist dies das häufigste Problem.
-====   Geräte-Registrierung   ====
+===== Geräte-Registrierung =====
 Im Normalfall läuft der Controller nach der Einrichtung zwar problemlos, man wird aber feststellen, dass sich keine Geräte am Controller melden. Grund hierfür ist, dass sich die Geräte werksseitig bei der URL // [[http://unifi:8080/inform//|http://unifi:8080/inform//]] melden, die NAS aber in den seltensten Fällen den Hostnamen //UNIFI// hat. //
@@ Zeile 95: / Zeile 111: @@
 * A-/AAA-Record //UNIFI// mit der IPv4-/IPv6-Adresse der Synology NAS Ist der Hostname //UNIFI// im Netzwerk verfügbar und auflösbar klappt’s auch mit dem automatischen Deployment von UniFi Geräten ohne manuelle Anpassungen.
+Bei uns habe ich ein A Record angelegt.
+===== Reset der Geräte damit sie in einem neuen Netzwerk eingesetzt werden können =====
+Gebrauchte Geräte müssen zurückgesetzt werden damit sie sich im Unifi Controller finden und adoptieren lassen.
@@ Zeile 147: / Zeile 169: @@
 For your Unifi devices to "find" the Unifi Controller running in Docker, you //MUST// override the Inform Host IP with the address of the Docker host computer. (By default, the Docker container usually gets the internal address 172.17.x.x while Unifi devices connect to the (external) address of the Docker host.) To do this:
-   * Find **Settings -> System -> Other Configuration -> Override Inform Host:**  in the Unifi Controller web GUI. (It's near the bottom of that page.)
+   * Find **Settings → System → Other Configuration → Override Inform Host:**  in the Unifi Controller web GUI. (It's near the bottom of that page.)
   * Check the "Enable" box, and enter the IP address of the Docker host machine.
   * Save settings in Unifi Controller
-  * Restart UniFi-in-Docker container with ''docker stop ...''  and ''docker run ...''  commands.
+  * Restart UniFi-in-Docker container with ''docker stop …''  and ''docker run …''  commands.
 See [[https://registry.hub.docker.com/r/jacobalberty/unifi/Side-Projects.md#other-techniques-for-adoption|Side Projects]] for other techniques to get Unifi devices to adopt your new Unifi Controller.
-—- Quellen: \\ [[https://help.ui.com/hc/en-us/articles/218506997-UniFi-Ports-Used|https://help.ui.com/]] \\
+==== Ändern der Netzwerkanbindung eines Docker Containers in Synology ====
+Eine Änderung der Netzwerkverbindung von Bridge auf Host ist in der grafischen Oberfläche zumindest bei DSM 6.2. nicht möglich. \\ Es muss dazu nach Stoppen des Containers ein neuer Container erzeugt werden. Dieser behält die Daten des alten wenn der selbe Ordner wieder gemountet wird. \\ Vorher ist es sinnvoll ein Backup zu erstellen, wie bei Update beschrieben.
+==== Komplette Neuinstallation ====
+Wenn ALLES gelöscht werden soll und komplett neu installiert werden soll sollte auch der gemountete Ordner gelöscht werden. \\ **Wichtig ist dass die Mount Ordner immer in der Docker Oberfläche erstellt werden!** \\ **Sonst sind die Rechte möglicherweise so gesetzt dass nur der Benutzer der den Ordner erstellt hat zugreifen kann.**
+**Damit ist der Container nicht funktionsfähig weil er nichts auf die Platte schreiben kann.**—- Quellen: \\ [[https://help.ui.com/hc/en-us/articles/218506997-UniFi-Ports-Used|https://help.ui.com/]] \\
 [[https://registry.hub.docker.com/r/jacobalberty/unifi/|https://registry.hub.docker.com/r/jacobalberty/unifi/]] //'' //