BamBuddy draait op ZimaOS via Docker Compose, ook al is het geen ingebouwd App Store-pakket. Gebruik de vooraf gebouwde image van het upstreamproject, maak de mappen /app/data en /app/logs persistent en behoud Linux-hostnetwerken als je automatische detectie van Bambu-printers wilt.
De oorspronkelijke thread had geen oplossing, maar BamBuddy publiceert nu een onderhouden Docker-workflow. ZimaOS ondersteunt aangepaste Compose-apps, dus je hoeft het hostbesturingssysteem niet aan te passen of BamBuddy vanuit de broncode te bouwen, tenzij je eraan wilt ontwikkelen.
Gebruik de upstream-Dockerimage
De huidige Docker-handleiding van BamBuddy raadt Docker aan als de eenvoudigste implementatiemethode.
Belangrijke ZimaOS Compose-instellingen
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
Open na het opstarten http://ZIMA-IP:8000.
Waarom hostnetwerken belangrijk zijn
BamBuddy gebruikt detectie via het lokale netwerk voor Bambu-printers. De upstream-Compose-configuratie gebruikt op Linux network_mode: host, omdat normale bridgenetwerken het verwachte SSDP-detectieverkeer minder betrouwbaar ontvangen.
Je kunt de printer handmatig toevoegen
Als de detectie de printer niet vindt, voeg je deze toe via het LAN-IP-adres. Zorg ervoor dat de printer en ZimaOS zich op netwerken bevinden die elkaar kunnen bereiken en dat de vereiste lokale ontwikkelaarsmodus van de printer is ingeschakeld.
Maak een back-up van gegevens vóór het bijwerken
BamBuddy slaat de database, archieven en operationele gegevens op in de geconfigureerde gegevensmap. Bewaar deze paden buiten de tijdelijke containerlaag.
De Docker-implementatie bijwerken
docker compose pull
docker compose up -dHet upstreamproject heeft beveiligingsgerelateerde updates uitgebracht. Houd de image daarom actueel en maak vóór grote wijzigingen een back-up van de applicatie.
Stel poort 8000 niet rechtstreeks bloot aan internet
Houd BamBuddy op het LAN of achter geauthenticeerde HTTPS- of private externe toegang. Interfaces voor printerbeheer mogen niet zomaar via port forwarding worden opengesteld.
De Docker-handleiding voor aangepaste apps beschrijft het algemene model voor aangepaste apps.
Controleer de container voordat je een printer toevoegt
docker ps | grep bambuddy
docker logs --tail 100 bambuddyControleer of de webservice correct opstart op poort 8000 voordat je problemen met printerdetectie onderzoekt. Als het dashboard zelf niet opent, ligt het probleem nog niet bij de printernetwerken.
Maak vóór updates een back-up van de BamBuddy-database
Het upstreamproject bevat een eigen back-upfunctie. Gebruik deze vóór grote wijzigingen aan de image en bewaar ook een kopie van de persistente gegevensmap. Een containerimage kan altijd opnieuw worden opgehaald; je printhistorie en lokale database niet.
Hostnetwerken vergroten het netwerkbereik van de container
Omdat de hostmodus de netwerknaamruimte van ZimaOS deelt, moet je de poorten van de app controleren en de software bijgewerkt houden. De hostmodus is hier gerechtvaardigd vanwege printerdetectie, maar biedt minder netwerkisolatie dan een gewoon bridgenetwerk.
Gebruik een stabiel printer-IP-adres
Reserveer het IP-adres van de printer indien mogelijk in je router. Zelfs als automatische detectie vandaag werkt, maakt een stabiel adres het oplossen van problemen met de camera, MQTT en handmatig opnieuw verbinden na herstarts van de router of printer veel eenvoudiger.
Veelgestelde vragen
Staat BamBuddy in de ZimaOS App Store?
De gebruiker uit de bron kon geen speciaal pakket vinden; aangepaste Docker Compose is de eenvoudigste oplossing.
Welke poort gebruikt BamBuddy?
De standaardwebinterface gebruikt poort 8000.
Waarom hostnetwerken gebruiken?
Hiermee worden containerdetectie op Linux en de printernetwerkfuncties ingeschakeld die BamBuddy verwacht.
Kan ik het vanuit de broncode bouwen?
Ja, maar het upstreamproject raadt voor normale implementaties de vooraf gebouwde image aan.
