BamBuddy funziona su ZimaOS tramite Docker Compose, anche se non è un pacchetto integrato nell'App Store. Usa l'immagine precompilata upstream, rendi persistenti le cartelle /app/data e /app/logs e mantieni la rete host di Linux se vuoi il rilevamento automatico delle stampanti Bambu.
La discussione originale non aveva fornito una soluzione, ma ora BamBuddy pubblica un flusso di lavoro Docker mantenuto. ZimaOS supporta app Compose personalizzate, quindi non è necessario modificare il sistema operativo host né compilare BamBuddy dal codice sorgente, a meno che tu non voglia svilupparlo.
Usa l'immagine Docker upstream
L'attuale guida Docker di BamBuddy raccomanda Docker come metodo di distribuzione più semplice.
Impostazioni principali di Compose su 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
Dopo l'avvio, apri http://ZIMA-IP:8000.
Perché è importante usare la rete host
BamBuddy usa il rilevamento sulla rete locale per trovare le stampanti Bambu. Il file Compose upstream usa network_mode: host su Linux perché la normale rete bridge non riceve in modo altrettanto affidabile il traffico di rilevamento SSDP previsto.
Puoi aggiungere manualmente la stampante
Se il rilevamento non trova la stampante, aggiungila tramite il suo IP LAN. Assicurati che la stampante e ZimaOS siano su reti in grado di comunicare tra loro e che sulla stampante sia abilitata la modalità locale/per sviluppatori richiesta.
Rendi persistenti i dati prima dell'aggiornamento
BamBuddy salva il database, gli archivi e i dati operativi nella directory dati configurata. Mantieni questi percorsi al di fuori del livello temporaneo del container.
Aggiorna la distribuzione Docker
docker compose pull
docker compose up -dIl progetto upstream ha rilasciato aggiornamenti relativi alla sicurezza, quindi mantieni l'immagine aggiornata ed esegui un backup dell'applicazione prima delle modifiche importanti.
Non esporre direttamente la porta 8000 a Internet
Mantieni BamBuddy sulla LAN oppure dietro HTTPS autenticato/accesso remoto privato. Le interfacce di gestione delle stampanti non dovrebbero essere inoltrate alla porta pubblica con leggerezza.
La guida Docker personalizzata illustra il modello generale delle app personalizzate.
Verifica il container prima di aggiungere una stampante
docker ps | grep bambuddy
docker logs --tail 100 bambuddyVerifica che il servizio web si avvii correttamente sulla porta 8000 prima di diagnosticare il rilevamento della stampante. Se la dashboard stessa non si apre, il problema non riguarda ancora la rete della stampante.
Esegui il backup del database di BamBuddy prima degli aggiornamenti
Il progetto upstream include una propria funzione di backup. Usala prima delle modifiche importanti all'immagine e conserva anche una copia della directory dei dati persistenti. Un'immagine container può essere scaricata di nuovo in qualsiasi momento; la cronologia delle stampe e il database locale no.
La rete host amplia la portata di rete del container
Poiché la modalità host condivide lo spazio dei nomi di rete di ZimaOS, controlla le porte dell'app e mantieni il software aggiornato. La modalità host è giustificata qui dal rilevamento della stampante, ma offre un isolamento di rete inferiore rispetto a una normale rete bridge.
Usa un IP stabile per la stampante
Quando possibile, riserva l'IP della stampante nel router. Anche se oggi il rilevamento automatico funziona, un indirizzo stabile semplifica notevolmente la diagnosi di fotocamera, MQTT e riconnessione manuale dopo il riavvio del router o della stampante.
Domande frequenti
BamBuddy è nell'App Store di ZimaOS?
L'utente originale non riusciva a trovare un pacchetto dedicato; Docker Compose personalizzato è la soluzione più semplice.
Quale porta usa BamBuddy?
L'interfaccia web predefinita usa la porta 8000.
Perché usare la rete host?
Abilita il rilevamento dai container Linux e le funzioni di rete della stampante previste da BamBuddy.
Posso compilarlo dal codice sorgente?
Sì, ma il progetto upstream raccomanda l'immagine precompilata per le distribuzioni normali.
