maziggy/bambuddy

Bambuddy

适用于Bambu Lab 3D打印机的自托管打印归档和管理系统。

无云依赖。完全隐私保护。全面掌控。

![]([]

快速开始

bash
mkdir bambuddy && cd bambuddy
curl -O https://raw.githubusercontent.com/maziggy/bambuddy/main/docker-compose.yml
docker compose up -d

打开 http://localhost:8000 并添加您的打印机。

要求： Bambu Lab打印机需启用开发者模式，并处于同一局域网。

支持的架构

核心功能

• 实时监控 — 实时打印机状态、摄像头流、HMS错误跟踪（853代码翻译）、可调整大小的多打印机仪表盘
• 打印归档 — 带元数据的自动3MF归档、交互式3D模型查看器（Three.js）、照片附件、故障分析、并排比较
• 打印调度 — 拖放队列、按模型或位置分配多打印机、基于时间的调度、带AMS映射的重打印
• 智能自动化 — 智能插头控制（Tasmota、Home Assistant、MQTT）、自动开关机、能源监控、维护提醒
• 代理模式 — 无需***或端口转发即可从Bambu Studio/OrcaSlicer远程打印，端到端TLS加密
• 通知 — 、、***、电子邮件、Pushover、ntfy，支持自定义模板和安静时段
• 项目管理 — 分组相关打印、跟踪零件和打印板、物料清单、成本跟踪、导出为ZIP/JSON
• 文件管理 — 上传和组织切片文件、文件夹结构、直接打印到任何打印机
• 集成 — Spoolman filament同步、MQTT发布、Prometheus指标、Bambu Cloud配置文件、REST API、Home Assistant
• 虚拟打印机 — 通过SSDP发现出现在切片器中，多种操作模式（归档、审核、队列、代理）
• 安全 — 可选的基于组的权限认证（50+细粒度）、JWT令牌、API密钥支持

配置说明

数据卷

Docker Compose配置

yaml
services:
  bambuddy:
    image: maziggy/bambuddy:latest
    container_name: bambuddy
    network_mode: host
    environment:
      - TZ=America/New_York
      - PUID=1000
      - PGID=1000
    volumes:
      - bambuddy_data:/app/data
      - bambuddy_logs:/app/logs
    restart: unless-stopped

volumes:
  bambuddy_data:
  bambuddy_logs:

macOS/Windows： Docker Desktop不支持network_mode: host。请替换为ports: ["8000:8000"]并通过IP手动添加打印机。

更新方法

bash
docker compose pull && docker compose up -d

支持的打印机

所有打印机需要启用开发者模式以进行局域网访问。

相关链接

• 网站： bambuddy.cool
• 文档： wiki.bambuddy.cool
• GitHub： https://github.com/maziggy/bambuddy
• ***： ***.gg/aFS3ZfScHM
• 问题反馈： https://github.com/maziggy/bambuddy/issues

许可证

MIT许可证 - 详见 https://github.com/maziggy/bambuddy/blob/main/LICENSE%E3%80%82