use-random-uuid

Переключение режима генерации UUID устройства: машинный или случайный

Важно

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

Зачем нужна

По умолчанию RuDesktop формирует внутренний UUID устройства из machine_uid — стабильного идентификатора, который операционная система выдаёт по характеристикам железа. Это удобно для физических машин: после переустановки системы или сброса состояния клиент получит тот же UUID и сервер «узнает» прежнее устройство

В виртуальных средах machine_uid часто совпадает у нескольких машин (одна базовая VHDX, один шаблон VDI, один Docker-образ) — клиенты приходят на сервер с одинаковым UUID и конфликтуют. Команда переключает клиент в режим случайного UUID: при включении сразу присваивается новое случайное значение, и при всех дальнейших перегенерациях (например, через reset-state) UUID будет случайным, не зависящим от железа

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

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

  • Клонированные виртуальные машины — после клонирования у нескольких машин machine_uid идентичен; команда сразу разводит их по разным UUID

  • Контейнеризованный клиент — при пересоздании контейнера нужен новый UUID, иначе на сервере появятся «дубли»

  • Откат на стабильный UUID — значение false возвращает клиент к привязке UUID к machine_uid (полезно после переноса VDI-машины на физический хост)

Синтаксис

rudesktop --use-random-uuid <true|false>

Важно

Принимаются только литеральные значения true и false. Любые другие значения (Y/N, 1/0) команда игнорирует

Пример

  1. Чтобы переключить клиент на случайные UUID и сразу выдать новое значение, введите следующее:

    rudesktop --use-random-uuid true

    После выполнения команды клиент сохранит флаг use_random_uuid = true, сразу сгенерирует и применит новый случайный UUID. Узнать текущее значение можно командой get-uuid

  2. Чтобы вернуть клиент к UUID на основе характеристик железа, введите следующее:

    rudesktop --use-random-uuid false

    После выполнения команды флаг сбрасывается. Текущий UUID не меняется сразу — он будет перегенерирован из machine_uid только при следующем сбросе состояния (например, командой reset-state)

Подсказка

Связка с reset-state: команды дополняют друг друга. --use-random-uuid true управляет тем, как будет генерироваться UUID, а --reset-state обнуляет идентификатор устройства, мастер-пароль и сертификат и инициирует перегенерацию. Для разворачивания клонов из единого образа правильная последовательность:

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

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

Важно

Флаги --use-random-uuid и --reset-state нельзя передать в одной команде — rudesktop обработает только первый флаг и завершит работу, второй будет проигнорирован. Запускайте их двумя отдельными вызовами, как показано выше