LeTTo Doc

Setup-Service: Proxy-Konfiguration

Proxy Konfiguration

Aufruf: Button Proxy Konfiguration in der Zeile „Proxy“ im Tab Services.

Der Reverse-Proxy letto-proxy (nginx) nimmt alle Anfragen an https://<server>/… an und leitet sie an die Container weiter. Für jeden Service, jede Schule und jedes Plugin gibt es eine Konfigurationsdatei in /opt/letto/docker/proxy. Auf dieser Seite werden diese Dateien verwaltet. Änderungen wirken erst nach Proxy neu starten.

Buttons oben

Element Wirkung
Zurück in der Kopfzeile: zurück zur Hauptseite
Aktualisieren in der Kopfzeile: Liste neu laden
Proxy neu starten prüft zuerst die Konfiguration, startet den Proxy neu und wartet, bis er wieder funktioniert (siehe unten); die Ausgabe erscheint in der Befehlsausgabe
LeTTo-Proxy Zustand des Proxy; in Klammern die Anzahl der Konfigurationsdateien

Fehlerhafte Konfigurationsdateien

Eine fehlerhafte Datei würde nginx am Start hindern – damit wären alle Schulen und das Setup selbst nicht mehr über https://<server>/… erreichbar. Deshalb gilt bei jedem Start und Neustart des Proxy:

Gibt es deaktivierte Dateien, zeigt die Seite die Karte Deaktivierte Konfigurationsdateien:

Element Wirkung
Datei, Deaktiviert am Name der umbenannten Datei und Zeitpunkt
Aktivieren und neu starten entfernt die Endung .fehler und startet den Proxy neu (mit Rückfrage). Ist die Datei noch fehlerhaft, wird sie dabei wieder deaktiviert

Vorgehen: die Datei ….conf.fehler am Server bzw. im Explorer korrigieren, dann Aktivieren und neu starten. Die Karte Letzte Einträge der Konfigurationsprüfung zeigt die letzten Zeilen von proxy-config.log. Nicht umbenannt wird https.conf (Zertifikat) – ein Fehler dort oder in default.conf wird nur gemeldet.

Proxy-Konfigurationen

Die aktiven Dateien in /opt/letto/docker/proxy, z. B. login.conf, config.conf (Setup), letto<schule>.conf, plugin<name>.conf, https.conf.

Button Wirkung
Bearbeiten öffnet die Datei im Datei-Editor
Löschen löscht die Datei (mit Rückfrage); nach dem Neustart des Proxy ist der Service nicht mehr erreichbar

Zusätzliche Server-Konfigurationen

Eigene Server-Blöcke in /opt/letto/docker/proxy/servers, z. B. für eine zusätzliche Domain. Erstelle Textdatei legt eine leere Datei mit dem Namen aus dem Feld daneben (Endung .conf) an; vorhandene Dateien haben Bearbeiten und Löschen.

Konfigurations-Vorlagen

Die Vorlagen des Setup-Service in /opt/letto/docker/proxy/templates, z. B. alternativdomain.conf, lettoschool.conf, serverdns.conf.

Button Wirkung
Bearbeiten Vorlage im Editor ansehen oder ändern
In den Proxy kopieren kopiert die Vorlage nach einer Rückfrage in das Proxy-Verzeichnis; eine Datei gleichen Namens wird dabei überschrieben

siehe auch

Zurück zur Übersicht: Setup-Service