BamBuddy körs på ZimaOS via Docker Compose även om det inte är ett inbyggt App Store-paket. Använd den förbyggda uppströmsavbildningen, spara mapparna /app/data och /app/logs permanent och behåll Linux-värdnätverk om du vill ha automatisk upptäckt av Bambu-skrivare.
Den ursprungliga tråden hade ingen lösning, men BamBuddy publicerar nu ett underhållet Docker-arbetsflöde. ZimaOS stöder anpassade Compose-appar, så du behöver inte ändra värdoperativsystemet eller bygga BamBuddy från källkod om du inte vill utveckla det.
Använd den uppströmsbaserade Docker-avbildningen
Den aktuella Docker-guiden för BamBuddy rekommenderar Docker som den enklaste distributionsmetoden.
Viktiga Compose-inställningar för ZimaOS
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
Öppna http://ZIMA-IP:8000 efter starten.
Varför värdnätverk är viktigt
BamBuddy använder upptäckt i det lokala nätverket för Bambu-skrivare. Den uppströmsbaserade Compose-konfigurationen använder network_mode: host på Linux eftersom normalt bryggnätverk inte tar emot den förväntade SSDP-upptäcktstrafiken lika tillförlitligt.
Du kan lägga till skrivaren manuellt
Om upptäckten inte hittar skrivaren kan du lägga till den via dess LAN-IP-adress. Se till att skrivaren och ZimaOS finns i nätverk som kan nå varandra och att skrivarens nödvändiga lokala utvecklarläge är aktiverat.
Spara data permanent före uppdatering
BamBuddy lagrar sin databas, sina arkiv och sina driftsdata i den konfigurerade datakatalogen. Behåll dessa sökvägar utanför det tillfälliga containerlagret.
Uppdatera Docker-distributionen
docker compose pull
docker compose up -dDet uppströmsbaserade projektet har släppt säkerhetsrelaterade uppdateringar, så håll avbildningen aktuell och säkerhetskopiera appen före större ändringar.
Exponera inte port 8000 direkt mot internet
Håll BamBuddy i det lokala nätverket eller bakom autentiserad HTTPS-/privat fjärråtkomst. Gränssnitt för skrivarhantering bör inte vidarebefordras till internet utan eftertanke.
Den anpassade Docker-guiden beskriver den allmänna modellen för anpassade appar.
Verifiera containern innan du lägger till en skrivare
docker ps | grep bambuddy
docker logs --tail 100 bambuddyBekräfta att webbtjänsten startar utan problem på port 8000 innan du felsöker skrivarupptäckten. Om själva instrumentpanelen inte öppnas är skrivarens nätverk ännu inte problemet.
Säkerhetskopiera BamBuddys databas före uppdateringar
Det uppströmsbaserade projektet har en egen säkerhetskopieringsfunktion. Använd den före större ändringar av avbildningen och spara dessutom en kopia av den permanenta datakatalogen. En containeravbildning kan alltid hämtas igen; din utskriftshistorik och lokala databas kan inte återskapas på samma sätt.
Värdnätverk utökar containerns nätverksåtkomst
Eftersom värdläget delar ZimaOS nätverksnamnrymd bör du granska appens portar och hålla programvaran uppdaterad. Värdläget motiveras här av skrivarupptäckten, men ger mindre nätverksisolering än ett vanligt bryggnätverk.
Använd en stabil skrivar-IP
Reservera skrivarens IP-adress i routern när det är möjligt. Även om automatisk upptäckt fungerar idag gör en stabil adress felsökning av kamera, MQTT och manuell återanslutning mycket enklare efter omstarter av routern eller skrivaren.
Vanliga frågor
Finns BamBuddy i ZimaOS App Store?
Den ursprungliga användaren kunde inte hitta något särskilt paket; anpassad Docker Compose är den enklaste vägen.
Vilken port använder BamBuddy?
Det vanliga webbgränssnittet använder port 8000.
Varför använda värdnätverk?
Det möjliggör Linux-baserad containerupptäckt och de nätverksfunktioner för skrivare som BamBuddy förväntar sig.
Kan jag bygga det från källkod?
Ja, men det uppströmsbaserade projektet rekommenderar den förbyggda avbildningen för vanliga distributioner.
