如何修复 Printer Tools 中的 Moonraker 身份验证和 API 密钥错误

你需要准备

• 可以访问你的 moonraker.conf，或 Mainsail、Fluidd 的设置页面，以检查当前的身份验证配置
• 当前的 API key、Bearer token，或 Basic Auth 的用户名和密码，取决于你的 Moonraker 安装使用哪一种
• 一台已经在 Printer Tools 中添加好的 Klipper 打印机
• 确认你设备的 IP 是否落在 moonraker.conf 中配置的 trusted_clients 范围内

修复身份验证错误

1. 1

   确认是否真的需要身份验证

   查看 moonraker.conf 中的 trusted_clients 和 force_logins。如果你设备所在的网络已经落在可信范围内，本不应该需要任何凭据，出现身份验证错误更可能指向网络或 IP 范围不匹配。

2. 2

   获取当前的凭据

   从 Moonraker 自带的工具生成或复制 API key，通常可以在 Mainsail 或 Fluidd 的设置页面中找到，或者确认服务器上配置的 Bearer token 或 Basic Auth 用户名和密码。

3. 3

   在 Printer Tools 中准确输入

   在 Printer Tools 中打开打印机设置，输入凭据时不要带有多余的前导或尾随空格。哪怕多出一个字符，也足以导致看起来与缺少密钥完全相同的拒绝结果。

4. 4

   重新连接并检查结果

   重新连接打印机，确认仪表盘能够加载。如果仍然失败，直接用同一凭据对 Moonraker 的 API 发起一次基础请求，确认密钥本身是否有效。

5. 5

   如果密钥丢失或已轮换，重新生成

   如果密钥在你复制之后在服务器上被重新生成过，请生成一个新的密钥，并在所有使用它的地方更新，包括 Printer Tools 和其他任何 Moonraker 客户端。

Printer Tools 中的连接状态

在 Printer Tools 中添加或编辑 Klipper 打印机时，身份验证字段会与主机地址一起出现。

Printer Tools 支持的方式

• 在每个 Moonraker 请求中，以标准请求头形式发送可选的 API key
• 针对如此配置的搭建，支持可选的 Bearer token 身份验证
• 针对如此配置的搭建，支持可选的 Basic Auth 用户名和密码
• 当你的网络已经落在 Moonraker 的 trusted_clients 范围内时，完全不需要任何凭据

不支持的方式

• Printer Tools 没有实现 Moonraker 的一次性令牌或浏览器会话登录流程
• 它无法自行发现或生成 Moonraker API key，密钥必须已经存在于服务器上
• 一个有效但与 Moonraker 当前配置的方式不匹配的凭据，仍然会被拒绝

常见身份验证错误

常见问题