Если на Creality K1 Max нужен полный доступ к Klipper — правка printer.cfg, установка Fluidd или Mainsail, отключение фирменных ограничений — стандартная прошивка этого не позволяет, и задачу решает Helper Script от сообщества (проект Guilouz, Creality K1 Series Helper Script). Это набор shell-скриптов, который запускается на самом принтере через SSH и выводит текстовое меню с пунктами установки и удаления компонентов.
Принтеры серии K1 (K1, K1 Max, K1C) работают на модифицированной Creality версии Klipper с закрытым окружением. Helper Script не заменяет прошивку целиком, а расширяет существующую систему: ставит альтернативные веб-интерфейсы, Entware, аддоны вроде Guppy Screen и утилиты для калибровки. Ниже — порядок подготовки, установки и безопасного отката.
Что даёт Helper Script и кому он нужен
Скрипт предназначен для владельцев K1 Max, которым тесно в рамках стокового экрана Creality. После установки появляется возможность управлять принтером через привычные интерфейсы Klipper-сообщества и тонко настраивать параметры печати.
- 🔧 Root-доступ и SSH — полный контроль над файловой системой принтера.
- 🖥️ Fluidd и Mainsail — альтернативные веб-интерфейсы с расширенными макросами и графиками.
- 📦 Entware — пакетный менеджер для установки дополнительных утилит.
- 📷 Инструменты для работы с камерой, timelapse и улучшенного input shaping.
- ↩️ Функции удаления компонентов и восстановления стокового состояния.
Важно понимать: скрипт разработан энтузиастами и не является продуктом Creality. Перед любыми изменениями стоит убедиться, что версия прошивки принтера совместима с актуальной версией скрипта — эта информация указывается в репозитории проекта на GitHub.
Helper Script — это не прошивка, а надстройка над стоковой системой K1 Max: она добавляет Fluidd, Mainsail и SSH-доступ, не перезаписывая заводской Klipper полностью.
Подготовка: root-доступ и подключение по SSH
Первый шаг — включить root-доступ на принтере. На экране K1 Max откройте настройки, перейдите в раздел с информацией об устройстве и найдите пункт, связанный с root-доступом (в разных версиях прошивки он может называться по-разному и скрываться за повторными нажатиями на версию ПО). После активации принтер покажет пароль root — запишите его.
Далее потребуется компьютер в той же локальной сети. Подключение выполняется любым SSH-клиентом: в Windows это может быть PowerShell или PuTTY, в macOS и Linux — стандартный терминал.
ssh root@IP_АДРЕС_ПРИНТЕРАIP-адрес смотрите на экране принтера в сетевых настройках. Если подключение отклоняется, проверьте, что принтер и компьютер в одной подсети, а root-доступ действительно активирован — после обновления прошивки он может сбрасываться.
⚠️ Внимание: включение root-доступа и установка сторонних скриптов могут рассматриваться производителем как основание для отказа в гарантийном обслуживании. Выполняйте действия осознанно и сохраните возможность отката.
Установка Helper Script на K1 Max
После входа по SSH установка выполняется одной командой, которая скачивает скрипт из репозитория и запускает его. Точную актуальную команду берите из README репозитория проекта, так как адрес и имя ветки могут меняться. Типичная схема выглядит так:
cd /usr/data
git clone https://github.com/Guilouz/Creality-Helper-Script.git
sh /usr/data/Creality-Helper-Script/helper.sh
На принтере должен быть доступ в интернет — без него загрузка файлов невозможна. После запуска откроется текстовое меню с пронумерованными пунктами: установка и удаление компонентов выполняются выбором соответствующей цифры.
☑️ Перед запуском Helper Script
Обратите внимание на пункт бэкапа. Скопируйте содержимое конфигурационной папки на компьютер через тот же SSH (например, с помощью scp или WinSCP) — это займёт пару минут, но позволит вернуть рабочие настройки при любой ошибке.
Что устанавливать в первую очередь
Меню скрипта предлагает много пунктов, и соблазн поставить всё сразу велик. Разумнее двигаться поэтапно, проверяя работу принтера после каждого изменения.
- 🌐 Fluidd или Mainsail — основной интерфейс управления; ставить оба одновременно не обязательно, выберите один.
- 🖼️ Guppy Screen — альтернативный экран на самом принтере с расширенными элементами управления.
- 📊 Инструменты калибровки и input shaping — если планируете тонкую настройку качества.
- 💾 Entware — база для остальных пакетов, ставится одним из первых пунктов.
После установки веб-интерфейса он открывается в браузере по адресу http://IP_ПРИНТЕРА:4408 или на стандартном порту — конкретный порт зависит от выбранного компонента и указывается скриптом по завершении установки. Проверьте, что интерфейс видит принтер: отображаются температура сопла и стола, доступны кнопки движения осей.
Ставьте компоненты по одному и после каждого делайте тестовую печать небольшой модели. Так при проблемах вы сразу поймёте, какое изменение их вызвало.
Типичные проблемы и их решение
Чаще всего сложности возникают не с самим скриптом, а с окружением. Ниже — характерные ситуации.
| Проблема | Вероятная причина | Что проверить |
|---|---|---|
| SSH отклоняет подключение | Root-доступ выключен или сброшен обновлением | Повторно активировать root в настройках принтера |
| Скрипт не скачивается | Нет интернета на принтере | Проверить Wi-Fi, пинговать внешний адрес из SSH |
| Fluidd не открывается | Сервис не запущен или занят порт | Перезапустить сервис через меню скрипта |
| Принтер не печатает после изменений | Повреждён или заменён printer.cfg | Восстановить конфиг из бэкапа |
⚠️ Внимание: не обновляйте стоковую прошивку Creality «по воздуху», пока установлены модификации, не убедившись, что новая версия совместима. Обновление может стереть root-доступ и конфликтовать с установленными компонентами.
Если принтер после вмешательства ведёт себя нестабильно, начните с простого: перезагрузите его, проверьте логи Klipper через веб-интерфейс и откатите последнее установленное изменение через тот же пункт меню скрипта в режиме удаления.
Где искать логи при ошибках
Логи Klipper доступны через Fluidd/Mainsail в разделе конфигурации (файл klippy.log), а также по SSH в системных каталогах принтера. Строки с пометкой "Error" обычно указывают на конкретный конфликтный параметр или отсутствующий файл.
Откат к заводскому состоянию
Одно из достоинств Helper Script — обратимость. В меню предусмотрены пункты удаления каждого компонента, а также восстановления стокового окружения. Порядок действий: удалите установленные аддоны через скрипт, затем при необходимости выполните сброс принтера через штатное меню настроек или переустановите официальную прошивку с USB-накопителя по инструкции Creality.
Учтите, что полный сброс вернёт заводские конфиги — ваши калибровки, макросы и профили будут потеряны, если не сохранены заранее. Перед откатом обязательно выгрузите printer.cfg и папку с макросами — это единственное, что невозможно восстановить автоматически.
Helper Script обратим: все компоненты удаляются через то же меню, а стоковую прошивку можно восстановить официальными средствами Creality. Главное — сохранить свои конфиги заранее.
Частые вопросы о Helper Script для K1 Max
Подходит ли Helper Script для K1 и K1C, а не только K1 Max?
Да, скрипт разработан для всей серии K1. Однако состав доступных пунктов и совместимость могут различаться между моделями и версиями прошивки — сверяйтесь с описанием в репозитории проекта для вашей конкретной модели.
Нужен ли постоянно включённый компьютер для работы Fluidd?
Нет. Fluidd и Mainsail работают на самом принтере — компьютер нужен только как браузер для доступа к веб-интерфейсу. Управлять печатью можно с любого устройства в локальной сети, включая смартфон.
Потеряю ли я гарантию после установки скрипта?
Однозначного ответа нет: условия гарантии определяет производитель и продавец. Вмешательство в программную часть может стать основанием для отказа. Скрипт обратим, но следы модификаций теоретически могут остаться в логах системы.
Что делать, если после обновления прошивки скрипт перестал работать?
Обновление часто сбрасывает root-доступ и удаляет установленные файлы. Включите root заново, проверьте в репозитории проекта наличие обновлённой версии скрипта под новую прошивку и повторите установку.
Можно ли использовать Helper Script без опыта работы с Linux?
Базовая установка требует лишь умения подключиться по SSH и ввести команду — всё остальное делается через меню. Но для диагностики проблем и правки конфигов минимальные знания командной строки существенно помогут.