Klipper Cloud Удалённый агент
Удалённый агент Klipper Cloud используется для подключения сетевых устройств FLYOS-FAST к Klipper Cloud, что позволяет привязать и получить удалённый доступ к текущему управляющему компьютеру в облачной платформе. Тестовый образ FLYOS-FAST v1.4.0 генерирует локальные учётные данные при первом запуске, но удалённый доступ по умолчанию отключён и должен быть явно включён пользователем.
Данная функция в настоящее время подтверждена только в тестовом образе FLYOS-FAST v1.4.0. После включения устройство активно подключается к удалённому сервису; если удалённый доступ не требуется, держите его выключенным.
Идентификатор устройства, локальные учётные данные, конфигурация агента и журналы, содержащие эту информацию, не должны публиковаться на форумах, в чатах или других публичных местах.
Перед удалённым перемещением, нагревом или выполнением G-code необходимо убедиться в безопасности физического окружения принтера и сохранить возможность немедленного отключения питания или экстренной остановки. Сетевая задержка, разрыв соединения или рассинхронизация состояния могут повлиять на результат операции. Не рекомендуется запускать печать удалённо, если за устройством не наблюдают и невозможно обработать исключительные ситуации.
Описание функций
- После включения удалённого агента вы можете привязать текущий управляющий компьютер в соответствии с подсказками платформы Klipper Cloud.
- Отключение удалённого агента только останавливает облачное удалённое соединение и не влияет на доступ Fluidd, Mainsail, Moonraker и SSH в локальной сети.
- Наличие процесса агента в фоне не означает, что удалённый доступ включён; процесс агента также может ожидать авторизации пользователя.
- Идентификатор устройства используется для идентификации текущего управляющего компьютера и не является USB ID платы, CAN UUID или MCU ID в конфигурации принтера.
Полный процесс включения
1. Включение удалённого сервиса
Выполните через SSH:
/data/klipper-cloud-agent/klipper-cloud-agent --enable-remote
Если после выполнения команды нет ошибок, дождитесь подключения агента к облаку. Не выполняйте команду включения повторно несколько раз подряд.
2. Запрос идентификатора устройства
Убедитесь, что облачный сервис включён и управляющий компьютер имеет доступ в Интернет, затем выполните:
/data/klipper-cloud-agent/klipper-cloud-agent --device-id
После того как команда вернёт идентификатор устройства, выполните привязку устройства в соответствии с подсказками платформы Klipper Cloud. При копировании выбирайте только сам идентификатор устройства, не отправляйте другим людям полный скриншот терминала.
На изображении выше показан пример работы в терминале, идентификатор устройства скрыт. Ориентируйтесь на фактические данные, возвращаемые вашим устройством.
3. Завершение привязки в облачной платформе
Откройте Управление устройствами Klipper Cloud и войдите под своей учётной записью. При первом использовании, пожалуйста, сначала ознакомьтесь с инструкциями, условиями обслуживания и правилами конфиденциальности на странице.
После входа найдите поле добавления устройства в разделе Мои устройства слева:
- Введите полный идентификатор устройства, возвращённый
--device-id, в поле Введите ID устройства KD-…. - Нажмите Добавить.
- Дождитесь появления устройства в списке слева и подтвердите, что его статус отображается как В сети.
- Нажмите на устройство, чтобы открыть интерфейс удалённого управления устройством на странице; для открытия в отдельном окне нажмите Открыть в новом окне в правом верхнем углу.
Учётная запись, имя устройства, идентификатор устройства и интерфейс удалённой печати на скриншотах страницы управления устройством скрыты. Не публикуйте скриншоты страниц с реальной информацией.
После привязки необходимо также проверить:
- Устройство, отображаемое в облачной платформе, соответствует текущему управляющему компьютеру.
- Удалённая страница может считывать текущее состояние принтера.
- Fluidd или Mainsail в локальной сети по-прежнему доступны.
Не используйте идентификаторы устройств, предоставленные другими лицами, и не привязывайте своё устройство к недоверенным учётным записям.
Отключение удалённого сервиса
Если удалённый доступ больше не нужен, выполните:
/data/klipper-cloud-agent/klipper-cloud-agent --disable-remote
После отключения локальный доступ Fluidd, Mainsail, Moonraker и SSH в локальной сети не затрагивается. Если вы планируете передать, отремонтировать или переустановить устройство, необходимо также отвязать устройство в платформе Klipper Cloud; выполнение только команды отключения не означает удаления связи с учётной записью в облачной платформе.
Отвязка устройства в облачной платформе
При подготовке к передаче, ремонту или прекращению использования текущего устройства следует одновременно отключить удалённый сервис на устройстве и отвязать его в платформе:
- Сначала выполните
--disable-remoteв SSH. - На компьютере щёлкните правой кнопкой мыши по устройству слева; на телефоне или сенсорном устройстве выполните длинное нажатие на устройство.
- Выберите Удалить/Отвязать.
- Следуйте подсказкам на странице и введите текущее имя устройства для подтверждения.
Отвязка удаляет связь между текущей учётной записью и устройством. Сохранённые на устройстве конфигурации, файлы печати и доступ в локальной сети не будут удалены.
Краткая справка по командам
| Операция | Команда | Условия использования |
|---|---|---|
| Проверка агента | test -x /data/klipper-cloud-agent/klipper-cloud-agent && echo "klipper-cloud-agent 已安装" | Выполнить после входа в SSH |
| Включение удалённого сервиса | /data/klipper-cloud-agent/klipper-cloud-agent --enable-remote | Управляющий компьютер подключён к сети |
| Запрос идентификатора устройства | /data/klipper-cloud-agent/klipper-cloud-agent --device-id | Удалённый сервис включён и сеть работает |
| Отключение удалённого сервиса | /data/klipper-cloud-agent/klipper-cloud-agent --disable-remote | Когда облачный доступ больше не требуется |