Helper Script для Creality K1C устанавливается на принтер через SSH-подключение и снимает заводские ограничения прошивки: открывает root-доступ, ставит Moonraker, Fluidd или Mainsail и позволяет отключить фирменные сервисы Creality. Если принтер после покупки работает только через штатный экран и Creality Print, а вам нужен полноценный веб-интерфейс и тонкая калибровка Klipper — именно этот скрипт решает задачу без перепайки и замены платы.
Проект известен как Creality K1 Helper Script (автор — Guilouz, репозиторий на GitHub). Он поддерживает линейку K1, включая K1C и K1 Max. Ниже разберём, что скрипт меняет в системе, как подготовить принтер, как выполнить установку и что проверить, если что-то пошло не так.
Что такое Helper Script и зачем он нужен на K1C
Стоковая прошивка Creality K1C построена на Klipper, но производитель закрыл к ней полный доступ: нет привычного веб-интерфейса, конфиги частично скрыты, а часть функций завязана на облако Creality. Helper Script — это набор shell-скриптов, который запускается прямо на принтере и аккуратно доставляет недостающие компоненты, не трогая заводской механизм печати.
После установки вы получаете примерно следующее:
- 🔓 Root-доступ по SSH — полный контроль над файловой системой принтера.
- 🌐 Moonraker + Fluidd/Mainsail — управление печатью из браузера, загрузка G-code без флешки.
- 📷 Расширенная работа с камерой и дополнительные макросы для калибровки.
- 🧰 Установка Entware — пакетного менеджера, через который ставятся дополнительные утилиты.
- 🚫 Возможность отключить фирменные сервисы Creality, если они не нужны.
Важно понимать: скрипт не заменяет прошивку целиком, а дополняет её. Заводской экран и штатные функции продолжают работать, если вы сами не отключили соответствующие сервисы.
Подготовка: что проверить перед установкой
До запуска скрипта принтер нужно подключить к локальной сети по Wi-Fi или Ethernet и узнать его IP-адрес — он отображается в настройках сети на экране принтера. Также потребуется компьютер в той же сети с любым SSH-клиентом: в Windows подойдёт встроенный ssh в PowerShell или PuTTY, в macOS и Linux — терминал.
Обновите прошивку принтера до актуальной версии через штатное меню, если принтер сам предлагает обновление. Версии скрипта и прошивки развиваются параллельно, и свежая связка обычно совместима лучше. Перед любыми изменениями имеет смысл сохранить копии конфигурационных файлов, если вы уже что-то правили вручную.
⚠️ Внимание: вмешательство в программную часть принтера может повлиять на гарантийные обязательства. Перед установкой ознакомьтесь с условиями гарантии Creality и сохраните возможность отката — скрипт предусматривает удаление установленных компонентов.
Подключение к принтеру по SSH
Штатный SSH на K1C доступен, но учётные данные зависят от версии прошивки. В большинстве актуальных версий используется пользователь root с паролем creality_2023, однако на части прошивок пароль может отличаться — если стандартный не подошёл, проверьте актуальные данные в описании репозитория Helper Script или в документации сообщества для вашей версии прошивки.
Подключение выполняется командой:
ssh root@IP_АДРЕС_ПРИНТЕРАПри первом подключении терминал спросит подтверждение fingerprint — ответьте yes. Если соединение отклоняется, проверьте, что принтер и компьютер в одной сети, а IP указан верно. Некоторые роутеры изолируют клиентов гостевой сети друг от друга — в таком случае подключение не пройдёт.
Установка Helper Script: пошаговый порядок
После входа по SSH скрипт загружается из репозитория и запускается интерактивное меню. Точные команды могут меняться с обновлениями проекта, поэтому сверяйтесь с README репозитория. Типовая последовательность выглядит так:
cd /usr/data
git clone https://github.com/Guilouz/Creality-Helper-Script.git
sh /usr/data/Creality-Helper-Script/helper.sh
Если git недоступен на принтере, в репозитории описан альтернативный способ загрузки архивом. После запуска откроется меню с пунктами установки: Moonraker/Nginx, Fluidd, Mainsail, Entware, макросы, отключение сервисов и другие опции. Компоненты ставятся по одному — выбираете пункт, дожидаетесь завершения, переходите к следующему.
☑️ Порядок установки Helper Script
После установки перезагрузите принтер и откройте в браузере адрес http://IP_АДРЕС_ПРИНТЕРА — должен загрузиться интерфейс Fluidd или Mainsail в зависимости от того, что выбрано. Если страница не открывается, проверьте статус сервисов через меню скрипта.
Основные функции и сравнение веб-интерфейсов
Наиболее частый вопрос после установки — что выбрать: Fluidd или Mainsail. Оба работают поверх Moonraker и дают похожий набор возможностей: загрузку файлов, управление печатью, графики температур, редактирование конфигов и макросы. Различия — в оформлении и деталях интерфейса.
| Компонент | Назначение | Когда ставить |
|---|---|---|
| Moonraker | API-сервер для Klipper | Обязательно, база для веб-интерфейсов |
| Fluidd | Веб-интерфейс | Лёгкий и минималистичный вариант |
| Mainsail | Веб-интерфейс | Если нужен привычный интерфейс сообщества Klipper |
| Entware | Пакетный менеджер | Для дополнительных утилит и твиков |
| Макросы скрипта | Калибровка и сервисные команды | По желанию, упрощают настройку |
Ставить оба интерфейса одновременно не имеет смысла — выберите один. Переключиться на другой можно позже через тот же скрипт, удалив и установив нужный пункт.
Что делать с фирменными сервисами Creality
В меню скрипта есть пункты отключения сервисов Creality (облако, статистика, часть фоновых процессов). Это освобождает ресурсы и убирает зависимость от облака, но штатные функции вроде удалённого доступа через Creality Cloud перестанут работать. Отключайте только то, чем точно не пользуетесь, — вернуть сервисы можно через тот же пункт меню.
Типичные проблемы и их решение
Чаще всего пользователи сталкиваются с тремя ситуациями. Первая — не подключается SSH: причина обычно в неверном пароле для конкретной версии прошивки или в сетевой изоляции. Вторая — скрипт запускается, но установка компонента обрывается: в этом случае проверьте доступ принтера в интернет, так как пакеты скачиваются из сети. Третья — после установки веб-интерфейс открывается, но показывает ошибку соединения с Klipper: помогает перезапуск сервисов через меню скрипта или полная перезагрузка принтера.
⚠️ Внимание: обновление заводской прошивки после установки Helper Script может удалить или сломать установленные компоненты. Перед обновлением прошивки проверьте в репозитории скрипта информацию о совместимости с новой версией.
Если после манипуляций принтер ведёт себя нестабильно, скрипт позволяет удалить установленные компоненты и вернуть систему к состоянию, близкому к заводскому. Это самый безопасный путь отката — не нужно вручную удалять файлы, если вы не уверены в их назначении.
Рекомендации после установки
Когда веб-интерфейс заработал, первым делом проверьте базовые вещи: корректно ли отображаются температуры хотэнда и стола, запускается ли домашнение (homing), проходит ли короткая тестовая печать. Любые правки printer.cfg и макросов делайте с резервной копией файла — в Fluidd и Mainsail конфиги редактируются прямо из браузера, и ошибка в одном параметре может остановить печать.
Полезно также настроить в интерфейсе сохранение графиков температур и включить уведомления, если функция поддерживается вашей конфигурацией. Дополнительные макросы калибровки из скрипта (например, для input shaping или PID) запускайте по одному и проверяйте результат печатью, а не применяйте всё сразу — так проще понять, что именно дало эффект.
Часто задаваемые вопросы
Подходит ли Helper Script для обычного K1 и K1 Max?
Да, проект поддерживает линейку K1, включая K1, K1C и K1 Max. Набор доступных пунктов меню может немного отличаться в зависимости от модели и версии прошивки — актуальный список смотрите в репозитории скрипта.
Удалит ли установка скрипта заводской экран и функции принтера?
Нет. Скрипт дополняет систему, а штатный экран и базовые функции продолжают работать. Отключаются только те сервисы, которые вы сами выберете в меню.
Что делать, если стандартный пароль SSH не подходит?
Пароль зависит от версии прошивки. Проверьте актуальные учётные данные в README репозитория Helper Script или в материалах сообщества для вашей версии прошивки — не пытайтесь подбирать пароль вслепую.
Можно ли всё удалить и вернуть принтер к заводскому состоянию?
Да, в меню скрипта предусмотрено удаление установленных компонентов. После удаления и перезагрузки система возвращается к состоянию, близкому к заводскому.
Нужен ли принтеру постоянный доступ в интернет после установки?
Нет. Интернет требуется только на этапе загрузки пакетов. Веб-интерфейс и печать работают в локальной сети без выхода в интернет.