
OctoPrint 应用密钥和全局 API 密钥说明
OctoPrint 支持具有不同操作范围的凭证。应用专用密钥比在各处重复使用全局秘密更容易识别和撤销。
Printer Tools 通过本地协议与支持的打印机和摄像机通信。保持设备私密,保护凭证,并使用当前兼容性矩阵作为特定型号功能的权威参考。
优先使用应用专用的批准流程
当 OctoPrint 应用程序密钥工作流可用时,批准 Printer Tools 作为其自身客户端。这会创建与该应用程序和用户上下文关联的凭证。
了解全局密钥
全局 API 密钥是一个广泛共享的凭证。旋转它可能会破坏所有重复使用它的客户端,泄露它也会影响多于一个的集成关系。
将权限与支持的功能匹配
使用仅具备 Printer Tools 监控及支持的文件浏览或控制所需权限的 OctoPrint 用户。Printer Tools 不会上传文件并启动新的 OctoPrint 作业。
干净地撤销
如果手机丢失或密钥泄露,请在 OctoPrint 中撤销该应用密钥并授权新的密钥。切勿在日志或截图中发布任何密钥。
本地故障排除清单
- 在不受信任的网络段使用 HTTPS。
- 尽可能批准应用专用密钥。
- 限制 OctoPrint 用户权限。
- 在需要时撤销单个凭证。
常见问题
应用密钥和全局 API 密钥一样吗?
不一样。应用凭证绑定到客户端批准,而全局密钥则是广泛共享的。
Printer Tools 可以在没有授权的情况下工作吗?
只有允许匿名访问的端点可见,这通常不足且控制较少。
OctoPrint应该在互联网上公开吗?
不。使用私有的VPN或支持的远程访问解决方案。





