如何把Bambuddy接入Home AssistantMQTT传感器与Prometheus指标集成完整指南【免费下载链接】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/bambuddyBambuddy 是一个完全自托管的 Bambu Lab 打印机指挥中心Self-hosted command center从一台 A1 到整个打印农场都能管理。通过内置的Home Assistant 集成、MQTT 事件推送和Prometheus /metrics 指标端点三套机制可以把它无缝接入你的智能家居和监控体系HA 传感器双向联动、MQTT Broker 事件订阅、Prometheus 抓取温度与进度数据。本文带你完成 Bambuddy 接入 Home Assistant 的全部实战配置全程 15 分钟。一、为什么值得把 Bambuddy 接入 Home Assistant 集成方式能力典型场景HA 实体读取绑定binary_sensor.*/sensor.*15 秒轮询机箱门磁、环境温湿度显示与告警HA 实体控制绑定switch/light等实体打印开始自动通电、完成自动断电MQTT Relay事件推送到外部 BrokerNode-RED / HA 自动化、打印农场看板Prometheus/metrics标准指标格式暴露Grafana 面板、温度与队列告警核心源码位置HA REST API 客户端backend/app/services/homeassistant.pyHA 传感器轮询与告警引擎backend/app/services/ha_sensor_manager.pyMQTT 事件推送服务backend/app/services/mqtt_relay.pyPrometheus 指标端点backend/app/api/routes/metrics.py二、快速配置为 Bambuddy 填入 Home Assistant 地址与令牌 ⚙️在 Home Assistant 中个人资料 → 安全 → 创建长期访问令牌Long-Lived Access Token。打开 Bambuddy 的设置 → 网络 → Home Assistant填入两项ha_urlHA 地址例如http://192.168.1.100:8123ha_token刚才创建的令牌点击测试连接成功即返回 Connected。 也支持通过环境变量HA_URL与HA_TOKEN注入配置适合 Docker 部署。相关字段定义见 backend/app/schemas/settings.py。HA 地址必须通过安全校验homeassistant.py 的 _validate_url 会拦截内网元数据地址等危险目标令牌校验失败会明确提示 Invalid access token方便排查。三、绑定 Home Assistant 传感器门磁、温湿度上打印机卡片 ️进入打印机卡片 → HA 传感器从下拉框选择要绑定的 HA 实体Bambuddy 会列出全部binary_sensor.*和带数值的sensor.*实体来源接口为 ha_sensors.py。每个传感器支持三类配置告警规则数值型用alert_above/alert_below阈值开关型用alert_state如门磁的on。打印联锁block_print传感器告警时自动暂停调度该打印机的队列任务传感器恢复后立即自动放行——专为机箱门未关闭的场景设计。告警通知notify_on_alert仅在状态跳入告警时通知一次持续告警不会刷屏。轮询器每 15 秒读取一次所有绑定的实体ha_sensor_manager.py页面直接读缓存不会给 HA 造成额外压力。更稳的设计是降级策略HA 不可达时传感器视为无意见不误报、不误挡队列门磁断线不会卡死你的打印任务。四、用 Home Assistant 控制智能插座与用电监测 在设置 → 智能插座中把插座的实体来源选为 Home Assistant即可从实体列表直接选择switch.*/light.*/input_boolean.*/script.*过滤逻辑见 homeassistant.py 的 list_entities。更进一步插座还支持绑定能量传感器Bambuddy 会列出 HA 中单位是 W/kWh 的sensor.*实体list_sensor_entities填入功率、今日能耗、总能耗三个实体后打印机用电成本统计就有了实时数据来源。五、接入自己的 MQTT Broker事件推送与自动化 打开设置 → MQTT填入 Broker 地址默认端口 1883TLS 8883、可选的用户名/密码与主题前缀默认bambuddy。字段说明见 settings.py 的 mqtt_* 字段。连接成功后Bambuddy 会把以下事件以 JSON 发布到 Broker完整实现见 mqtt_relay.pyTopic 模式含义{prefix}/statusBambuddy 在线/离线保留消息{prefix}/printers/{序列号}/status完整状态进度、温度、层高每秒最多 1 条节流{prefix}/printers/{序列号}/print/startedcompletedfailed打印开始/完成/失败{prefix}/printers/{序列号}/plate_clear取件等待门保留消息{prefix}/printers/{序列号}/ams/changed、errorAMS 换料、HMS 错误{prefix}/queue/job_addedjob_startedjob_completed队列任务流转{prefix}/maintenance/alert、{prefix}/filament/low保养提醒、耗材低量在 Home Assistant 里用MQTT Discovery或手动建 MQTT 传感器订阅bambuddy/printers//status即可把打印状态变成原生 HA 实体实现打印完成 → 开灯提醒 / 发手机通知等自动化。六、Prometheus /metrics用 Grafana 监控温度与队列 设置 → 监控中开启prometheus_enabled建议同时设置prometheus_token启用后需带Bearer令牌访问端点未开启时返回 404。在 Prometheus 中增加抓取目标示例仅 4 行jobbambuddymetrics_path/metricsauthorization credentials你设置的令牌Bambuddy 按 Prometheus 文本格式输出 20 项指标构造逻辑见 metrics.py常用的有实时状态bambuddy_printer_connected、bambuddy_printer_state、bambuddy_print_progress、bambuddy_print_remaining_seconds、bambuddy_print_layer_current/total温度与风扇bambuddy_nozzle_temp_celsius、bambuddy_bed_temp_celsius、bambuddy_chamber_temp_celsius、bambuddy_fan_speed_percent统计与队列bambuddy_prints_total、bambuddy_filament_used_grams、bambuddy_print_time_seconds、bambuddy_queue_pending/printing、bambuddy_printers_connected配合 Grafana 就能做出打印农场大屏每台机器的温度曲线、队列堆积、故障率一目了然。七、常见问题排查清单 ✅现象原因与处理测试连接提示 Invalid access token令牌过期或复制不完整重新创建长期令牌实体下拉框是空的检查ha_url是否可达控制类实体仅接受 switch/light/input_boolean/script 四类传感器卡片长期空白HA 不可达会显示为不可读检查网络恢复后 15 秒内自动回填MQTT 已启用但没收到消息确认 Broker 端口、主题前缀一致查看 Bambuddy 日志中MQTT relay connected/metrics返回 404未在设置中开启prometheus_enabled写在最后至此Bambuddy 的三条自动化通道已全部打通HA 传感器负责本地联动与打印联锁MQTT Relay负责事件级自动化Prometheus负责历史数据与大盘监控。三者共用同一份设备状态源互不冲突可以按需组合——哪怕只开一项你的 Bambu Lab 打印农场就已经纳入了统一的家庭智能体系。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考