
Moonraker Home Assistant 集成是一款帮你在 Home Assistant 里集中管 Klipper 3D 打印机的非官方集成:它通过 Moonraker 连接打印机,把状态、摄像头、打印缩略图、宏触发与紧急停止都收进家庭自动化界面,不用再在多个页面之间切换。据仓库说明,它通过 HACS 安装,配置项包括主机、端口、API 密钥和打印机名称。
30 秒速读
家里已经跑着 Home Assistant,又有一台接 Moonraker 的 Klipper 打印机,想在一个界面里同时看打印进度、调摄像头、触发宏,这个集成就是为这种组合准备的。但要注意一个前提:项目被标注为当前无人维护,建议先在非关键环境验证实体、控制操作和目标硬件兼容性,再决定是否用于长期部署。
项目信息
| 项目 | 内容 |
|---|---|
| 开发语言 | Python |
| 安装方式 | 通过 HACS 安装的非官方集成 |
| 许可证 | MIT 许可证 |
| 适用平台 | 多平台 |
| 版本要求 | Home Assistant 2025.1 或更高版本 |
| 适用场景 | 在 Home Assistant 中监控与控制 Klipper 3D 打印机 |
选型对照:它和直接用 Mainsail 比
结论先行:要的是把打印机收进 Home Assistant 的自动化与统一界面,选这个集成;只想看打印状态、调打印机参数,Mainsail 本身就够,别多装一层。
| 维度 | Moonraker Home Assistant 集成 | 直接用 Mainsail |
|---|---|---|
| 入口 | Home Assistant 统一界面与自动化 | 独立的打印机 Web 界面 |
| 能做的事 | 传感器、摄像头、缩略图、宏按钮、紧急停止实体 | 打印控制、切片管理、打印机调参 |
| 自动化联动 | 可接 Home Assistant 自动化与通知 | 需另行对接 |
| 维护状态 | 当前无人维护,兼容风险自担 | 持续维护 |
| 适合谁 | 已有 Home Assistant 环境的用户 | 只用打印机、不跑家庭自动化的用户 |
上手步骤
- 先确认版本与硬件:Home Assistant 须为 2025.1 或更高版本,打印机须跑 Moonraker 与 Klipper;FLSUN Speeder Pad 与 Sonic Pad 被明确列为不受支持,先排除。
- 通过 HACS 安装:在 HACS 中搜索 Moonraker 集成并下载安装,安装后重启 Home Assistant 让集成生效。
- 填好连接配置:填写 Moonraker 主机或 IP、端口,需要认证的实例还要准备 API 密钥,再填一个好认的打印机名称。
- 先在非关键环境验证:逐个检查传感器、摄像头画面、打印缩略图、宏触发与紧急停止实体是否正常,再决定是否长期用。
- 留好回退方案:由于项目当前无人维护,升级 Home Assistant、Moonraker 或 Klipper 前先在测试环境验证,保留替代集成方案。
注意事项与边界
- 当前无人维护:README 明确说明该项目当前无人维护,问题响应和后续修复存在不确定性,长期部署前要有心理准备。
- 两款硬件不在支持名单里:据仓库说明,FLSUN Speeder Pad 与 Sonic Pad 明确不受支持,用这两款设备的用户不要硬装,先找别的集成方案。
- 版本门槛要先对上:Home Assistant 低于 2025.1 的不在明确支持范围内,动手前先看一眼自己实例的版本号再装。
- 摄像头与缩略图要打印机那边先备好:相关能力需要打印机环境本身装好摄像头并提供画面,缺了这环,对应实体装上也是空的。
- 实体与接口清单不全:公开摘要没有把全部实体、Moonraker 接口和兼容边界列完,正式用之前翻文档或源码逐项核对。
适合谁,不适合谁
适合:家里已经有 Home Assistant、Moonraker、Klipper 与 Mainsail 一整套环境,想在家庭自动化界面里顺手看一眼打印机、按个宏按钮或紧急停止的开发者与高级用户,尤其是有自动化联动需求的个人自动化环境。
不适合:设备是 FLSUN Speeder Pad 或 Sonic Pad 的用户;团队要求持续维护、明确支持承诺和稳定升级路径的场景;还没有 Home Assistant 环境、只想单独管打印机的人,应当先用 Mainsail。
获取方式
GitHub 国内访问较慢,如打不开可多刷新几次

关注「软件教程管家」
回复软件名即取即下:网盘下载链接 + 提取码,一步直达,不用再跳转。
本站资源仅供个人学习交流,请勿用于商业用途。软件与资料版权归原作者所有;如有侵权,请通过公众号「软件教程管家」联系我们,我们将在 24 小时内下架处理。查看免责声明 ›







