O BamBuddy funciona no ZimaOS através do Docker Compose, apesar de não ser um pacote integrado da App Store. Utilize a imagem pré-compilada oficial, mantenha as pastas /app/data e /app/logs persistentes e mantenha a rede do anfitrião Linux se quiser a deteção automática de impressoras Bambu.
O tópico original não tinha solução, mas o BamBuddy disponibiliza agora um fluxo de trabalho Docker mantido. O ZimaOS suporta aplicações Compose personalizadas, pelo que não é necessário modificar o sistema operativo anfitrião nem compilar o BamBuddy a partir do código-fonte, a menos que pretenda desenvolvê-lo.
Utilizar a imagem Docker oficial
O guia Docker do BamBuddy recomenda o Docker como o método de implementação mais simples.
Definições principais do Compose no 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
Após o arranque, abra http://ZIMA-IP:8000.
Porque é importante utilizar a rede do anfitrião
O BamBuddy utiliza a deteção na rede local para encontrar impressoras Bambu. O Compose oficial utiliza network_mode: host no Linux porque a rede bridge normal não recebe de forma tão fiável o tráfego de deteção SSDP esperado.
Pode adicionar a impressora manualmente
Se a deteção não encontrar a impressora, adicione-a através do IP da LAN. Certifique-se de que a impressora e o ZimaOS estão em redes que conseguem comunicar entre si e de que o modo local/de programador necessário da impressora está ativado.
Persista os dados antes de atualizar
O BamBuddy armazena a base de dados, os arquivos e os dados operacionais na pasta de dados configurada. Mantenha esses caminhos fora da camada descartável do contentor.
Atualizar a implementação Docker
docker compose pull
docker compose up -dO projeto oficial lançou atualizações relacionadas com a segurança, por isso mantenha a imagem atualizada e faça uma cópia de segurança da aplicação antes de alterações importantes.
Não exponha diretamente a porta 8000 à Internet
Mantenha o BamBuddy na LAN ou atrás de HTTPS autenticado/acesso remoto privado. As interfaces de gestão de impressoras não devem ser reencaminhadas para a Internet de forma irrefletida.
O guia Docker personalizado apresenta o modelo geral para aplicações personalizadas.
Verificar o contentor antes de adicionar uma impressora
docker ps | grep bambuddy
docker logs --tail 100 bambuddyConfirme que o serviço Web arranca corretamente na porta 8000 antes de investigar a deteção da impressora. Se o próprio painel não abrir, o problema ainda não está na rede da impressora.
Fazer uma cópia de segurança da base de dados do BamBuddy antes das atualizações
O projeto oficial inclui a sua própria função de cópia de segurança. Utilize-a antes de alterações importantes à imagem e mantenha também uma cópia do diretório de dados persistentes. Uma imagem de contentor pode ser obtida novamente a qualquer momento; o seu histórico de impressão e a base de dados local, não.
A rede do anfitrião amplia o alcance de rede do contentor
Como o modo anfitrião partilha o espaço de nomes de rede do ZimaOS, reveja as portas da aplicação e mantenha o software atualizado. O modo anfitrião justifica-se neste caso devido à deteção da impressora, mas proporciona menos isolamento de rede do que uma rede bridge normal.
Utilizar um IP estável para a impressora
Sempre que possível, reserve o IP da impressora no router. Mesmo que a deteção automática funcione hoje, um endereço estável facilita bastante a resolução de problemas relacionados com a câmara, o MQTT e a reconexão manual após reinícios do router ou da impressora.
FAQ
O BamBuddy está na App Store do ZimaOS?
O utilizador original não encontrou um pacote dedicado; o Docker Compose personalizado é a opção mais simples.
Que porta utiliza o BamBuddy?
A interface Web utiliza, por predefinição, a porta 8000.
Por que motivo utilizar a rede do anfitrião?
Esta configuração permite a deteção a partir do contentor Linux e as funcionalidades de rede da impressora esperadas pelo BamBuddy.
Posso compilá-lo a partir do código-fonte?
Sim, mas o projeto oficial recomenda a imagem pré-compilada para implementações normais.
