BamBuddy se ejecuta en ZimaOS mediante Docker Compose, aunque no es un paquete integrado de la App Store. Usa la imagen precompilada del proyecto original, conserva sus carpetas /app/data y /app/logs, y mantén la red del host de Linux si quieres descubrir automáticamente las impresoras Bambu.
El hilo original no tenía una solución, pero ahora BamBuddy publica un flujo de trabajo de Docker mantenido. ZimaOS admite aplicaciones Compose personalizadas, por lo que no es necesario modificar el sistema operativo del host ni compilar BamBuddy desde el código fuente, a menos que quieras desarrollarlo.
Usa la imagen de Docker del proyecto original
La guía de Docker de BamBuddy actual recomienda Docker como el método de implementación más sencillo.
Configuración básica de Compose en 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
Abre http://ZIMA-IP:8000 después del inicio.
Por qué es importante usar la red del host
BamBuddy utiliza la detección en la red local para encontrar impresoras Bambu. El Compose original usa network_mode: host en Linux porque la red puente normal no recibe con la misma fiabilidad el tráfico de detección SSDP esperado.
Puedes añadir la impresora manualmente
Si la detección no encuentra la impresora, añádela mediante su IP de LAN. Asegúrate de que la impresora y ZimaOS estén en redes que puedan comunicarse entre sí y de que la impresora tenga activado el modo local/de desarrollador necesario.
Conserva los datos antes de actualizar
BamBuddy almacena su base de datos, archivos y datos operativos en el directorio de datos configurado. Mantén esas rutas fuera de la capa desechable del contenedor.
Actualiza la implementación de Docker
docker compose pull
docker compose up -dEl proyecto original ha publicado actualizaciones relacionadas con la seguridad, así que mantén la imagen actualizada y crea una copia de seguridad de la aplicación antes de realizar cambios importantes.
No expongas directamente el puerto 8000 a Internet
Mantén BamBuddy en la LAN o detrás de HTTPS autenticado y de un acceso remoto privado. Las interfaces de administración de impresoras no deberían exponerse mediante el reenvío de puertos sin las debidas precauciones.
La guía de Docker personalizado ofrece el modelo general para aplicaciones personalizadas.
Verifica el contenedor antes de añadir una impresora
docker ps | grep bambuddy
docker logs --tail 100 bambuddyConfirma que el servicio web se inicia correctamente en el puerto 8000 antes de solucionar problemas de detección de impresoras. Si el panel no se abre, el problema aún no está relacionado con la red de la impresora.
Haz una copia de seguridad de la base de datos de BamBuddy antes de actualizar
El proyecto original incluye su propia función de copia de seguridad. Úsala antes de realizar cambios importantes en la imagen y conserva también una copia del directorio de datos persistentes. Una imagen de contenedor siempre se puede volver a descargar; tu historial de impresiones y tu base de datos local, no.
La red del host amplía el alcance de red del contenedor
Como el modo host comparte el espacio de nombres de red de ZimaOS, revisa los puertos de la aplicación y mantén el software actualizado. El modo host está justificado en este caso por la detección de impresoras, pero proporciona menos aislamiento de red que una red puente normal.
Usa una IP estable para la impresora
Cuando sea posible, reserva la IP de la impresora en el router. Aunque la detección automática funcione hoy, una dirección estable facilita mucho la solución de problemas relacionados con la cámara, MQTT y la reconexión manual después de reiniciar el router o la impresora.
Preguntas frecuentes
¿BamBuddy está en la App Store de ZimaOS?
El usuario original no pudo encontrar un paquete específico; Docker Compose personalizado es la opción más sencilla.
¿Qué puerto usa BamBuddy?
La interfaz web predeterminada utiliza el puerto 8000.
¿Por qué usar la red del host?
Permite la detección desde el contenedor de Linux y las funciones de red de impresoras que BamBuddy espera.
¿Puedo compilarlo desde el código fuente?
Sí, pero el proyecto original recomienda la imagen precompilada para las implementaciones normales.
