Technische Referenz
Architektur, lokale Pfade, Ports, systemd-Dienste und sichere Diagnosebefehle für MuPiBox NG.
Diese Referenz richtet sich an Personen mit Shell-Zugang. Befehle beziehen sich auf eine reguläre NG-Installation auf DietPi/Linux und können sich zwischen Releases unterscheiden.
Architektur
Die NG besteht aus einem Go-Backend für Medien, Konfiguration und API, einer Touch-Oberfläche, einem beschränkten System-Agent für privilegierte Aktionen sowie separaten Audio-/Provider-Diensten. Der Browser-Admin nutzt dasselbe Backend. Details zu Audioausgängen: Audio.
Wichtige Adressen und Dateien
| Ort | Bedeutung |
|---|---|
http://<box-ip>:8090/admin/ | Verwaltungsoberfläche im lokalen Netz |
/srv/mupibox/music | Lokale Musiksammlung |
/var/lib/mupibox-ng/backups/ | Automatische Sicherungen vor Updates |
/etc/mupibox-ng/ | Systemweite NG-Konfigurationsdateien (versionsabhängig) |
/opt/mupibox-release/current/ | Aktuelle releasebezogene Installationsdateien (bei Release-Installationen) |
Kein Geheimnis veröffentlichen: Konfiguration und Sicherungen können Zugangsschlüssel enthalten. Dateipfade sind keine Einladung, geschützte Daten öffentlich freizugeben.
Typische systemd-Dienste
| Dienst | Aufgabe |
|---|---|
mupibox-ng | Backend/API |
mupibox-ui | Touch-Oberfläche |
mupibox-system-agent | Privilegierte Systemaufgaben |
mupibox-wireplumber | Audio-Sitzungsverwaltung |
mupibox-pipewire | PipeWire-Audiosystem |
mupibox-audio-bus | Gemeinsamer Audioausgabe-Bus |
mupibox-splash | Boot-/Startbild |
Zusatzdienste hängen von aktivierten Quellen und Installationsprofil ab. Es gibt nicht auf jedem System alle oben genannten Units.
Sichere Lese-Diagnose
systemctl --failed systemctl status mupibox-ng mupibox-ui --no-pager journalctl -u mupibox-ng -b --no-pager -n 100 journalctl -u mupibox-ui -b --no-pager -n 100 systemd-analyze blame
Erst den Status sichern und anschließend Änderungen durchführen. Für die meisten Fälle reichen die Browser-Protokolle. Der Admin erlaubt außerdem Bootanalyse.
Updates, Rollback und Daten
NG-Updates nutzen einen Bestätigungs-/Rollback-Mechanismus. Einstellungen und Medien sind vom Releasecode getrennt. Änderungen am Dateisystem sollten nicht an unbekannten Release-Verzeichnissen erfolgen. Vor Eingriffen ein Backup anlegen. Die Wiederherstellung ist unter Backup-Checkliste erläutert.
Sicherheit und Netzwerk
Standard-Admin: Port 8090 im lokalen Netz. Externe Zugriffe nicht durch einfaches Router-Portforwarding freigeben; stattdessen die vorgesehenen Sicherheits- und App-Funktionen nutzen. Passwörter und Token niemals in Logs oder Supportbeiträge kopieren.