Как настроить Spoolman с Klipper и Moonraker (Mainsail/Fluidd)

Если у вас Klipper, Spoolman — стандартный способ перестать гадать, сколько филамента осталось на катушке: это бесплатная самостоятельно хостимая база катушек, а у Moonraker есть встроенная поддержка для неё, так что после настройки Mainsail и Fluidd сами покажут выбор катушки и будут обновлять остаток по мере печати. Вот инструкция целиком.

Что нужно заранее

• Klipper и Moonraker уже установлены и работают — Spoolman подключается к Moonraker, а не заменяет что-то в существующей настройке.
• Место, где будет крутиться сам сервер Spoolman: Docker-контейнер на том же Raspberry Pi/одноплатнике, что и Moonraker, либо на отдельной постоянно включённой машине в сети (NAS, домашний сервер — что угодно, что не выключается).
• Python 3.9+, если запускаете Spoolman не в Docker, хотя Docker — путь для большинства, так как у Spoolman есть официальный образ.

1. Запустите сервер Spoolman

Официальный путь — Docker Compose: скачиваете образ spoolman, выделяете постоянный volume под его базу данных и открываете порт (по умолчанию 7912). После запуска контейнера в браузере по адресу http://<адрес-spoolman>:7912 должен открыться веб-интерфейс — пока пустой.

2. Укажите адрес Spoolman в Moonraker

Откройте moonraker.conf на хосте принтера и добавьте секцию [spoolman]:

[spoolman]
server: http://<адрес-spoolman>:7912

Вместо <адрес-spoolman> подставьте IP-адрес или хостнейм машины, на которой крутится контейнер Spoolman — localhost, если она на той же машине, что и Moonraker, иначе IP в локальной сети.

3. Перезапустите Moonraker

sudo systemctl restart moonraker

Проверьте лог Moonraker на строку о подключении к Spoolman без ошибок. Если сервер не доступен — проверьте адрес и что порт реально открыт с хоста принтера: быстрее всего это проверить командой curl http://<адрес-spoolman>:7912 прямо с этой машины.

4. Убедитесь, что он появился в Mainsail или Fluidd

Оба интерфейса подхватывают интеграцию со Spoolman автоматически, как только её видит Moonraker — отдельный плагин ставить не нужно. В панели статуса печати должен появиться выбор катушки. Если пока не появился, обычно хватает жёсткого обновления вкладки браузера — второй перезапуск Moonraker не требуется.

5. Добавьте свои катушки

В веб-интерфейсе Spoolman заведите тип филамента (бренд, материал, диаметр, плотность), а затем катушку этого филамента с начальным весом. Сделайте это для каждой катушки, которая сейчас в обороте — это единственный ручной шаг во всей настройке, дальше всё обновляется само.

6. Выбирайте катушку перед печатью

Перед стартом задания выбирайте активную катушку из селектора, который теперь показывают Mainsail/Fluidd. С этого момента Moonraker сам сообщает Spoolman оценку расхода по мере печати, и остаток на катушке уменьшается автоматически — без весов и ручного вычитания.

Чего это не покрывает

Теперь Spoolman знает, сколько физически осталось на каждой катушке. Но он не скажет, во сколько на самом деле обошлась печать — это никогда не входило в его задачи: для этого нужны цена за килограмм, время печати и тариф на электричество в одном месте. Если это следующий пункт в списке — вот как Spoolman и расчёт себестоимости заказов дополняют друг друга, а не дублируют.