reset-state

Сброс состояния клиента: идентификатора, UUID, мастер-пароля и сертификата

Важно

Команда доступна только в локальной версии клиента RuDesktop

Зачем нужна

Команда полностью обнуляет идентификационные данные, по которым сервер узнаёт устройство, и заставляет клиент перерегистрироваться при следующем подключении к серверу. После выполнения команды:

  • сбрасывается публичный Идентификатор устройства (поле id в конфиге) — клиент получит новый идентификатор от сервера

  • перегенерируется внутренний UUID — клиент при следующем рукопожатии будет восприниматься сервером как новое устройство

  • очищается Сертификат устройства — следующая регистрация выпустит новый сертификат

  • очищается Мастер-пароль — пароль будет пересоздан и заново отправлен на сервер при подключении

Типичные случаи применения:

  • Клонирование устройства из образа — после развёртывания одного образа на нескольких машинах все клиенты приходят на сервер с одинаковыми id / uuid. Запуск --reset-state на каждой клонированной машине разводит их по разным учётным записям устройства на сервере

    Важно

    В виртуальных средах (VDI, клонированные ВМ) machine_uid ОС у клонов часто совпадает — тогда --reset-state сам по себе сгенерирует тот же самый UUID. Для гарантии уникальности перед сбросом включите режим случайного UUID командой use-random-uuid:

    rudesktop --use-random-uuid true
rudesktop --reset-state

    Команды нужно запускать двумя отдельными вызовами — объединить флаги в одну строку нельзя, rudesktop обработает только первый и завершит работу, второй будет проигнорирован

  • Перенос устройства между серверами или подразделениями — обнуляет привязку к старому серверу, чтобы устройство зарегистрировалось как новое на новом сервере

  • Сброс «застрявшего» состояния — если устройство получило некорректный сертификат или мастер-пароль и не может авторизоваться на сервере, команда возвращает клиент в состояние «как после первой установки», но без переустановки самого пакета

  • Подготовка машины к передаче другому пользователю — удаляются все привязки к предыдущей записи устройства

Синтаксис

rudesktop --reset-state

Пример

Чтобы сбросить состояние клиента, введите следующее:

rudesktop --reset-state

После выполнения команды клиент сохранит обновлённую конфигурацию и при следующем подключении к серверу зарегистрируется как новое устройство

Важно

После сброса состояния старая запись устройства остаётся на сервере и продолжает занимать место в списке Устройства. При необходимости удалите её вручную, чтобы избежать дубликатов

Подсказка

Команду можно запустить массово через политику Выполнить команду — например, после клонирования группы виртуальных машин из одного образа