Eigene BELABOX Remote UIselbst hosten und einrichten

Inhalt der Anleitung

• 1. Selbst gehostet oder offizieller Zugang?
• 2. Voraussetzungen
• 3. Aufbau und Ports
• 4. VPS installieren
• 5. BELABOX verbinden
• 6. Remote UI verwenden
• 7. Mehrere BELABOXen
• 8. HTTPS und WSS einrichten
• 9. Sicherheit prüfen
• 10. Fehlerbehebung
• 11. Entfernen und Backup
• 12. Häufige Fragen

1. Selbst gehostet oder offizieller Zugang?

2. Voraussetzungen

• VPS mit Ubuntu 24.04 oder Ubuntu 26.04.
• Root- oder sudo-Zugriff auf VPS und BELABOX.
• Terminal- beziehungsweise SSH-Zugriff auf die BELABOX.
• Auf dem VPS TCP-Port 80 oder der vom Skript gewählte Ersatzport sowie TCP 9090 für Chisel.
• Für HTTPS: eine eigene Domain oder Subdomain mit DNS-A-Eintrag auf den VPS sowie von außen erreichbare TCP-Ports 80 und 443.
• SSH-Management-Port des VPS nur für vertrauenswürdige Administratoren erreichbar.
• Ein starkes Passwort für die BELABOX-Weboberfläche.

Bestehende Nginx- und RTMP-Konfigurationen werden berücksichtigt. Ist Port 80 belegt, sucht das Skript laut Projektdokumentation ab Port 8088 nach einem freien HTTP-Port. Mit --public-port PORT kann bewusst ein bestimmter Port vorgegeben werden.

3. Aufbau und benötigte Ports

BelaRemoteUI aktiviert UFW nicht automatisch. Wenn UFW bereits aktiv ist, ergänzt das Skript die benötigten BelaRemoteUI-Regeln. Bei Cloud-Anbietern reicht diese lokale Freigabe jedoch häufig nicht aus: Security Group, Security List oder Provider-Firewall müssen TCP 80, 443 und 9090 ebenfalls zulassen. Ohne HTTPS kann statt Port 80 auch der vom Skript ausgegebene Ersatzport gelten.

4. BelaRemoteUI auf dem VPS installieren

Wechsle zuerst in eine Root-Shell. Die folgenden VPS-Befehle benötigen dadurch kein wiederholtes sudo:

sudo -i

Benötigte Download-Werkzeuge installieren

apt update && \
apt install ca-certificates curl less -y

Aktuelles Serverskript herunterladen

Die Datei wird direkt aus dem offiziellen BelaRemoteUI-Repository nach /usr/local/sbin geladen:

curl -fsSL --retry 3 https://raw.githubusercontent.com/Bittersweet1987/BelaRemoteUI/main/belabox-vps-remote-server.sh -o /usr/local/sbin/belabox-vps-remote-server && \
chown root:root /usr/local/sbin/belabox-vps-remote-server && \
chmod 0750 /usr/local/sbin/belabox-vps-remote-server

Kontrolliere das heruntergeladene Skript vor der ersten Ausführung. Beende die Ansicht mit q:

less /usr/local/sbin/belabox-vps-remote-server

Einrichtung starten

belabox-vps-remote-server

1. VPS aktualisieren und vorhandene Nginx-, Firewall- und Portbelegung dokumentieren.
2. Serverskript aus dem offiziellen Repository prüfen und ausführen.
3. Einen eindeutigen Profilnamen wie rucksack, kamera1 oder eventbox vergeben.
4. Remote-URL, Widget/API-URL, WebSocket-URL, Tunnel-Port, Tunnel-Token und ausgegebenen BELABOX-Befehl sicher speichern.
5. Bei mehreren Geräten auf Nachfrage weitere Profile anlegen.

5. BELABOX mit dem VPS verbinden

1. Den vollständigen, vom VPS-Skript ausgegebenen Client-Befehl der richtigen BELABOX zuordnen.
2. Den Befehl im Terminal der BELABOX ausführen. Token oder geheime URL niemals in Screenshots, Stream oder Chat zeigen.
3. Der ausgegebene Befehl installiert bei Bedarf zunächst curl und richtet danach lokalen Proxy, Chisel-Client und dauerhafte Systemdienste ein.
4. Nach dem vorgeschlagenen Neustart kontrollieren, ob Tunnel und Proxy automatisch gestartet wurden.

systemctl --no-pager --full status belabox-vps-remote-ui-tunnel.service belabox-vps-remote-ui-proxy.service

6. Remote UI unterwegs verwenden

Für die normale Browsernutzung wird die lange, feste Remote-URL aus der VPS-Ausgabe geöffnet. Der geheime Pfad setzt zunächst ein Cookie und leitet anschließend auf / weiter. Diese Weiterleitung ist laut Projektdokumentation beabsichtigt, damit CSS, JavaScript und WebSockets wie bei belabox.local funktionieren.

Widget-, API- und WebSocket-Adressen verwenden einen Token. Diese URLs sind Zugangsdaten und gehören weder in öffentliche OBS-Konfigurationen noch in Support-Screenshots.

7. Mehrere BELABOXen verwalten

Jedes Profil erhält einen eigenen Link, Token und internen VPS-Port. Vorhandene Profile zeigt dieser Verwaltungsbefehl:

belabox-remote-vps-status

Ein neuer geheimer Link für ein vorhandenes Profil wird so erzeugt; das Skript fragt anschließend nach dem Profilnamen:

belabox-vps-remote-server --regenerate-link

Nach einer vermuteten Veröffentlichung von URL oder Token sollte der Zugang erneuert und anschließend auf allen verwendeten Geräten aktualisiert werden.

8. BelaRemoteUI mit HTTPS und WSS absichern

Seit dem GitHub-Commit vom 29. August 2026 besitzt BelaRemoteUI eine eigene optionale HTTPS-Funktion. Das Serverskript installiert Certbot, fordert ein Let's-Encrypt-Zertifikat an, richtet die automatische Verlängerung ein und ändert die ausgegebenen Adressen auf https:// beziehungsweise wss://.

1. Subdomain im DNS anlegen

Lege beim Anbieter deiner Domain einen DNS-A-Eintrag an. Als Ziel wird die öffentliche IPv4-Adresse des VPS eingetragen. Ersetze die Beispielwerte durch deine eigenen Daten:

Typ:  A
Name: bela
Ziel: DEINE_VPS_IPV4

Nach der DNS-Änderung kann es je nach Anbieter etwas dauern, bis der Eintrag überall verfügbar ist. Kontrolliere die Auflösung auf dem VPS:

getent ahostsv4 bela.example.de

2. Ports in beiden Firewalls freigeben

Für den kompletten Aufbau müssen die Regeln sowohl auf dem VPS als auch in der Firewall des Cloud-Anbieters stimmen:

• 80/TCP für die Let's-Encrypt-Prüfung und spätere HTTPS-Weiterleitung.
• 443/TCP für die verschlüsselte Webseite und sichere WebSockets.
• 9090/TCP für den ausgehenden Chisel-Tunnel der BELABOX.

3. Öffentlichen BelaRemoteUI-Port auf 80 setzen

Die eingebaute HTTPS-Einrichtung arbeitet derzeit nur, wenn BelaRemoteUI öffentlich auf Port 80 eingerichtet ist. Wurde bei der ersten Installation automatisch ein Ersatzport wie 8088 gewählt, führe das aktuelle Serverskript erneut mit der gewünschten Subdomain und Port 80 aus:

belabox-vps-remote-server --domain bela.example.de --public-port 80 --no-reboot

4. HTTPS mit Let's Encrypt einschalten

Sobald der DNS-A-Eintrag stimmt und Port 80 von außen erreichbar ist, starte die neue HTTPS-Funktion:

belabox-vps-remote-server --setup-https --domain bela.example.de

Optional kannst du mit --email name@example.de eine E-Mail-Adresse für Zertifikatshinweise übergeben. Ohne --domain fragt das Skript interaktiv nach der Domain.

5. Ergebnis kontrollieren

nginx -t && \
systemctl is-active nginx && \
ss -ltnp | grep -E ':80 |:443 |:9090 ' && \
certbot certificates && \
belabox-remote-vps-status

Öffne danach ausschließlich die neu ausgegebene Adresse mit https://. In den Browser-Entwicklerwerkzeugen sollte die WebSocket-Verbindung wss:// verwenden. Teste Anmeldung, Statuswerte und Steuerfunktionen anschließend einmal über Mobilfunk statt über das Heimnetz.

6. HTTPS bei Bedarf wieder deaktivieren

belabox-vps-remote-server --disable-https

Nach Projektdokumentation bleiben vorhandene Zertifikate dabei erhalten und können bei einer erneuten Einrichtung wiederverwendet werden.

Aktuelle HTTPS-Dokumentation des Projekts auf GitHub öffnen

9. Sicherheit nach der Einrichtung prüfen

• Remote-Link, Token und URLs wie Passwörter behandeln.
• Für jedes BELABOX-Profil einen getrennten Zugang verwenden.
• Die BELABOX-Weboberfläche zusätzlich mit einem starken, einzigartigen Passwort schützen.
• VPS, Nginx, Chisel und Betriebssystem regelmäßig aktualisieren.
• SSH-Zugriff beschränken und Protokolle auf unbekannte Anfragen kontrollieren.
• Vor Änderungen Sicherungen von Nginx- und Firewall-Konfiguration anlegen.

IRL4YOU Secure-Cookie-Fix verwenden

Der Fix ist kein Bestandteil des BelaRemoteUI-Projekts. Er arbeitet ausschließlich mit /etc/nginx/conf.d/belabox-remote-ui.conf, setzt eine aktive HTTPS-Konfiguration voraus und legt vor jeder Änderung eine datierte Sicherung an. Bei einem fehlgeschlagenen Nginx-Test oder Reload wird die Sicherung automatisch wiederhergestellt.

Secure-Cookie-Fix herunterladen

Lade den Fix direkt von IRL4YOU nach /usr/local/sbin und setze sichere Eigentümer- und Dateirechte:

curl -fsSL --retry 3 https://irl4you.de/downloads/belaremoteui-secure-cookie-fix.sh -o /usr/local/sbin/irl4you-belaremoteui-secure-cookie-fix && \
chown root:root /usr/local/sbin/irl4you-belaremoteui-secure-cookie-fix && \
chmod 0750 /usr/local/sbin/irl4you-belaremoteui-secure-cookie-fix

Kontrolliere die Datei vor der Ausführung und starte sie danach separat:

less /usr/local/sbin/irl4you-belaremoteui-secure-cookie-fix

irl4you-belaremoteui-secure-cookie-fix

Danach kontrollieren, ob Nginx läuft und die Cookie-Zeilen das Attribut Secure enthalten:

nginx -t && \
systemctl is-active nginx && \
grep -n 'SameSite=Lax; Secure' /etc/nginx/conf.d/belabox-remote-ui.conf

Kontrolliere zusätzlich, dass HTTP wirklich auf HTTPS umleitet und das Zertifikat zur verwendeten Subdomain gehört:

curl -I http://bela.example.de && \
curl -I https://bela.example.de

Die erste Anfrage sollte eine Weiterleitung auf HTTPS liefern. Bei der zweiten Anfrage darf keine Zertifikatswarnung erscheinen. Teile niemals vollständige Remote-, Widget-, API- oder WebSocket-URLs in Screenshots oder Supportbeiträgen, weil sie Zugangstoken enthalten können.

10. Fehlerbehebung

Prüfe zuerst die BelaRemoteUI-Profile:

belabox-remote-vps-status

Zeige anschließend die beteiligten Dienste ohne interaktiven Pager an:

systemctl --no-pager --full status belabox-remote-ui-chisel.service nginx

11. Entfernen, Wiederherstellung und Backup

Das Repository dokumentiert getrennte Funktionen zum Löschen eines Profils, zur vollständigen VPS-Deinstallation und zum Entfernen des BELABOX-Clients. Laut Projekt werden dabei nur eigene Dateien, Dienste, Nginx-Einträge und selbst hinzugefügte Firewall-Regeln entfernt. Trotzdem sollten vorher VPS-Snapshot und Konfigurationsbackup erstellt werden.

Verwende für eine Entfernung ausschließlich die aktuell dokumentierten Befehle im Abschnitt Verwaltung des GitHub-Projekts. Prüfe Profilnamen und Zielsystem sorgfältig.

Root-Shell verlassen

Wenn Installation und Prüfungen abgeschlossen sind, wechselst du zurück zum normalen Benutzer:

exit

12. Häufige Fragen

Mehrere Kameras in einem Bild

Für die BELABOX gibt es mit der IRL4YOU BOX ein kostenloses Zusatzpaket für Bild-in-Bild mit bis zu vier Kameras. Seit Version 1.0 ist sie keine Beta mehr, die Installation geht mit einem Befehl.

Projekt, Datenschutz und weitere Anleitungen

BelaRemoteUI wird von Bittersweet1987 als Community-Projekt unter der GPLv3 bereitgestellt. IRL4YOU bindet das Projekt nicht automatisch ein und erhält keinen Zugriff auf VPS, BELABOX, Tokens oder Remote-URLs. Beim Öffnen von GitHub gelten die dortigen Datenschutzbedingungen; beim Selbstbetrieb bist du für Serverprotokolle, Zugriffsrechte und Absicherung verantwortlich.

BELABOX Remote UI Einrichtungsservice

Wir unterstützen bei VPS, Ports, Profilen, Nginx, Tunnelprüfung und einem sicheren Testablauf. Zugangsdaten, geheime Links und Tokens bleiben beim Betreiber und gehören nicht in öffentliche Support-Nachrichten.