Moonraker Bar：跨平台桌面托盘客户端

25次阅读

获取下载链

微信关注「软件教程管家」公众号，回复 moonraker-bar

30秒速读

用 Klipper 的 3D 打印机，查进度总要切到浏览器打开 Mainsail 或 Fluidd，正在打印时尤其麻烦。Moonraker Bar 把打印机状态收进桌面菜单栏或系统托盘：进度、剩余时间、温度、层数一眼可见，暂停、取消、常用宏都在托盘里点一下就能做。它不替代 Mainsail/Fluidd 的完整管理界面，而是给你一个不用开浏览器就能盯打印的快捷入口。前提也得先说清：打印机必须跑着 Moonraker，并且和电脑在同一个局域网里。

前往 GitHub 仓库

GitHub 国内访问较慢，如打不开可多刷新几次

项目信息表

项目	Moonraker Bar（面向 Klipper 的跨平台桌面托盘客户端）
适用平台	macOS、Windows、Linux
技术实现	Tauri 2（Rust 承载桌面能力）+ React、TypeScript、Tailwind 界面
连接方式	局域网直连 Moonraker，不要求账号或云端服务
前置条件	打印机运行 Klipper + Moonraker，桌面应用能通过局域网访问到它
配套读取	Mainsail / Fluidd 的预热预设与摄像头配置

托盘里能看到什么、能做什么

状态一眼可见：打印进度、剩余时间、ETA、层数、温度、打印速度，以及 Klipper 报错状态，不用开浏览器。
常用控制一点即达：暂停、继续、取消、回零、关闭电机、固件重启与紧急停止，都在托盘菜单里。
宏与预热不用翻界面：公开的 gcode_macro 可以查看并固定成快捷按钮；Mainsail / Fluidd 的预热预设可以直接读取，还有冷却操作。
多台打印机一起盯：支持管理多台打印机、设备切换与关注设备固定，打印开始、暂停、完成、取消或失败时发通知。
摄像头与 AFC：能看 Mainsail / Fluidd 里已配置的摄像头（MJPEG 实时流，约每 2 秒一次的快照回退）；接了 AFC 还能看通道状态、做装载、卸载与 AFC_RESUME 操作。

安装包怎么选

平台	安装包	注意点
macOS	Apple Silicon 与 Intel 通用 DMG	按芯片选对应包，装完先确认局域网访问权限
Windows	x64 安装程序或 MSI	二选一即可，功能上无差别，按自己习惯选
Linux	amd64 安装文件	据项目说明提供 amd64 包，其他架构部署前先看发行说明确认

结论先行：按操作系统选对应包就行，没有“哪个版本更强”的纠结；真正的选型动作在后面——确认你的网络能不能连到 Moonraker。

上手指南

先确认打印机侧：打印机已经跑着 Klipper + Moonraker，并且 Moonraker 服务在局域网内可访问，这一步不通，后面全是白搭。
装客户端并添加打印机：装好对应平台的安装包，添加打印机时可用自动发现（mDNS 或 7125 端口扫描），发现不到就手动填 Moonraker 地址。
固定常用操作：把最常用的宏固定成快捷按钮，把常用的预热预设记下来，托盘的价值就在于此——别让它只当个进度显示器。
开通知并试一次全流程：开启打印事件通知，然后用一次暂停、继续、取消，确认控制链路真的通，再把它放进日常打印流程。

装完先确认的四项设置

启动时运行：据项目说明支持启动时运行，想让它长期盯着打印就打开，否则每次打印前还要手动启动，快捷入口就失去意义。
关注设备固定：多台打印机时，把主力机固定为关注设备，避免托盘显示在不常看的那台上，关键时刻找错机器。
通知事件范围：确认开始、暂停、完成、取消、失败这些事件里哪些要通知，打印失败的通知尤其别关——那是它最值钱的一次提醒。
界面卡片布局：据项目说明支持卡片布局调整，把进度、温度、摄像头这些最常看的信息排到顺手的位置，托盘菜单翻两下才能看到等于没做。

注意事项与常见问题

没有 Moonraker 就没法用：它只是 Moonraker 的客户端，不自带打印控制后端，打印机没跑 Moonraker、或局域网访问不通，它就只能显示离线。
自动发现不到先查网络：自动发现依赖 mDNS 或 7125 端口扫描，跨网段、VLAN 隔离或受限网络里可能发现失败，这时手动填地址往往比反复点“重新发现”更有效。
摄像头不是它自己接的：摄像头画面来自 Mainsail 或 Fluidd 里已经配置好的摄像头，其他视频协议据项目说明未明确支持，摄像头没配好就别指望它凭空出画面。
AFC 功能需要真设备：没有连接并被识别的 AFC 设备，装载、卸载、AFC_RESUME 这些专属操作用不了，这是设备前提，不是软件缺功能。
它不是 Mainsail / Fluidd 的替代品：完整打印管理、复杂配置、跨网络访问、设备编排，仍然要回 Web 界面做；托盘客户端的定位是快捷监看与常用操作，别拿它当全功能管理台。