# Documentation : Accès graphique Debian via Guacamole + VNC (x11vnc) + Proxmox

Cette documentation explique comment configurer un accès graphique à une machine Debian (VM Proxmox/VirtualBox) via Guacamole, en utilisant x11vnc pour partager une session graphique Xorg.

Elle couvre :

- Installation d'un environnement graphique
- Installation et configuration de x11vnc
- Lancement manuel et automatique
- Configuration Guacamole
- Cas avec ou sans bureau local
- Compatibilité Proxmox
- Dépannage

---

# 1. Installation d'un environnement graphique Debian

## 1.1. Installation recommandée (fonctionne dans Proxmox ET Guacamole)

XFCE + LightDM + Xorg + drivers VMware

sudo apt update
sudo apt install xfce4 lightdm lightdm-gtk-greeter
sudo dpkg-reconfigure lightdm   # choisir lightdm

Installer les drivers vidéo compatibles Proxmox :

sudo apt install xserver-xorg-video-vmware xserver-xorg-video-fbdev xserver-xorg-video-vesa

Puis :

sudo reboot

Après reboot, le bureau doit apparaître dans Proxmox.

---

## 1.2. Cas "serveur sans bureau" (Xorg virtuel)

sudo apt update
sudo apt install xserver-xorg xserver-xorg-video-dummy

---

# 2. Installation de x11vnc

sudo apt install x11vnc

---

# 3. Création du mot de passe VNC

x11vnc -storepasswd

Fichier créé :

~/.vnc/passwd

---

# 4. Lancer x11vnc

## 4.1. Si un bureau Xorg existe (LightDM + XFCE)

x11vnc -display :0 -forever -auth guess -rfbauth ~/.vnc/passwd

Si '-auth guess' échoue :

x11vnc -display :0 -forever -auth /root/.Xauthority -rfbauth ~/.vnc/passwd

---

## 4.2. Si aucun bureau n'existe (Xorg virtuel)

Créer la config dummy :

sudo mkdir -p /etc/X11/xorg.conf.d
sudo nano /etc/X11/xorg.conf.d/10-dummy.conf

Contenu :

Section "Device"
    Identifier  "DummyDevice"
    Driver      "dummy"
    VideoRam    256000
EndSection

Section "Monitor"
    Identifier "DummyMonitor"
    HorizSync  30-70
    VertRefresh 50-75
EndSection

Section "Screen"
    Identifier "DummyScreen"
    Device     "DummyDevice"
    Monitor    "DummyMonitor"
    SubSection "Display"
        Depth 24
        Modes "1920x1080"
    EndSubSection
EndSection

Lancer Xorg virtuel :

sudo Xorg :0

Puis :

x11vnc -display :0 -forever -auth /root/.Xauthority -rfbauth ~/.vnc/passwd

---

# 5. Configuration Guacamole (VNC)

- Protocole : VNC
- Host : IP de la VM Debian
- Port : 5900
- Password : celui créé avec 'x11vnc -storepasswd'
- Color depth : 24 bits
- Ignore certificate : oui

---

# 6. Lancer x11vnc automatiquement au démarrage

Créer le service :

sudo nano /etc/systemd/system/x11vnc.service

Contenu :

[Unit]
Description=Start x11vnc at startup
After=multi-user.target

[Service]
Type=simple
User=vboxuser
ExecStart=/usr/bin/x11vnc -display :0 -forever -auth /root/.Xauthority -rfbauth /home/vboxuser/.vnc/passwd
# Redémarrer en cas de plantage
Restart=always
RestartSec=2

[Install]
WantedBy=multi-user.target

Activer :

sudo systemctl enable x11vnc
sudo systemctl start x11vnc

---

# 7. Configuration Proxmox (IMPORTANT)

Dans Hardware → Display :

- Display : Default
- Graphic card : VMware compatible

C'est la seule combinaison stable pour :

- LightDM
- XFCE
- Xorg
- x11vnc
- Proxmox console
- Guacamole

---

# 8. Dépannage

## Problème : écran noir dans Proxmox
Cause : Xorg ne démarre pas.
Solution :

sudo apt install --reinstall xserver-xorg-core xserver-xorg-video-all xserver-xorg-input-all
sudo apt install xserver-xorg-video-vmware xserver-xorg-video-fbdev xserver-xorg-video-vesa
sudo reboot

Supprimer toute config Xorg cassée :
sudo rm -f /etc/X11/xorg.conf
sudo rm -f /etc/X11/xorg.conf.d/*.conf

---

## Problème : Guacamole → "serveur distant inaccessible"
Cause : pas de DISPLAY :0 ou mauvais fichier Xauthority.
Solution :

ps aux | grep Xorg

Puis utiliser le chemin exact dans :

x11vnc -display :0 -forever -auth /chemin/Xauthority -rfbauth ~/.vnc/passwd

---

## Problème : TigerVNC / vncserver plante
Cause : conflit avec Xorg existant.
Solution : utiliser x11vnc.

---

# 9. Résultat final

Avec cette configuration :

- Bureau graphique visible dans Proxmox
- Bureau graphique visible dans Guacamole
- x11vnc partage DISPLAY :0
- Aucun écran noir
- Aucun conflit Wayland/GDM3
- Fonctionne sur toutes les VM Proxmox