BamBuddy mit Docker Compose auf ZimaOS installieren

BamBuddy läuft unter ZimaOS über Docker Compose, obwohl es kein integriertes App-Store-Paket ist. Verwenden Sie das vorgefertigte Upstream-Image, speichern Sie die Ordner /app/data und /app/logs dauerhaft und behalten Sie das Linux-Host-Netzwerk bei, wenn Sie eine automatische Erkennung von Bambu-Druckern wünschen.

Der ursprüngliche Thread hatte keine Lösung, aber BamBuddy stellt inzwischen einen gepflegten Docker-Workflow bereit. ZimaOS unterstützt benutzerdefinierte Compose-Apps. Daher müssen Sie das Host-Betriebssystem nicht ändern und BamBuddy nicht aus dem Quellcode erstellen, außer Sie möchten es weiterentwickeln.

Das Upstream-Docker-Image verwenden

Die aktuelle Docker-Anleitung für BamBuddy empfiehlt Docker als einfachste Bereitstellungsmethode.

Zentrale ZimaOS-Compose-Einstellungen

services:
  bambuddy:
    image: ghcr.io/maziggy/bambuddy:latest
    container_name: bambuddy
    restart: unless-stopped
    network_mode: host
    environment:
      - TZ=YOUR_TIMEZONE
      - PUID=1000
      - PGID=1000
    volumes:
      - /DATA/AppData/bambuddy/data:/app/data
      - /DATA/AppData/bambuddy/logs:/app/logs

Öffnen Sie nach dem Start http://ZIMA-IP:8000.

Warum das Host-Netzwerk wichtig ist

BamBuddy verwendet die Erkennung im lokalen Netzwerk für Bambu-Drucker. Das Upstream-Compose verwendet unter Linux network_mode: host, da das erwartete SSDP-Erkennungssignal über ein normales Bridge-Netzwerk nicht ebenso zuverlässig empfangen wird.

Sie können den Drucker manuell hinzufügen

Wenn die Erkennung den Drucker nicht findet, fügen Sie ihn über seine LAN-IP hinzu. Stellen Sie sicher, dass sich Drucker und ZimaOS in Netzwerken befinden, die miteinander kommunizieren können, und dass der erforderliche lokale/Entwicklermodus des Druckers aktiviert ist.

Daten vor der Aktualisierung dauerhaft speichern

BamBuddy speichert seine Datenbank, Archive und Betriebsdaten im konfigurierten Datenverzeichnis. Bewahren Sie diese Pfade außerhalb der vergänglichen Container-Ebene auf.

Die Docker-Bereitstellung aktualisieren

docker compose pull
docker compose up -d

Das Upstream-Projekt hat sicherheitsrelevante Aktualisierungen veröffentlicht. Halten Sie das Image daher aktuell und erstellen Sie vor größeren Änderungen eine Anwendungssicherung.

Port 8000 nicht direkt dem Internet aussetzen

Betreiben Sie BamBuddy im LAN oder hinter authentifiziertem HTTPS bzw. einem privaten Fernzugriff. Schnittstellen zur Druckerverwaltung sollten nicht unbedacht per Portweiterleitung erreichbar gemacht werden.

Die Docker-Anleitung für benutzerdefinierte Apps beschreibt das allgemeine Modell für benutzerdefinierte Apps.

Den Container vor dem Hinzufügen eines Druckers überprüfen

docker ps | grep bambuddy
docker logs --tail 100 bambuddy

Bestätigen Sie, dass der Webdienst sauber auf Port 8000 startet, bevor Sie die Druckererkennung untersuchen. Wenn sich das Dashboard selbst nicht öffnen lässt, liegt das Problem noch nicht bei der Druckervernetzung.

Die BamBuddy-Datenbank vor Aktualisierungen sichern

Das Upstream-Projekt verfügt über eine eigene Sicherungsfunktion. Verwenden Sie sie vor größeren Image-Änderungen und bewahren Sie zusätzlich eine Kopie des dauerhaften Datenverzeichnisses auf. Ein Container-Image kann jederzeit erneut heruntergeladen werden; Ihr Druckverlauf und Ihre lokale Datenbank jedoch nicht.

Das Host-Netzwerk erweitert die Netzwerkreichweite des Containers

Da der Host-Modus den Netzwerk-Namensraum von ZimaOS gemeinsam verwendet, sollten Sie die Ports der App überprüfen und die Software aktuell halten. Der Host-Modus ist hier wegen der Druckererkennung gerechtfertigt, bietet jedoch weniger Netzwerkisolierung als ein gewöhnliches Bridge-Netzwerk.

Eine stabile Drucker-IP verwenden

Reservieren Sie die IP-Adresse des Druckers nach Möglichkeit in Ihrem Router. Selbst wenn die automatische Erkennung heute funktioniert, erleichtert eine stabile Adresse die Fehlerbehebung bei Kamera, MQTT und manueller Wiederverbindung nach Neustarts des Routers oder Druckers erheblich.

FAQ

Ist BamBuddy im ZimaOS-App-Store verfügbar?

Der ursprüngliche Nutzer konnte kein eigenes Paket finden; benutzerdefiniertes Docker Compose ist der unkomplizierte Weg.

Welchen Port verwendet BamBuddy?

Die standardmäßige Weboberfläche verwendet Port 8000.

Warum das Host-Netzwerk verwenden?

Es ermöglicht die von BamBuddy erwartete Erkennung in Linux-Containern und die entsprechenden Drucker-Netzwerkfunktionen.

Kann ich es aus dem Quellcode erstellen?

Ja, aber das Upstream-Projekt empfiehlt für normale Bereitstellungen das vorgefertigte Image.