
通过 Moonraker 将 Mainsail 和 Fluidd 与 Printer Tools 一起使用
Mainsail、Fluidd 与 Printer Tools
简短答案
Mainsail 和 Fluidd 都是 Moonraker 的开源网页界面,Printer Tools 则是同一个 Moonraker 实例的另一个独立客户端。三者可以同时对着同一台打印机运行,因为通过其中一个做出的更改,只是对 Moonraker 数据的更改,每个已连接的客户端都能看到。
你需要准备
- 一台已安装 Moonraker 且可以访问的 Klipper 打印机
- 如果你打算继续使用 Mainsail 或 Fluidd 进行配置或控制台访问,请安装其中之一
- 在 Android、iPhone、iPad 或 Mac 上安装好 Printer Tools
- 如果你的 Moonraker 搭建需要身份验证,所有客户端使用相同的凭据
在使用 Mainsail 或 Fluidd 的同时使用 Printer Tools
- 1
保留你现有的网页界面
如果你已经在用 Mainsail 或 Fluidd 编辑 printer.cfg、运行控制台命令或管理宏,添加 Printer Tools 时不需要移除它。
- 2
在 Printer Tools 中添加同一个 Moonraker 主机
使用 Printer Tools 自己的连接流程连接打印机,输入你在浏览器中访问 Mainsail 或 Fluidd 时使用的同一个本地地址。
- 3
让各客户端的身份验证保持一致
如果 Moonraker 需要 API key、Bearer token 或 Basic Auth,在 Printer Tools 中使用与你基于浏览器的界面中已经有效的相同凭据。
- 4
在多个工具之间分配工作
使用 Printer Tools 进行日常的移动端监控、快速暂停或继续操作以及通知,在电脑上保留 Mainsail 或 Fluidd,用于更深入的配置、宏编辑和控制台访问。
- 5
确认更改在各处都能看到
在一个客户端中加载的配置文件、选择的耗材卷,或更改的设置,应该在你下次打开另一个客户端时同样可见,因为三者读取的都是同一个 Moonraker 状态。
Printer Tools 与 Moonraker 网页界面并排使用


Printer Tools 和 Moonraker 网页界面可以同时保持打开,两者反映的都是同一个实时打印机状态。
三者之间保持一致的内容
- 打印状态、进度和温度,因为三者读取的是同一批实时 Moonraker 对象
- 在共享的 Moonraker 实例上配置好时的 Bed Mesh 配置文件和 Spoolman 数据
- 由 Moonraker 报告的文件列表和打印历史
- 暂停、继续、停止和标准控制操作,无论是哪个客户端发出的指令
Printer Tools 不会替代的部分
- 直接编辑 printer.cfg 不属于 Printer Tools 的功能,仍然需要 Mainsail、Fluidd 或直接的文件访问
- Printer Tools 中没有可以运行任意自定义命令的完整 Klipper 控制台
- Mainsail 或 Fluidd 特有的插件生态并不会延续到 Printer Tools 的仪表盘中
常见的多客户端问题
在 Fluidd 中更改的设置没有出现在 Printer Tools 中
在 Printer Tools 中刷新或重新打开该打印机。如果仍然不一致,请确认两个客户端实际指向的是同一个 Moonraker 主机,而不是两台不同的打印机。
身份验证在浏览器中正常,在 Printer Tools 中却不行
浏览器界面可能依赖的是登录后创建的会话,而不是 Printer Tools 需要直接输入的静态 API key、Bearer token 或 Basic Auth 凭据。
同时运行多个客户端似乎拖慢了 Moonraker
Moonraker 本身是为支持多个并发客户端而设计的,因此这种情况并不常见。如果确实发生,请检查主机自身的资源使用情况,而不是先假设客户端之间存在冲突。
远程同时使用这三者
连回你网络的 VPN,可以让这些客户端中的任何一个,以与在家时相同的方式访问 Moonraker。Printer Tools 也支持 OctoEverywhere 和 Obico 进行远程访问,而无需直接暴露 Moonraker。
常见问题
我必须在 Printer Tools 和 Mainsail 或 Fluidd 之间做选择吗?
不需要。它们是同一个 Moonraker 实例的独立客户端,可以搭配使用而不会产生冲突。
日常监控我应该用哪一个?
Printer Tools 专为快速的移动端检查和通知而设计。Mainsail 和 Fluidd 在电脑上进行配置和控制台操作时依然有用。
在它们之间切换会导致同步问题吗?
不会。只有一个真相来源,也就是 Moonraker 本身,因此每个客户端反映的都是同一个底层状态。
Mainsail 和 Fluidd 之间有实质性的功能差异吗?
两者都是持续维护的开源 Moonraker 界面,布局和宏面板设计不同。在两者之间做选择,主要是个人偏好问题,与 Printer Tools 的兼容性无关。
我可以完全不用网页界面吗?
日常监控和控制可以不用,但保留一个网页界面对编辑 printer.cfg 或运行 Printer Tools 未覆盖的控制台命令等任务仍然有用。
查看完整的 Klipper 和 Moonraker 兼容性
查看受支持的 Moonraker 功能、可选的摄像头和 Spoolman 要求、远程访问方式以及当前的限制。


