• Lien : https://guacamole.apache.org/doc/gug/guacamole-native.html

Guacamole est divisé en deux parties :

• guacamole-server :
  • fournit le proxy guacd et les bibliothèques associées,
  • doit être compilé à partir du code source.
• guacamole-client :
  • fournit le client à servir par votre conteneur de servlets, généralement Apache Tomcat.
  • disponible sous forme binaire.

• contient tous les composants natifs côté serveur nécessaires par Guacamole pour se connecter aux bureaux à distance.
• fournit une bibliothèque C commune, libguac, dont dépendent tous les autres composants natifs, ainsi que des bibliothèques pour chaque protocole supporté,
• guacd, le cœur de Guacamole.

guacd est le démon proxy qui s’exécute sur le serveur Guacamole :

• accepte les utilisateurs des connexions qui sont tunnellées via l’application web Guacamole,
• puis se connecte aux bureaux à distance en leur nom.

guacd est un exécutable appelé GUACD qui peut être exécuté manuellement ou automatiquement quand votre ordinateur démarre.

La construction de guacamole-server nécessite un compilateur C (comme gcc) et des bibliothèques dont dépend guacamole-server. Certaines dépendances sont absolument obligatoire, tandis que d’autres sont optionnels. La présence de dépendances optionnelles permet des fonctionnalités supplémentaires.

Pour construire guacamole-server, il faut disposer de :

• Cairo : utilisé par libguac pour le rendu graphique,
• libjpeg (ou libjpeg-turbo) : utilisé par libguac pour fournir la prise en charge JPEG
• libpng : utilisé par libguac pour écrire des images PNG, le type d’image de base utilisé par le protocole Guacamole
• libuuid (ou la bibliothèque OSSP UUID) : utilisé pendant le processus de compilation. libtool crée des bibliothèques compilées nécessaire pour le guacamole.

apt install -y libcairo2-dev libjpeg62-turbo-dev libtool-bin

Les dépendances optionnelles de Guacamole dictent quelles parties de guacamole-server seront construites. Cela inclut la prise en charge de divers protocoles de bureau à distance, ainsi que toutes les fonctionnalités supplémentaires de ces protocoles :

• FreeRDP : requis pour le support RDP.
• Pango : bibliothèque de mise en page de texte que Guacamole utilise pour rendre le texte protocoles nécessitant un terminal (Kubernetes, SSH et telnet).
• libssh2 : nécessaire pour le support SSH et SFTP.
• libVNCServer : fournit libvncclient, qui est nécessaire pour le support VNC
• libwebsockets : nécessaire pour le support de Kubernetes.
• OpenSSL : offre la prise en charge de SSL et TLS - deux schémas de chiffrement courants qui constituent la majorité du trafic web chiffré.
• libwebp : utilisé par libguac pour écrire des images WebP.
• PulseAudio (libpulse-dev) : PulseAudio fournit libpulse, utilisé par le support VNC de Guacamole pour fournir un support audio expérimental.
• Libvorbis (libvorbis-dev) : prend en charge Ogg Vorbis - une norme libre et ouverte pour Compression sonore. Si elle est installée, libguac sera construite avec le support d’Ogg Vorbis et les protocoles supportant l’audio utiliseront la compression Ogg Vorbis lorsque Possible. Sinon, le son ne sera encodé que comme WAV (non compressé), et ne sera que disponible si votre navigateur prend également en charge le WAV.

apt install -y freerdp3-dev libpango1.0-dev libssh2-1-dev libvncserver-dev libwebsockets-dev libssl-dev libwebp-dev libpulse-dev libvorbis-dev

• FFmpeg (libavcodec-dev, libavformat-dev, libavutil-dev, libswscale-dev): Les bibliothèques libavcodec, libavformat, libavutil et libswscale fournies par FFmpeg est utilisé pour encoder des flux vidéo lors de la traduction des enregistrements de sessions de Guacamole
• libtelnet (libtelnet-dev) : nécessaire pour le support de telnet.

• créer et utiliser un compte pour guacamole

apt install sudo
adduser guacamole
usermod -aG sudo guacamole

* avec git

apt install -y git
git clone git://github.com/apache/guacamole-server.git

• avec l'archive

wget https://dlcdn.apache.org/guacamole/1.6.0/source/guacamole-server-1.6.0.tar.gz
tar -xzf guacamole-server-1.6.0.tar.gz
cd guacamole-server-1.6.0

• installer Autotools et plusieurs bibliothèques :

sudo apt install -y build-essential make pkg-config

sudo sudo ./configure --with-systemd-dir=/etc/systemd/system/
...
------------------------------------------------
guacamole-server version 1.6.0
------------------------------------------------

   Library status:

     freerdp ............. yes (3.x)
     pango ............... yes
     libavcodec .......... no
     libavformat ......... no
     libavutil ........... no
     libssh2 ............. yes
     libssl .............. yes
     libswscale .......... no
     libtelnet ........... no
     libVNCServer ........ yes
     libvorbis ........... yes
     libpulse ............ yes
     libwebsockets ....... yes
     libwebp ............. yes
     wsock32 ............. no

   Protocol support:

      Kubernetes .... yes
      RDP ........... yes
      SSH ........... yes
      Telnet ........ no
      VNC ........... yes

   Services / tools:

      guacd ...... yes
      guacenc .... no
      guaclog .... yes

   FreeRDP plugins: /usr/lib/x86_64-linux-gnu/pkgconfig/../../../lib/x86_64-linux-gnu/freerdp3
   Init scripts: no
   Systemd units: /etc/systemd/system/

Type "make" to compile guacamole-server.

configure: WARNING:
  --------------------------------------------
    Support for FreeRDP 3.x is currently experimental. Some features, like
    RemoteApp, have known issues. If not testing, consider using FreeRDP 2.x.