Home Assistant

在您的Home Assistant设备上运行SimplyPrint客户端,使其成为连接您打印机的桥梁。这是作为附加组件的客户端,而非作为Home Assistant实体的打印机

在GitHub上查看插件

关于此集成

上线日期

2026年9月19日

开发者

SimplyPrint

SimplyPrint 未获得 Home Assistant 的认可,也与其没有关联。我们使用商标和图片仅为表明与我们平台的兼容性。将 Home Assistant 硬件与 SimplyPrint 搭配使用,可能并非 Home Assistant 的预期用途。所有权利归各自所有者所有。

SimplyPrint Home Assistant:在已开机的设备上运行客户端

SimplyPrint Client附加组件可直接在您的Home Assistant设备上运行我们的打印机客户端,因此您已经全天候运行的硬件也可让您的打印机保持连接。无需每台打印机配备额外的Raspberry Pi,也无需维护第二套设备。

这是什么,不是什么。

此附加组件让您的Home Assistant设备成为打印机与SimplyPrint之间的桥梁。它只做这一件事。

它不会将您的打印机作为实体添加到Home Assistant中,您不会获得打印机传感器、可放到仪表板上的温度或进度数据,也没有可用于自动化的内容。如果您需要的是这个功能,它是另一项独立功能,我们尚未开发:请关注建议#324。

帮助中心中的完整设置指南→

此附加组件使用Home Assistant的Ingress,因此其界面由Home Assistant本身提供。启用在侧边栏中显示后,您的Home Assistant菜单中会出现SimplyPrint条目。您无需开放端口,客户端界面仅接受通过Home Assistant 发出的请求。

此附加组件较新,仍处于实验阶段(1.0.0-rc.17)。它可正常使用,也已准备就绪,只是尚未像我们的其他安装方式一样经过大量用户验证。如果发现任何异常,请提交问题,我们会修复。

Open your Home Assistant instance and add the SimplyPrint add-on repository


您需要的条件

  • Home Assistant OS或受监督安装。附加组件需要Supervisor,因此Home Assistant Container和Home Assistant Core无法安装此组件。
  • 64位设备,aarch64或amd64。不支持32位Raspberry Pi OS安装。
  • 一台SimplyPrint已支持通过本地连接的打印机。

为何在此运行

  • 一台设备,始终开机。您的Home Assistant设备是家中供电最可靠的设备。
  • 与其他内容一同备份。此附加组件会包含在Home Assistant备份中。
  • 从侧边栏设置。Ingress意味着客户端界面是Home Assistant中的一个面板,无需记住另一个地址。

  • 在您已开机的Home Assistant设备上运行SimplyPrint Client
  • 通过My Home Assistant一键安装仓库
  • 在Home Assistant侧边栏中显示为SimplyPrint面板(Ingress)
  • 包含在Home Assistant备份中
  • Home Assistant OS和Supervised安装,aarch64和amd64
  • 由SimplyPrint维护的官方加载项存储库
  • 不会将打印机作为Home Assistant实体公开,此项为桥接组件,不是仪表板集成

如何在Home Assistant中安装SimplyPrint加载项

1

检查您的安装类型

加载项需要Supervisor,因此您需要在64位设备上安装Home Assistant OS或Supervised。Container和Core安装无法添加此加载项。

2

添加存储库

在Home Assistant中,前往设置→应用(Home Assistant已将附加组件更名为应用,因此旧版指南中显示为附加组件),打开应用商店,然后打开三点菜单,选择仓库,并粘贴https://github.com/SimplyPrint/home-assistant-apps。

3

安装SimplyPrint Client

商店中会显示SimplyPrint Client插件。打开它并点击安装。这是实验性候选版本,请先阅读插件页面上的警告。

4

启动加载项并打开面板

启用启动时启动、看门狗和在侧边栏显示,启动附加组件,然后从您的Home Assistant菜单打开SimplyPrint,按照设置步骤将打印机连接到您的SimplyPrint账户。

常见问题

SimplyPrint Home Assistant加载项是否已可使用?

是的。它已发布到我们的官方附加组件仓库,您现在即可安装。它仍属新功能且处于实验阶段(1.0.0-rc.17),尚未像我们的其他安装方式那样经过充分使用和测试。如果您发现问题,请告诉我们,我们会修复。

它能在Home Assistant Container或Core上运行吗?

不能。加载项由Home Assistant Supervisor管理,该功能仅存在于Home Assistant OS和Supervised安装中。在Container或Core上,请改为直接在您网络中的设备上运行SimplyPrint客户端。

支持哪些硬件?

仅支持64位:aarch64和amd64。适用于运行64位Home Assistant OS的Raspberry Pi 4或5、Intel NUC或通用x86设备。32位安装将无法看到此加载项。

是否需要开放端口或设置隧道?

不可以。该附加组件使用Home Assistant的Ingress,因此其界面通过Home Assistant本身提供,客户端只接受以这种方式到达的请求。开启在侧边栏中显示,即可在您的Home Assistant菜单中将其作为面板使用。

是否会随Home Assistant一同备份?

是的,插件会包含在Home Assistant的备份中,因此其配置会随您的其他设置一同迁移。

支持一键安装吗?

是的。如果您使用的设备可以访问Home Assistant,此页面上的打开My Home Assistant应用商店按钮会为您添加我们的仓库,然后从商店安装SimplyPrint Client。手动操作路径为:设置→应用(原附加组件)→应用商店→三点菜单→仓库。

这会将我的打印机作为传感器或实体添加到Home Assistant中吗?

不可以,这是最常见的误解。该附加组件会在您的Home Assistant设备上运行SimplyPrint客户端,使您的打印机能够连接SimplyPrint,它是桥接组件,不是仪表板集成。它不会创建任何实体,因此没有可显示在Home Assistant仪表板上或用于驱动自动化的温度、进度或AMS数据。这是另一项独立工作,您可以在建议#324中关注并投票。


关于 SimplyPrint 集成

SimplyPrint的集成功能让应用可与您的3D打印机交互,您的3D打印机也可与其他应用交互。这带来无限可能,我们坚信您的3D打印机应能作为IOT设备,与您能想到的所有应用协同工作!

这正是SimplyPrint团队致力于为最受欢迎的平台、切片软件和应用程序提供官方集成的原因,同时也允许用户通过我们的API创建自定义集成,或允许经批准的第三方供应商使用“使用SimplyPrint登录”方式(使用“OAuth2”方法)创建供所有SimplyPrint用户使用的集成。

如果您是开发者且有兴趣为SimplyPrint创建集成,请阅读我们关于此主题的文档。

如果您本人不是开发者,但希望看到特定应用的集成,请查看它是否已列入我们的路线图或建议列表;如果没有,欢迎您提出建议!