BamBuddy działa w systemie ZimaOS za pośrednictwem Docker Compose, mimo że nie jest wbudowanym pakietem App Store. Użyj gotowego obrazu udostępnianego przez projekt nadrzędny, zachowaj foldery /app/data i /app/logs, a także pozostaw sieć hosta Linuksa, jeśli chcesz automatycznie wykrywać drukarki Bambu.
Oryginalny wątek nie zawierał rozwiązania, ale BamBuddy publikuje już utrzymywany przepływ pracy Docker. ZimaOS obsługuje niestandardowe aplikacje Compose, więc nie ma potrzeby modyfikowania systemu hosta ani budowania BamBuddy ze źródeł, chyba że chcesz go rozwijać.
Użyj obrazu Docker projektu nadrzędnego
Aktualny przewodnik Docker dla BamBuddy zaleca Docker jako najłatwiejszą metodę wdrożenia.
Podstawowe ustawienia Compose w 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
Po uruchomieniu otwórz http://ZIMA-IP:8000.
Dlaczego sieć hosta ma znaczenie
BamBuddy używa wykrywania drukarek Bambu w sieci lokalnej. W nadrzędnym pliku Compose w systemie Linux użyto network_mode: host, ponieważ zwykła sieć mostkowana nie odbiera oczekiwanego ruchu wykrywania SSDP z taką niezawodnością.
Możesz dodać drukarkę ręcznie
Jeśli wykrywanie nie znajdzie drukarki, dodaj ją za pomocą adresu IP w sieci LAN. Upewnij się, że drukarka i ZimaOS znajdują się w sieciach, które mogą się wzajemnie komunikować, oraz że wymagany lokalny lub deweloperski tryb drukarki jest włączony.
Zachowaj dane przed aktualizacją
BamBuddy przechowuje bazę danych, archiwa i dane operacyjne w skonfigurowanym katalogu danych. Trzymaj te ścieżki poza nietrwałą warstwą kontenera.
Aktualizacja wdrożenia Docker
docker compose pull
docker compose up -dProjekt nadrzędny wydał aktualizacje związane z bezpieczeństwem, dlatego utrzymuj obraz w aktualnej wersji i wykonaj kopię zapasową aplikacji przed większymi zmianami.
Nie wystawiaj bezpośrednio portu 8000 do Internetu
Utrzymuj BamBuddy w sieci LAN albo za uwierzytelnionym dostępem HTTPS lub prywatnym dostępem zdalnym. Interfejsów do zarządzania drukarkami nie należy bez potrzeby udostępniać przez przekierowanie portów.
przewodnik po niestandardowym Dockerze przedstawia ogólny model niestandardowych aplikacji.
Sprawdź kontener przed dodaniem drukarki
docker ps | grep bambuddy
docker logs --tail 100 bambuddyPotwierdź, że usługa internetowa uruchamia się prawidłowo na porcie 8000, zanim zaczniesz diagnozować wykrywanie drukarki. Jeśli sam panel nie otwiera się, problem nie dotyczy jeszcze sieci drukarki.
Wykonaj kopię zapasową bazy danych BamBuddy przed aktualizacjami
Projekt nadrzędny zawiera własną funkcję tworzenia kopii zapasowych. Użyj jej przed większymi zmianami obrazu, a także zachowaj kopię trwałego katalogu danych. Obraz kontenera można zawsze pobrać ponownie, ale historii wydruków i lokalnej bazy danych nie da się odtworzyć.
Sieć hosta zwiększa zasięg sieciowy kontenera
Ponieważ tryb hosta współdzieli przestrzeń nazw sieci ZimaOS, przejrzyj porty aplikacji i aktualizuj oprogramowanie. Tryb hosta jest tu uzasadniony wykrywaniem drukarek, ale zapewnia mniejszą izolację sieciową niż zwykła sieć mostkowana.
Użyj stałego adresu IP drukarki
Jeśli to możliwe, zarezerwuj adres IP drukarki w routerze. Nawet jeśli automatyczne wykrywanie działa dzisiaj, stały adres znacznie ułatwia diagnozowanie kamery, MQTT i ręcznego ponownego łączenia po ponownym uruchomieniu routera lub drukarki.
FAQ
Czy BamBuddy jest dostępny w App Store systemu ZimaOS?
Użytkownik źródłowego wpisu nie znalazł dedykowanego pakietu; niestandardowy Docker Compose to najprostsze rozwiązanie.
Z jakiego portu korzysta BamBuddy?
Domyślny interfejs internetowy działa na porcie 8000.
Dlaczego używać sieci hosta?
Umożliwia ona wykrywanie z poziomu kontenera Linuksa i funkcje sieciowe drukarki wymagane przez BamBuddy.
Czy mogę zbudować go ze źródeł?
Tak, ale projekt nadrzędny zaleca gotowy obraz do standardowych wdrożeń.
