企业官网建设流程全解析

打印完成秒通知：Bambuddy多通道推送（Telegram/Discord/邮件/ntfy）配置全攻略

【免费下载链接】bambuddyYour Bambu Lab. No Cloud. Your Rules. Self-hosted command center for Bambu Lab — from one A1 to an entire print farm.项目地址: https://gitcode.com/gh_mirrors/ba/bambuddy

Bambuddy 是一个自托管的 Bambu Lab 3D 打印机指挥中心（支持从单台 A1 到整个打印农场），内置强大的多通道推送通知系统：打印完成、失败、停机、离线等事件发生后，秒级推送到 Telegram、Discord、邮件、ntfy，甚至 Home Assistant，让你人不在打印农场也能随时掌握打印状态。本文带你用 5 分钟完成配置。

为什么需要多通道推送？

3D 打印动辄几小时甚至过夜。传统做法是盯着屏幕或手机 App 刷新，而 Bambuddy 的通知系统把"人找机器"变成"机器找人"：

• 🖨️打印生命周期：开始、完成（默认开启）、失败、手动停止、25%/50%/75% 进度里程碑
• 📡打印机状态：离线、AMS 故障报错、耗材不足、维护到期
• 📦队列事件：任务等待耗材/打印机、任务被跳过、任务启动失败
• 🔬高级告警：AI 失败检测（Obico 面条检测）、热床冷却完成、构建板异物检测、AMS 湿度/温度告警、库存补货提醒

每个推送通道都可以独立勾选自己关心的事件，还能绑定到指定打印机（不绑定则监听全部机器）。事件定义源码见 notification.py。

一键进入通知设置

在左侧菜单进入Settings → Notifications，你会看到三个区域：

新增通道点击绿色Add按钮即可，添加向导见 AddNotificationModal.tsx。

Telegram 推送配置：最适合手机秒收

适合场景：手机通知栏即时弹出，支持附带完成照片。

1. 在 Telegram 中找 @BotFather →/newbot，创建机器人并拿到Bot Token（形如123456:ABC-DEF...）
2. 给你的机器人随便发一条消息，获取Chat ID（个人、群或频道均可）
3. 在 Bambuddy 通知页 Add → 选择 Telegram → 填入 Bot Token 和 Chat ID
4. 勾选事件（建议至少开启 Print Complete / Failed / Stopped）→ 点Send Test Notification验证

代码实现位于 notification_service.py。打印完成时，如果模板中引用了完成照片，Bot 会直接以图片形式推送给你。

Discord Webhook 配置：打印群专属播报

适合场景：多人共享打印农场，用 Discord 服务器统一播报。

1. 在 Discord 频道设置 → 集成（Integrations）→ Webhook → 新建 Webhook，复制Webhook URL
2. 在 Bambuddy 选择 Discord 通道，粘贴 URL 即可
3. Bambuddy 会以富文本 Embed 形式推送（标题+正文），同样支持附完成照片

通道卡片组件见 NotificationProviderCard.tsx。

邮件（SMTP）配置：带完成照片的正式报告

适合场景：需要存档、发给团队成员或作为交付凭证。

在 Email 通道中填写：

• SMTP 服务器与端口（587/465）
• 加密方式：starttls（587 端口）或ssl（465 端口）
• 用户名 / 密码：多数邮箱服务商使用"授权码"而非登录密码
• 发件人 / 收件人邮箱

邮件通道实现见 notification_service.py。小技巧：在消息模板中引用完成照片占位符，Bambuddy 会把照片以内嵌图片形式嵌入 HTML 邮件正文，开箱即看效果。

ntfy 配置：极简自托管推送

适合场景：Android 原生通知、或想完全掌控推送链路。

ntfy 只订阅主题就能收推送，Bambuddy 默认服务器为https://ntfy.sh，也可填写自己的自托管地址（局域网地址同样支持）：

1. 在手机/电脑安装 ntfy 客户端
2. 订阅一个主题（如my-printer）
3. Bambuddy 中选择 ntfy 通道 → 填写Server与Topic
4. 进阶：可为不同事件设置优先级（1-5），让"打印失败"以最高响铃级别推送

此外，Bambuddy 还内置Pushover、Bark（iOS）、CallMeBot（微信）、通用 Webhook、Home Assistant通道，覆盖更多设备生态。

队列与多机场景：事件怎么选？

多机打印农场中，队列事件是隐藏宝藏：

• Job Waiting（默认开）：某台机器在等耗材/等待空闲——提示你及时换料
• Job Skipped / Failed（默认开）：上件失败导致跳件、任务启动失败——农场最怕"静默掉链子"
• Job Completed：整批任务跑完才汇总通知一次，避免刷屏

防打扰：免打扰时段 + 每日摘要

夜间打印怕吵？两个开关帮你：

• 🌙Quiet Hours（免打扰）：如设置 22:00–07:00，期间事件不立即推送
• 📬Daily Digest（每日摘要）：把非关键通知攒到指定时间（如 08:00）合并成一条摘要发送，失败/离线等紧急事件不受影响

验证配置：先测试再上线

每个通道卡片都有Send Test Notification按钮——发送一条测试消息实时验证 Token/URL/SMTP 是否正确。发送失败时，Log页会记录每条通知的成功/失败原因（如"SMTP 认证失败 - 请检查用户名/密码"、ntfy 被 Cloudflare 拦截的提示），排查有据可依。

总结

配置好以上任意一个通道，你的 Bambu Lab 就告别了"守机"时代——打印完成秒通知，失败停机第一时间知晓。更多通知模板占位符与事件细节，可参考 backend/app/services/notification_service.py 与 frontend/src/components/NotificationTemplateEditor.tsx。

【免费下载链接】bambuddyYour Bambu Lab. No Cloud. Your Rules. Self-hosted command center for Bambu Lab — from one A1 to an entire print farm.项目地址: https://gitcode.com/gh_mirrors/ba/bambuddy