Helper Script для Creality K1 — это набор скриптов от энтузиаста Guilouz, который устанавливается на принтер через SSH и превращает закрытую стоковую систему в полноценный Klipper с веб-интерфейсом Fluidd или Mainsail. Без него владелец K1 ограничен фирменной прошивкой Creality с урезанным доступом к конфигурации, а после установки появляется полный контроль над printer.cfg, макросами и мониторингом печати через браузер.
Скрипт не заменяет прошивку целиком — он дополняет стоковую систему, устанавливая недостающие компоненты экосистемы Klipper: Moonraker, веб-интерфейсы, менеджер камеры и дополнительные утилиты. Это делает его относительно безопасным: при желании изменения можно откатить, а принтер вернуть к заводскому состоянию.
Что именно делает Helper Script
Стоковая прошивка Creality K1 уже построена на базе Klipper, но производитель закрыл доступ к большинству функций и убрал привычный веб-интерфейс. Helper Script восстанавливает эти возможности, устанавливая компоненты, которые Creality не включила в систему.
- 🌐 Fluidd или Mainsail — веб-интерфейс для управления печатью с компьютера и телефона
- 🔧 Moonraker — полноценный API-сервер для связи интерфейса с Klipper
- 📷 Поддержка камеры с настройкой стрима и таймлапсов
- 🧰 Дополнительные макросы и утилиты: Klipper Gcode Shell Command, менеджеры обновлений
- 💾 Инструменты резервного копирования конфигурации
Стоит понимать: скрипт — сторонняя разработка сообщества, а не продукт Creality. Он распространяется через GitHub-репозиторий автора, и его поведение может меняться от версии к версии. Перед установкой имеет смысл прочитать актуальное описание в репозитории и отзывы пользователей с вашей версией прошивки.
Helper Script не заменяет прошивку, а дополняет стоковую систему K1 веб-интерфейсом Fluidd/Mainsail, Moonraker и полным доступом к конфигурации Klipper.
Подготовка: root-доступ и SSH
Перед запуском скрипта нужно получить доступ к командной строке принтера. На Creality K1 это делается через включение root-доступа в настройках на экране принтера — в новых версиях прошивки Creality добавила официальную опцию, после активации которой отображается пароль для подключения по SSH. Точный путь в меню зависит от версии прошивки, поэтому сверяйтесь с экраном вашего устройства и документацией к прошивке.
Для подключения с компьютера понадобится SSH-клиент: на Windows подойдёт PuTTY или встроенный терминал, на macOS и Linux — стандартная команда ssh. Принтер и компьютер должны находиться в одной сети, а IP-адрес принтера виден на экране в разделе сетевых настроек.
ssh root@IP_АДРЕС_ПРИНТЕРА⚠️ Внимание: включение root-доступа и установка сторонних скриптов могут повлиять на гарантийные обязательства. Creality официально предупреждает об этом при активации root. Действуйте осознанно и сохраните возможность отката.
Установка Helper Script по шагам
Установка выполняется одной командой, которая скачивает скрипт из репозитория и запускает интерактивное меню. Внутри меню компоненты выбираются по номерам — ставить всё подряд не обязательно, достаточно выбрать нужное.
cd /usr/data && wget --no-check-certificate https://raw.githubusercontent.com/Guilouz/Creality-K1-and-K1-Max/main/Scripts/installer.sh && sh installer.shТочный URL скрипта может меняться — актуальную команду всегда берите из официального репозитория проекта на GitHub, а не из старых руководств. После запуска появится текстовое меню со списком доступных компонентов, статусом их установки и пунктами удаления.
☑️ Чек-лист перед установкой Helper Script
После установки компонентов принтер обычно требуется перезагрузить — скрипт сам предложит это сделать. Затем веб-интерфейс открывается в браузере по адресу принтера: для Fluidd — просто IP-адрес, порт уточняйте в выводе установщика.
Резервная копия перед изменениями
Перед любыми правками конфигурации сохраните копию файлов printer.cfg, moonraker.conf и пользовательских макросов. Проще всего скопировать их на компьютер через scp или встроенный файловый менеджер Fluidd. Это займёт пару минут, но позволит вернуть рабочее состояние, если что-то пойдёт не так.
Сделайте снимок экрана меню установщика до внесения изменений — так вы будете знать исходное состояние компонентов и сможете точно откатить установку.
Настройка Fluidd и Moonraker после установки
После первого входа в Fluidd проверьте, что интерфейс видит принтер: в панели должны отображаться температура сопла и стола, а в разделе конфигурации — содержимое printer.cfg. Если интерфейс открывается, но показывает ошибку подключения, чаще всего не запущен Moonraker или Klipper-сервис — статус служб можно проверить через SSH или в разделе системных служб самого интерфейса.
В файле moonraker.conf имеет смысл проверить секцию [update_manager] — она отвечает за обновления компонентов прямо из веб-интерфейса. Также настройте доверенные клиенты, если планируете доступ из локальной сети с нескольких устройств.
| Компонент | Назначение | Где настраивается |
|---|---|---|
| Moonraker | API между Klipper и веб-интерфейсом | moonraker.conf |
| Fluidd / Mainsail | Веб-интерфейс управления | Настройки в браузере |
| Klipper | Прошивка управления печатью | printer.cfg |
| Камера / таймлапс | Видеонаблюдение и съёмка | Настройки камеры в интерфейсе |
| Update Manager | Обновление компонентов | Секция в moonraker.conf |
Почему Fluidd не открывается после установки
Частые причины: принтер не перезагружен после установки, служба Moonraker не запустилась, браузер обращается по неверному порту или IP-адрес принтера изменился после переподключения к сети. Проверьте статус служб через SSH и закрепите статический IP за принтером в настройках роутера.
Типичные проблемы и их диагностика
Самая частая жалоба — принтер перестал загружаться или веб-интерфейс недоступен после обновления стоковой прошивки. Возможная причина в том, что обновление Creality перезаписывает часть системных файлов, и установленные скриптом компоненты перестают запускаться. В этом случае обычно помогает повторный запуск установщика и переустановка нужных модулей.
Вторая типичная ситуация — ошибки в printer.cfg после ручных правок. Klipper при синтаксической ошибке не стартует, и в Fluidd появляется сообщение о недоступности принтера. Проверьте последние изменённые строки: лишний пробел, потерянное двоеточие или неверный отступ ломают весь конфиг. Именно здесь спасает резервная копия из предыдущего раздела.
⚠️ Внимание: не обновляйте стоковую прошивку Creality, не проверив совместимость с Helper Script. Крупные обновления прошивки могут конфликтовать с установленными компонентами — сначала изучите отзывы в репозитории проекта.
Если принтер вообще не отвечает по SSH, проверьте базовые вещи: тот ли IP-адрес, не сменилась ли сеть, включён ли root-доступ после обновления прошивки (он может сбрасываться). Только после исключения сетевых причин стоит рассматривать откат системы.
Закрепите за принтером постоянный IP-адрес в настройках роутера (резервирование DHCP) — это избавит от ситуации, когда Fluidd «теряет» принтер после перезагрузки сети.
Откат изменений и возврат к стоковой системе
Установщик содержит пункты удаления для каждого компонента, поэтому откат обычно сводится к повторному запуску скрипта и выбору опций удаления. После этого перезагрузите принтер и проверьте, что стоковый экран и фирменные функции работают как раньше.
Если нужно вернуть полностью заводское состояние, используйте официальные средства восстановления прошивки от Creality — порядок зависит от версии и описан в документации производителя. Перед полным сбросом сохраните свои конфиги и профили печати, иначе восстановить их будет неоткуда.
Helper Script обратим: компоненты удаляются через тот же установщик, а резервная копия конфигов позволяет восстановить рабочую настройку в любой момент.
FAQ: частые вопросы о Helper Script
Безопасен ли Helper Script для Creality K1?
Скрипт широко используется сообществом и не перезаписывает прошивку, а дополняет её. Тем не менее это стороннее ПО: включение root и установка модификаций могут повлиять на гарантию, а ошибки в конфигурации — на работу принтера. Делайте резервные копии и берите команду установки только из официального репозитория.
Что лучше выбрать: Fluidd или Mainsail?
Оба интерфейса решают одни и те же задачи и работают через Moonraker. Fluidd часто хвалят за скорость и лёгкость, Mainsail — за богатые настройки и виджеты. Попробуйте оба: установка и удаление через скрипт занимают несколько минут.
Слетит ли Helper Script после обновления прошивки K1?
Возможно. Обновления стоковой прошивки Creality могут перезаписывать системные файлы, из-за чего установленные компоненты перестают работать. Обычно помогает повторная установка через скрипт. Перед обновлением прошивки проверяйте совместимость в репозитории проекта.
Нужен ли постоянно включённый компьютер для работы Fluidd?
Нет. Fluidd и Moonraker работают на самом принтере, компьютер нужен только как клиент для открытия веб-интерфейса в браузере. Печать продолжается, даже если закрыть вкладку или выключить ПК.
Можно ли вернуть принтер к заводскому состоянию?
Да. Компоненты удаляются через тот же установщик, а для полного возврата к стоку используются официальные средства восстановления прошивки Creality. Предварительно сохраните свои конфигурационные файлы.