4.0 KiB
Aufbau des dedizierten Servers
Der ARM64-Server discovery.ease-technologies.de betreibt die WebUI, den MCP-Endpunkt, die Geräte-API und PostgreSQL. Unter /opt/rust-discovery liegen Deploymentkonfiguration, WebUI und der private Betriebszustand. Der externe Zugriff verteilt sich auf zwei TLS-Eingänge.
| Öffentlicher Zugang | Weiterleitung auf dem Server | Zweck |
|---|---|---|
| TCP 443 | Socket-Proxy an 127.0.0.1:18444 |
Gerätegateway. Registrierte Geräte authentisieren sich mit ihrem Clientzertifikat. |
| HTTPS 8443 | Nginx an 127.0.0.1:18445 |
Öffentliche WebUI, lokale Anmeldung und MCP. |
| HTTPS 8443, Installer- und Bootstraprouten | Nginx an 127.0.0.1:18444 |
Download der Installer und der freigegebenen Bootstrapdateien mit öffentlich vertrauenswürdiger TLS-Kette. |
Die private Entwicklungs-API lauscht auf 127.0.0.1:18443. PostgreSQL ist nur im internen Netz erreichbar. Der HTTPS-Proxy prüft den Namen und die Zertifikatskette des jeweiligen Upstreams. Die öffentliche API verwendet das Produktionsprofil. Gerätesocket · HTTPS-Ingress · Öffentliche API
Laufenden Stand aktualisieren
Der Deploymentrunner liest die tatsächlichen Compose-Dateien aus den Labels der laufenden Container. Er übernimmt Volumes und Richtlinien, wendet die Migrationen an, vergleicht deren Prüfsummen mit der gewählten Git-Revision und aktiviert API, Gateway und die vorhandene öffentliche API. Abschließend prüft er die Binärhashes, die TLS-Healthchecks und die ausgelieferte Startseite. Für einen reinen Frontendwechsel genügt der WebUI-Modus. Build- und Deploymentbefehle
Signierte Zeitbelege
Der Hostdienst rmm-time-broker.service stellt dem Gateway signierte Zeitbelege aus. Die Zeitquelle prüft die konfigurierte Chrony-Prozessgeneration. Ein Wechsel des Prozesses kann eine erneute Prüfung dieser Bindung erfordern. Das Gateway erreicht den Broker über den Unix-Socket /run/rmm-time-source/broker.sock. Das Compose-Overlay bindet sein Verzeichnis schreibgeschützt ein. Gateway-Mount · Zeitbroker
Bei fehlendem Zeitbeleg auf dem Server zuerst Zustand und Startzeit beider Dienste sowie den Sockettyp lesen. Diese Abfrage benötigt keinen Zugriff auf private Schlüssel.
systemctl show rmm-time-broker.service chrony.service -p ActiveState -p MainPID -p ExecMainStartTimestamp
stat -c '%F %a %U:%G %n' /run/rmm-time-source/broker.sock
Auf dem Windows-Testgerät ist die automatische Wiederherstellung der Bereitschaft nach einem Gatewaywechsel dokumentiert. Gerätebeobachtung
Öffentlichen Zugang einrichten
Auf einem bereits mit interner API, Gateway und öffentlicher TLS-Kette eingerichteten Entwicklungsserver richtet tools/dev_public_access.py die öffentliche Verwaltung ein. prepare provisioniert das lokale Bootstrapkonto, activate startet die zusätzliche API und kontrolliert deren Anmeldemodi. publish prüft die Nginx-Konfiguration und aktiviert den Ingress. prepare im Checkout mit dem bestehenden privaten credentials/ ausführen. Die Zugangsdaten verbleiben beim Betreiber.
python3 tools/dev_public_access.py prepare
python3 tools/dev_public_access.py activate
python3 tools/dev_public_access.py publish
Der Server liest Benutzerkonten aus der geschützt eingebundenen devstate/public-auth/users.json. Änderungen dieser Kontokonfiguration werden beim Neustart von öffentlicher API und Gateway geladen. Das öffentliche Installerzertifikat und die internen Zertifikate haben getrennte Erneuerungsdienste. Ihre Zeitsteuerung ist in den Unit-Dateien hinterlegt. Öffentliche TLS-Erneuerung · Interne TLS-Erneuerung · Zugänge