Inicializar el acceso remoto VNC (cliente Linux)

En un cliente Linux, tras iniciar sesión en la consola web 10888 (consulte Actualizar cliente Linux), aparece una tarjeta «Inicializar VNC». Un clic configura VNC y lo notifica a la consola, que luego puede conectarse a este cliente de forma remota. En la inmensa mayoría de los casos es totalmente automático, sin configuración manual; solo cuando el flujo automático se ve bloqueado por el entorno (falta x11vnc, escritorio Wayland, etc.) necesitará la sección «Gestión manual» de abajo.

Qué hace la inicialización con un clic

Tras hacer clic en «Inicializar VNC», el cliente (vdclient, ejecutándose como root) realiza automáticamente, en orden:

1. Desactiva el aviso de fallo de Apport (solo Ubuntu/Debian): evita que la ventana «Se detectó un problema en un programa del sistema» aparezca sobre el escritorio que está a punto de ser controlado, por si falla la instalación de x11vnc.
2. Comprueba el tipo de sesión de escritorio: si es una sesión Wayland, x11vnc no puede capturar la pantalla, por lo que le guía para cambiar a Xorg (véase el Caso 2).
3. Garantiza que x11vnc esté instalado: si falta, lo instala automáticamente en línea con el gestor de paquetes de la distribución (apt / dnf / yum / zypper / pacman).
4. Genera una contraseña aleatoria dinámica de 8 caracteres y la escribe en el archivo de contraseñas de VNC.
5. Detecta automáticamente DISPLAY y XAUTHORITY de la sesión gráfica e inicia x11vnc en :0 en el puerto 9015.
6. Notifica automáticamente la IP, el puerto 9015 y la contraseña dinámica al servidor de arranque, para que la consola pueda conectarse de forma remota — usted nunca introduce una contraseña.
7. Escribe una marca de inicio automático: a partir de entonces, cada vez que el cliente arranca, vdclient vuelve a levantar VNC automáticamente cuando el escritorio y el servidor están listos — no hace falta volver a hacer clic.

El puerto VNC está fijado en 9015; la contraseña de control es aleatoria, generada dinámicamente en cada inicialización y notificada a la consola automáticamente — no se puede ni hace falta establecerla manualmente.

Pasos de inicialización automática

1. En el propio equipo cliente, abra http://localhost:10888 en un navegador e inicie sesión con la cuenta de administrador (por defecto admin / 123456).
2. En la tarjeta «Inicializar VNC», haga clic en el botón «Inicializar VNC».
3. El mensaje «VNC inicializado» indica éxito — la consola ya puede conectarse de forma remota.

Gestión manual cuando el software no puede hacerlo automáticamente

Si el clic informa de un fallo, gestiónelo según el caso de abajo. Después, vuelva a la consola y haga clic de nuevo en «Inicializar VNC»: debe reintentar mediante el botón, porque solo el botón notifica la información de VNC a la consola; iniciar x11vnc a mano por sí solo no la notifica y la consola no puede conectarse.

Caso 1: no se encuentra x11vnc y la instalación automática falló

Frecuente cuando el cliente no tiene acceso a la red o no tiene un repositorio configurado. El mensaje es similar a «x11vnc no encontrado y la instalación automática falló, instálelo manualmente: apt-get install -y x11vnc».

Instale x11vnc manualmente en el terminal del cliente según el tipo de sistema (vdclient se ejecuta como root; la instalación manual también requiere root):

Sistema	Comando de instalación
Ubuntu / Debian / Kylin / UOS (basados en deb)	apt-get install -y x11vnc
openEuler / Anolis / RHEL / CentOS (nuevos)	dnf install -y x11vnc
RHEL / CentOS (antiguos)	yum install -y x11vnc
openSUSE	zypper install x11vnc
Arch	pacman -S x11vnc

Si x11vnc no está en el repositorio, configure primero un repositorio funcional (o descargue x11vnc y sus dependencias e instálelos sin conexión). Una vez instalado, vuelva a la consola y haga clic de nuevo en «Inicializar VNC».

Caso 2: el escritorio es Wayland y VNC no puede capturar la pantalla

Escritorios como GNOME usan el compositor Wayland por defecto, pero x11vnc captura la pantalla mediante X11 y no puede capturar el escritorio bajo Wayland. Debe cambiar a una sesión Xorg.

Cambio automático desde la consola (recomendado): tras hacer clic en «Inicializar VNC», si se detecta Wayland, aparece un cuadro de confirmación:

El escritorio actual es Wayland, donde VNC no puede capturar la pantalla. Cambiar a Xorg reiniciará el gestor de pantalla y cerrará la sesión de escritorio actual (vuelve a Xorg automáticamente en ~15 s). ¿Continuar?

Tras hacer clic en Aceptar, el cliente modifica automáticamente la configuración de GDM (escribe WaylandEnable=false, haciendo una copia de seguridad del original como *.osvbak) y reinicia el gestor de pantalla para cambiar a Xorg. Cuando el escritorio vuelva a Xorg (unos 15 segundos), haga clic de nuevo en «Inicializar VNC».

Gestión manual si el cambio automático falla: si informa de que no se encuentra la configuración de GDM, de que falló el reinicio del gestor de pantalla, o de que la sesión sigue siendo Wayland tras el cambio, opere manualmente en el terminal del cliente:

1. Edite la configuración de GDM (/etc/gdm3/custom.conf en Debian/Ubuntu/Kylin/UOS, /etc/gdm/custom.conf en sistemas basados en Red Hat) y añada o cambie en la sección [daemon]:

   [daemon]
   WaylandEnable=false

2. Reinicie el gestor de pantalla (esto cierra la sesión del escritorio actual, así que guarde su trabajo primero):

   systemctl restart display-manager

   También puede simplemente reiniciar el cliente; o, en la pantalla de inicio de sesión de GDM, hacer clic en el engranaje de la esquina inferior derecha y elegir «en Xorg» (on Xorg) antes de iniciar sesión.

3. Tras confirmar que está en una sesión Xorg, vuelva a la consola y haga clic de nuevo en «Inicializar VNC».

Ya configuró WaylandEnable=false pero sigue en Wayland: normalmente la sesión actual no se ha vuelto a iniciar — reinicie el cliente o vuelva a iniciar sesión en Xorg y luego inicialice de nuevo.

Caso 3: tras cambiar a Xorg, haga clic una vez más

El cambio automático a Xorg cierra y reinicia la sesión del escritorio (unos 15 segundos), lo que interrumpe esta inicialización. Cuando el escritorio vuelva, regrese a la consola y haga clic de nuevo en «Inicializar VNC» para terminar el inicio y la notificación.

Verificación y resolución de problemas

• En el cliente, compruebe si x11vnc se está ejecutando en el puerto 9015:

  pgrep -a x11vnc
  ss -lntp | grep 9015

• El registro de inicio está en log/x11vnc.log, dentro del directorio del programa vdclient; úselo para diagnosticar fallos (p. ej., DISPLAY/XAUTHORITY no encontrados, puerto en uso, BadMatch de captura, etc.).

• Cuando la consola muestra que el cliente está disponible para conexión remota, la notificación tuvo éxito.

Notas

Esta función solo está disponible en clientes Linux; los clientes Windows usan un enlace TightVNC independiente y no tienen este botón.

El cliente debe tener una sesión de escritorio gráfico en ejecución (X/Xorg); no se puede inicializar desde un terminal de solo texto ni cuando no hay ningún escritorio con sesión iniciada.

Una vez inicializado, se inicia automáticamente al arrancar — no hace falta volver a hacer clic tras reiniciar el cliente; cada vez (incluido el inicio automático) regenera la contraseña dinámica y la notifica a la consola.

Los clientes Xinchuang (Kylin, UOS, openEuler, Anolis, etc.) siguen exactamente el mismo flujo: gestione los sistemas basados en deb según la fila de Kylin / UOS, y los basados en Red Hat según la fila de openEuler / Anolis.