如何排查 PrusaLink 的证书、认证和文件问题

PrusaLink 是运行在受支持 Prusa 打印机上，或为兼容旧机型运行在专用 Raspberry Pi 上的本地服务。Printer Tools 连接的是这项服务，而不是独立的云端产品 Prusa Connect。

PrusaLink 连接可能在多个层面出现问题：地址和 TLS、API 密钥认证、备用 HTTP 凭据、文件端点，或当前任务的缩略图。请按此顺序逐一测试。

Printer Tools

在一个面板中管理您的所有 3D 打印机

通过一个应用监控 Bambu Lab、Klipper、OctoPrint、Creality、Snapmaker、Anycubic、Flashforge、Elegoo 和 Prusa 打印机

支持 Android、iPhone、iPad 和 Mac，并提供 Apple Watch 与 Wear OS 配套应用，以及通过 VPN、OctoEverywhere 或 Obico 实现的可选远程访问

确认你使用的是 PrusaLink

在同一网络中的浏览器里打开 PrusaLink 的本地界面。如果你只有 Prusa Connect 的云端 URL，请改为查找打印机的本地 PrusaLink 地址。

当前的 CORE One、XL、MK4 系列、MINI 系列以及其他列出的机型可以直接提供 PrusaLink。较早的 MK3 和 MK2.5 系列需要兼容的 Raspberry Pi 安装，并且可能提供不同的端点。

检查地址和本地证书

请使用设置所要求的打印机或 Raspberry Pi 本地地址。自签名或本地签发的证书在私有设备上可能是正常的，但如果证书出乎意料或主机名不匹配，应在输入凭据之前先进行核查。

不要为了消除警告而关闭整部手机的安全设置，或导入来历不明的根证书。请确认该地址属于你的 PrusaLink 设备，并使用 Printer Tools 支持的连接流程。

先尝试 API 密钥

当前内置的 PrusaLink 通常使用 API 密钥。请从 PrusaLink 中复制密钥，不要带多余的空格，并且只保存在 Printer Tools 对应的字段中。

如果密钥已重新生成，请更新已保存的条目。HTTP 401 表示认证缺失或无效；403 可能表示身份已被识别，但无权执行所请求的操作。

了解 HTTP 备用认证

在安装要求时，Printer Tools 可以改用 HTTP 认证，使用已配置的用户名和密码。应用初始使用的用户名是 maker，但应以实际安装为准。

不要把 API 密钥填入密码字段，也不要以为 Raspberry Pi 安装使用的凭据与内置 PrusaLink 的打印机相同。

区分文件浏览和缩略图

文件浏览使用 PrusaLink 的本地端点。当 PrusaLink 提供时，可能会显示当前任务的模型缩略图，但这张图片并不是实时的网络摄像头画面。

如果状态正常而文件无法访问，请记录端点的具体错误并检查权限。如果缺少缩略图，请先确认当前任务是否提供缩略图，再判断是否为摄像头问题。独立的 IP 摄像头可以单独添加。

保持 PrusaLink 本地访问

这种方式不需要 Prusa Connect 账号。在外访问时请使用 VPN，不要通过路由器端口转发直接暴露 PrusaLink。

如需更全面的检查清单，请继续阅读现有的 PrusaLink 认证与文件访问指南。

常见问题

PrusaLink 和 Prusa Connect 是一回事吗？

不是。这里使用的是本地服务 PrusaLink。Prusa Connect 是独立的云服务。

我应该使用哪种凭据？

当前的安装请使用 API 密钥，或使用你的 PrusaLink 设置所要求的 HTTP 用户名和密码。

当前任务的缩略图是实时摄像头吗？

不是。它是为该任务提供的模型图片，而不是通用的网络摄像头视频流。

我应该忽略所有证书警告吗？

不应该。请核实本地地址和设备身份。不要为了绕过原因不明的警告而整体降低安全性。

官方资料: Prusa Knowledge Base — PrusaLink troubleshooting · Prusa Knowledge Base — Prusa Connect and PrusaLink