BamBuddy는 기본 제공 App Store 패키지가 아니더라도 Docker Compose를 통해 ZimaOS에서 실행할 수 있습니다. 업스트림에서 제공하는 사전 빌드 이미지를 사용하고, /app/data 및 /app/logs 폴더를 영구 저장하세요. Bambu 프린터를 자동으로 검색하려면 Linux 호스트 네트워킹을 유지하세요.
원래 스레드에는 해결 방법이 없었지만, 이제 BamBuddy는 유지 관리되는 Docker 워크플로를 제공합니다. ZimaOS는 사용자 지정 Compose 앱을 지원하므로, 개발 목적이 아니라면 호스트 OS를 수정하거나 소스에서 BamBuddy를 빌드할 필요가 없습니다.
업스트림 Docker 이미지 사용
최신 BamBuddy Docker 가이드에서는 Docker를 가장 간편한 배포 방법으로 권장합니다.
ZimaOS Compose 핵심 설정
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
시작이 완료되면 http://ZIMA-IP:8000을 여세요.
호스트 네트워킹이 중요한 이유
BamBuddy는 Bambu 프린터를 검색할 때 로컬 네트워크 검색을 사용합니다. 일반 브리지 네트워킹에서는 예상되는 SSDP 검색 트래픽을 안정적으로 수신하지 못할 수 있으므로, 업스트림 Compose는 Linux에서 network_mode: host를 사용합니다.
프린터를 수동으로 추가할 수도 있습니다
검색에서 프린터를 찾지 못하면 LAN IP로 추가하세요. 프린터와 ZimaOS가 서로 통신할 수 있는 네트워크에 연결되어 있고, 프린터에 필요한 로컬/개발자 모드가 활성화되어 있는지 확인하세요.
업데이트 전에 데이터를 영구 저장하세요
BamBuddy는 구성된 데이터 디렉터리에 데이터베이스, 보관 파일 및 운영 데이터를 저장합니다. 이러한 경로를 삭제될 수 있는 컨테이너 레이어 외부에 유지하세요.
Docker 배포 업데이트
docker compose pull
docker compose up -d업스트림 프로젝트에서는 보안 관련 업데이트가 제공되었으므로 이미지를 최신 상태로 유지하고, 주요 변경 전에 애플리케이션을 백업하세요.
포트 8000을 인터넷에 직접 노출하지 마세요
BamBuddy를 LAN에서 사용하거나, 인증된 HTTPS 또는 비공개 원격 액세스 뒤에 두세요. 프린터 관리 인터페이스를 무분별하게 포트 포워딩해서는 안 됩니다.
사용자 지정 Docker 가이드에서 일반적인 사용자 지정 앱 모델을 확인할 수 있습니다.
프린터를 추가하기 전에 컨테이너 확인
docker ps | grep bambuddy
docker logs --tail 100 bambuddy프린터 검색 문제를 해결하기 전에 웹 서비스가 포트 8000에서 정상적으로 시작되는지 확인하세요. 대시보드 자체가 열리지 않는다면 아직 프린터 네트워크가 문제인 것은 아닙니다.
업데이트 전에 BamBuddy 데이터베이스 백업
업스트림 프로젝트에는 자체 백업 기능이 포함되어 있습니다. 주요 이미지 변경 전에 이 기능을 사용하고, 영구 데이터 디렉터리의 사본도 보관하세요. 컨테이너 이미지는 언제든 다시 가져올 수 있지만, 인쇄 기록과 로컬 데이터베이스는 다시 복구할 수 없습니다.
호스트 네트워킹은 컨테이너의 네트워크 접근 범위를 넓힙니다
호스트 모드는 ZimaOS 네트워크 네임스페이스를 공유하므로 앱의 포트를 검토하고 소프트웨어를 최신 상태로 유지하세요. 여기서는 프린터 검색을 위해 호스트 모드가 적합하지만, 일반 브리지 네트워크보다 네트워크 격리 수준이 낮습니다.
안정적인 프린터 IP 사용
가능하면 공유기에서 프린터의 IP를 예약하세요. 오늘 자동 검색이 작동하더라도 안정적인 주소를 사용하면 공유기나 프린터를 재부팅한 후 카메라, MQTT 및 수동 재연결 문제를 훨씬 쉽게 해결할 수 있습니다.
FAQ
BamBuddy가 ZimaOS App Store에 있나요?
원문의 사용자는 전용 패키지를 찾지 못했으며, 사용자 지정 Docker Compose를 사용하는 것이 가장 간단한 방법입니다.
BamBuddy는 어떤 포트를 사용하나요?
기본 웹 UI 포트는 8000입니다.
왜 호스트 네트워킹을 사용하나요?
호스트 네트워킹을 사용하면 BamBuddy에 필요한 Linux 컨테이너 검색 및 프린터 네트워크 기능을 활성화할 수 있습니다.
소스에서 빌드할 수 있나요?
가능하지만, 업스트림 프로젝트에서는 일반적인 배포에 사전 빌드 이미지를 권장합니다.
