Инициализация удалённого доступа VNC (клиент Linux)

На клиенте Linux после входа в веб-консоль 10888 (см. Обновление клиента Linux) появляется карточка «Инициализировать VNC». Один клик настраивает VNC и сообщает о нём консоли, которая затем может подключиться к этому клиенту удалённо. В подавляющем большинстве случаев это полностью автоматически, без ручной настройки; только когда автоматический процесс блокируется средой (нет x11vnc, рабочий стол Wayland и т. п.), нужен раздел «Ручная обработка» ниже.

Что делает инициализация в один клик

После нажатия «Инициализировать VNC» клиент (vdclient, работающий от root) автоматически выполняет по порядку:

1. Отключает всплывающее окно сбоя Apport (только Ubuntu/Debian): не даёт окну «Обнаружена ошибка в системной программе» появиться поверх рабочего стола, который вот-вот будет перехвачен, на случай сбоя установки x11vnc.
2. Проверяет тип сеанса рабочего стола: если это сеанс Wayland, x11vnc не может захватывать экран, поэтому предлагает переключиться на Xorg (см. Случай 2).
3. Обеспечивает установку x11vnc: при отсутствии устанавливает автоматически онлайн через пакетный менеджер дистрибутива (apt / dnf / yum / zypper / pacman).
4. Генерирует динамический случайный пароль из 8 символов и записывает его в файл паролей VNC.
5. Автоматически находит DISPLAY и XAUTHORITY графического сеанса и запускает x11vnc на :0 на порту 9015.
6. Автоматически сообщает IP, порт 9015 и динамический пароль серверу загрузки, чтобы консоль могла подключиться удалённо — вы никогда не вводите пароль.
7. Записывает метку автозапуска: с этого момента при каждой загрузке клиента vdclient автоматически поднимает VNC, как только готовы рабочий стол и сервер — повторно нажимать не нужно.

Порт VNC фиксирован — 9015; пароль управления случайный, генерируется динамически при каждой инициализации и сообщается консоли автоматически — его нельзя и не нужно задавать вручную.

Шаги автоматической инициализации

1. На самом клиентском компьютере откройте http://localhost:10888 в браузере и войдите под учётной записью администратора (по умолчанию admin / 123456).
2. На карточке «Инициализировать VNC» нажмите кнопку «Инициализировать VNC».
3. Сообщение «VNC инициализирован» означает успех — консоль теперь может подключиться удалённо.

Ручная обработка, когда ПО не может сделать это автоматически

Если после нажатия выводится ошибка, обработайте её согласно случаю ниже. После этого вернитесь в консоль и снова нажмите «Инициализировать VNC» — повторять нужно именно через кнопку, потому что только кнопка сообщает информацию о VNC консоли; запуск x11vnc вручную сам по себе её не сообщает, и консоль не сможет подключиться.

Случай 1: x11vnc не найден, и автоустановка не удалась

Часто бывает, когда у клиента нет доступа к сети или не настроен репозиторий. Сообщение похоже на «x11vnc не найден, автоустановка не удалась, установите вручную: apt-get install -y x11vnc».

Установите x11vnc вручную в терминале клиента в зависимости от типа системы (vdclient работает от root; ручная установка тоже требует root):

Система	Команда установки
Ubuntu / Debian / Kylin / UOS (на базе deb)	apt-get install -y x11vnc
openEuler / Anolis / RHEL / CentOS (новые)	dnf install -y x11vnc
RHEL / CentOS (старые)	yum install -y x11vnc
openSUSE	zypper install x11vnc
Arch	pacman -S x11vnc

Если x11vnc нет в репозитории, сначала настройте рабочий репозиторий (или скачайте x11vnc и его зависимости и установите офлайн). После установки вернитесь в консоль и снова нажмите «Инициализировать VNC».

Случай 2: рабочий стол — Wayland, и VNC не может захватывать экран

Рабочие столы вроде GNOME по умолчанию используют композитор Wayland, но x11vnc захватывает экран через X11 и не может захватить рабочий стол под Wayland. Нужно переключиться на сеанс Xorg.

Автоматическое переключение из консоли (рекомендуется): после нажатия «Инициализировать VNC», если обнаружен Wayland, появляется диалог подтверждения:

Сейчас используется рабочий стол Wayland, где VNC не может захватывать экран. Переключение на Xorg перезапустит дисплейный менеджер и завершит текущий сеанс рабочего стола (примерно через 15 с автоматически вернётся в Xorg). Продолжить?

После нажатия «OK» клиент автоматически изменяет конфигурацию GDM (записывает WaylandEnable=false, сохраняя резервную копию оригинала как *.osvbak) и перезапускает дисплейный менеджер для переключения на Xorg. Когда рабочий стол вернётся на Xorg (около 15 секунд), снова нажмите «Инициализировать VNC».

Ручная обработка, если автоматическое переключение не удалось: если сообщается, что конфигурация GDM не найдена, что перезапуск дисплейного менеджера не удался или что сеанс по-прежнему Wayland после переключения, выполните действия вручную в терминале клиента:

1. Отредактируйте конфигурацию GDM (/etc/gdm3/custom.conf в Debian/Ubuntu/Kylin/UOS, /etc/gdm/custom.conf в системах на базе Red Hat) и добавьте или измените в секции [daemon]:

   [daemon]
   WaylandEnable=false

2. Перезапустите дисплейный менеджер (это завершит текущий сеанс рабочего стола, поэтому сначала сохраните работу):

   systemctl restart display-manager

   Можно также просто перезагрузить клиент; или на экране входа GDM нажать шестерёнку в правом нижнем углу и выбрать «на Xorg» (on Xorg) перед входом.

3. Убедившись, что вы в сеансе Xorg, вернитесь в консоль и снова нажмите «Инициализировать VNC».

Уже задано WaylandEnable=false, но всё ещё Wayland: обычно текущий сеанс не был перезапущен — перезагрузите клиент или войдите заново в Xorg, затем инициализируйте снова.

Случай 3: после переключения на Xorg нажмите ещё раз

Автоматическое переключение на Xorg завершает и заново открывает сеанс рабочего стола (около 15 секунд), что прерывает эту инициализацию. Когда рабочий стол вернётся, вернитесь в консоль и снова нажмите «Инициализировать VNC», чтобы завершить запуск и отправку.

Проверка и устранение неполадок

• На клиенте проверьте, работает ли x11vnc на порту 9015:

  pgrep -a x11vnc
  ss -lntp | grep 9015

• Журнал запуска находится в log/x11vnc.log в каталоге программы vdclient; используйте его для диагностики сбоев (например, DISPLAY/XAUTHORITY не найдены, порт занят, BadMatch при захвате и т. п.).

• Когда консоль показывает, что клиент доступен для удалённого подключения, отправка прошла успешно.

Примечания

Эта функция доступна только на клиентах Linux; клиенты Windows используют отдельный канал TightVNC и не имеют такой кнопки.

У клиента должен быть запущенный графический сеанс рабочего стола (X/Xorg); инициализация невозможна из чисто текстового терминала или когда не выполнен вход в рабочий стол.

После однократной инициализации функция запускается автоматически при загрузке — повторно нажимать после перезагрузки клиента не нужно; каждый раз (включая автозапуск) заново генерируется динамический пароль и отправляется консоли.

Клиенты Xinchuang (Kylin, UOS, openEuler, Anolis и др.) следуют точно такому же процессу: системы на базе deb обрабатывайте по строке Kylin / UOS, а на базе Red Hat — по строке openEuler / Anolis.