Mainsail и Fluidd: веб-интерфейсы для Klipper — сравнение и настройка

Коротко: Mainsail и Fluidd — бесплатные веб-интерфейсы для принтеров на Klipper. Оба работают через сервис Moonraker и открываются в браузере по IP-адресу принтера: консоль, загрузка и запуск файлов, макросы-кнопки, графики температур, карта стола, камера, таймлапсы, редактор конфигов и обновление всего ПО в один клик. Функционально они очень близки: Mainsail плотнее и популярнее, Fluidd проще и гибче настраивается внешне. Ставятся за пару минут через KIAUH, можно поставить оба и выбрать. Ниже — возможности, отличия, установка, камера и безопасность.

Как это устроено

Klipper сам по себе не имеет интерфейса. Moonraker — сервис на том же компьютере (Raspberry Pi или мини-ПК), который предоставляет API: состояние принтера, файлы, команды. Mainsail и Fluidd — веб-страницы, которые обращаются к этому API. Поэтому их можно менять без переустановки Klipper, а слайсер может отправлять файлы напрямую в Moonraker. Если Klipper ещё не установлен — установка Klipper пошагово.

Возможности

• Консоль — любые команды Klipper, вывод ошибок и ответов калибровок.
• Файлы — загрузка G-code, превью с миниатюрой из слайсера, оценка времени, история печати и статистика.
• Макросы — все макросы из конфига появляются кнопками; можно группировать и скрывать. Макросы Klipper.
• Карта стола — визуализация bed mesh в 3D: сразу видно перекос и «яму». Калибровка стола.
• Редактор конфигов — правка printer.cfg прямо в браузере с подсветкой и кнопкой «Сохранить и перезапустить».
• Обновления — Update Manager обновляет Klipper, Moonraker, интерфейс и системные пакеты.

Mainsail или Fluidd

Многие готовые принтеры с Klipper идут с одним из них по умолчанию. Если ставите сами — попробуйте оба: через KIAUH они устанавливаются параллельно на разные порты, и вы выберете тот, что удобнее. Для управления с сенсорного экрана у принтера есть отдельная программа KlipperScreen — она дополняет веб-интерфейс, а не заменяет его.

Установка

1. Подключитесь к компьютеру принтера по SSH.
2. Запустите KIAUH (скрипт установки Klipper и компонентов) и выберите «Install».
3. Установите Moonraker (если ещё не установлен), затем Mainsail или Fluidd.
4. Подключите в printer.cfg файл с базовыми макросами интерфейса ([include mainsail.cfg] или [include fluidd.cfg]) — он добавляет паузу, возобновление и отмену печати.
5. Откройте в браузере IP-адрес принтера.

IP можно посмотреть в роутере или на экране принтера. Удобно закрепить за принтером постоянный адрес в настройках роутера.

Камера и таймлапсы

USB-камера или камера Raspberry Pi подключается через сервис потокового видео (в современных образах — crowsnest). В интерфейсе камера добавляется в настройках: адрес потока и режим (MJPEG, WebRTC). Для таймлапсов ставят компонент moonraker-timelapse и вставляют команду снимка в G-code смены слоя в слайсере. Подробнее о камерах — камера для 3D-принтера.

Отправка файлов из слайсера

В Orca Slicer, PrusaSlicer и Cura (через плагин) можно добавить принтер типа «Moonraker» или «Octoprint-совместимый» с IP-адресом: кнопка «Отправить» загрузит G-code прямо в принтер и при желании запустит печать. В Orca вкладка «Устройство» показывает сам Mainsail или Fluidd внутри слайсера. Orca Slicer, PrusaSlicer.

Удалённый доступ и безопасность

Интерфейс по умолчанию доступен всем в локальной сети и не требует пароля. Не пробрасывайте порт принтера в интернет через роутер: любой сможет управлять нагревом. Для доступа извне используйте VPN до домашней сети (WireGuard, Tailscale и подобные) или сервисы удалённого доступа, предназначенные для Klipper. В Moonraker можно включить авторизацию и ограничить доверенные адреса. OctoPrint — альтернатива для принтеров на Marlin.

Типичные проблемы

• Интерфейс открывается, но пишет «Klipper not ready» — ошибка в конфиге или нет связи с платой; читайте текст ошибки в консоли.
• Нет камеры — проверьте, что сервис видео запущен и адрес потока верный.
• Не видно макросов паузы — не подключён mainsail.cfg или fluidd.cfg.
• Обновление не проходит — нет интернета на Raspberry Pi или изменены файлы в папке Klipper вручную.

Частые вопросы

Что такое Mainsail?

Веб-интерфейс для управления принтером на Klipper через браузер.

Чем Fluidd отличается от Mainsail?

Функционально близки; Fluidd проще и гибче внешне, Mainsail плотнее и популярнее.

Можно ли установить оба?

Да, через KIAUH на разные порты.

Как открыть Mainsail?

Ввести IP-адрес принтера в браузере.

Можно ли управлять принтером из интернета?

Да, через VPN; открывать порт в интернет небезопасно.

Работает ли Mainsail с Marlin?

Нет, он рассчитан на Klipper и Moonraker.