如何安装 OctoPrint 并使用 API 密钥连接到 Printer Tools

你需要准备

• 已安装并运行的 OctoPrint，例如通过 Raspberry Pi 上的 OctoPi 镜像
• 已通过串口或 USB 连接到 OctoPrint 主机并在 OctoPrint 自身界面中被识别的打印机
• 运行 OctoPrint 的主机的本地 IP 地址或主机名
• OctoPrint 设置中 API 部分提供的全局 API 密钥

将 OctoPrint 连接到 Printer Tools

1. 1

   先完成 OctoPrint 自身的设置

   在将打印机添加到 Printer Tools 之前，先完成 OctoPrint 的设置向导，并从 OctoPrint 自身的网页界面确认打印机能够通过串口成功连接。

2. 2

   复制 API 密钥

   打开 OctoPrint 的设置，进入 API 部分，复制那里显示的全局 API 密钥。

3. 3

   在 Printer Tools 中添加 OctoPrint

   打开 Printer Tools，选择添加一台 OctoPrint 打印机，输入服务器的本地地址以及你复制的 API 密钥。

4. 4

   确认仪表盘能够加载

   保存打印机并从 Dashboard 中打开它。如果 OctoPrint 在自身界面中已经报告状态、进度和温度，这些信息应该会显示出来。

5. 5

   单独检查摄像头

   如果 OctoPrint 配置了网络摄像头，它应该会在标准视频流地址自动出现。摄像头缺失不会影响状态或作业控制。

Printer Tools 中的 OctoPrint

Printer Tools 连接所需的，正是官方 OctoPrint 网页界面使用的同一个 API 密钥。

连接后可用的功能

• 由 OctoPrint 实时报告的打印状态、进度和温度
• 对当前正在运行的作业进行暂停、继续和停止
• 对 OctoPrint 服务器上已有文件的只读浏览
• 当 OctoPrint 配置了网络摄像头时可查看 MJPEG 摄像头画面
• 从同一个 Printer Tools 仪表盘管理多个 OctoPrint 实例

不包含的功能

• 目前从 Printer Tools 上传新的 G-code 文件或启动新的打印任务尚不支持
• OctoPrint 中的社区插件不会作为独立控件出现在应用中
• OctoPrint 与打印机之间的串口连接问题需要在 OctoPrint 本身中解决
• 由于 OctoPrint 本身不原生提供这些信息，Printer Tools 不管理 OctoPrint 的耗材或料盘数据

常见设置问题

常见问题