Guacamole · 6 min read · Nov 11, 2025

Installa e usa Guacamole Remote Desktop su CentOS 8

Apache Guacamole è un’applicazione di desktop remoto gratuita, open-source, basata sul web e senza client che supporta protocolli standard come VNC, RDP e SSH. Ti consente di accedere a PC Linux e Windows da un browser web tramite RDP, SSH o VNC. È senza client, quindi non è necessario installare alcun plugin o software client. È composto da due componenti: Guacamole Server e Guacamole Client. Il server Guacamole fornisce i componenti lato server e nativi necessari per connettersi a un PC remoto, mentre il client Guacamole è un’applicazione web HTML 5 utilizzata per connettersi al PC remoto.

In questo tutorial, ti mostreremo come installare il server Guacamole su CentOS 8.

Prerequisiti

  • Un server che esegue CentOS 8.
  • Una password di root configurata sul server.

Iniziare

Per prima cosa, dovrai installare alcuni pacchetti richiesti sul tuo server. Puoi installarli tutti con il seguente comando:

dnf install -y unzip curl make cmake wget gcc zlib-devel compat-openssl10

Dopo aver installato tutti i pacchetti richiesti, dovrai abilitare i repo EPEL, PowerTools e Devel nel tuo sistema. Puoi abilitarli con il seguente comando:

dnf install epel-release -y  
dnf config-manager --set-enabled PowerTools  
dnf config-manager --enable Devel

Successivamente, installa altri strumenti richiesti con il seguente comando:

dnf install cairo-devel libuv-devel libjpeg-turbo-devel libjpeg-devel libpng-devel libtool uuid-devel freerdp-devel pango-devel libvncserver-devel pulseaudio-libs-devel openssl-devel libvorbis-devel libwebp-devel libssh2-devel libtheora opus lame-libs

Successivamente, disabilita il repo Devel con il seguente comando:

dnf config-manager --disable Devel

Successivamente, dovrai compilare la libreria telnet nel tuo sistema.

Prima, scaricala con il seguente comando:

curl -s https://api.github.com/repos/seanmiddleditch/libtelnet/releases/latest | grep browser_download_url | cut -d '"' -f 4 | wget -qi -

Una volta scaricata, estrai il file scaricato con il seguente comando:

tar -xf libtelnet-*.tar.gz

Successivamente, cambia la directory nella directory estratta e configurala con il seguente comando:

cd libtelnet-*/  
./configure

Successivamente, installala nel tuo sistema con il seguente comando:

make   
make install

Una volta installata, puoi procedere al passaggio successivo.

Installa Java

Guacamole è un software basato su Java, quindi Java deve essere installato sul tuo server. Se non è installato, puoi installarlo con il seguente comando:

dnf install java-11-openjdk-devel

Una volta installato, verifica la versione di Java utilizzando il seguente comando:

java -version

Dovresti ottenere il seguente output:

openjdk version "11.0.9.1" 2020-11-04
OpenJDK Runtime Environment (build 11.0.9.1+1-Ubuntu-0ubuntu1.20.04)
OpenJDK 64-Bit Server VM (build 11.0.9.1+1-Ubuntu-0ubuntu1.20.04, mixed mode, sharing)

Installa Tomcat

Apache Tomcat è utilizzato per servire i contenuti del client Guacamole. Quindi dovrai installare Tomcat sul tuo server.

Per prima cosa, crea un utente e un gruppo separati per Tomcat con il seguente comando:

groupadd --system tomcat  
useradd -d /usr/share/tomcat -r -s /bin/false -g tomcat tomcat

Successivamente, scarica l’ultima versione di Tomcat con il seguente comando:

wget https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.43/bin/apache-tomcat-9.0.43.tar.gz

Una volta completato il download, estrai il file scaricato con il seguente comando:

tar -xvf apache-tomcat-9.0.43.tar.gz

Successivamente, sposta Tomcat nella directory /usr/share

mv apache-tomcat-9.0.43 /usr/share/tomcat

Successivamente, imposta la proprietà corretta sulla directory di Tomcat:

chown -R tomcat:tomcat /usr/share/tomcat/

Una volta terminato, puoi procedere al passaggio successivo.

Crea un file di servizio Systemd per Tomcat

Successivamente, dovrai creare un file di servizio systemd per Tomcat. Puoi crearlo con il seguente comando:

nano /etc/systemd/system/tomcat.service

Aggiungi le seguenti righe:

[Unit]
Description=Tomcat Server
After=syslog.target network.target

[Service]
Type=forking
User=tomcat
Group=tomcat

Environment=JAVA_HOME=/usr/lib/jvm/jre
Environment='JAVA_OPTS=-Djava.awt.headless=true'
Environment=CATALINA_HOME=/usr/share/tomcat
Environment=CATALINA_BASE=/usr/share/tomcat
Environment=CATALINA_PID=/usr/share/tomcat/temp/tomcat.pid
Environment='CATALINA_OPTS=-Xms512M -Xmx1024M'
ExecStart=/usr/share/tomcat/bin/catalina.sh start
ExecStop=/usr/share/tomcat/bin/catalina.sh stop

[Install]
WantedBy=multi-user.target

Salva e chiudi il file, quindi ricarica il demone systemd con il seguente comando:

systemctl daemon-reload

Successivamente, avvia il servizio Tomcat e abilitalo per avviarsi al riavvio del sistema:

systemctl start tomcat  
systemctl enable tomcat

Puoi anche controllare lo stato di Tomcat con il seguente comando:

systemctl status tomcat

Dovresti ottenere il seguente output:

? tomcat.service - Tomcat Server
   Loaded: loaded (/etc/systemd/system/tomcat.service; disabled; vendor preset: disabled)
   Active: active (running) since Tue 2021-02-16 09:34:45 EST; 6s ago
  Process: 26546 ExecStart=/usr/share/tomcat/bin/catalina.sh start (code=exited, status=0/SUCCESS)
 Main PID: 26551 (java)
    Tasks: 35 (limit: 12523)
   Memory: 89.7M
   CGroup: /system.slice/tomcat.service
           ??26551 /usr/lib/jvm/jre/bin/java -Djava.util.logging.config.file=/usr/share/tomcat/conf/logging.properties -Djava.util.logging.man>

Feb 16 09:34:45 centos8 systemd[1]: Starting Tomcat Server...
Feb 16 09:34:45 centos8 systemd[1]: Started Tomcat Server.

Installa Apache Guacamole

Per prima cosa, scarica l’ultima versione di Guacamole con il seguente comando:

wget https://downloads.apache.org/guacamole/1.3.0/source/guacamole-server-1.3.0.tar.gz

Una volta completato il download, estrai il file scaricato con il seguente comando:

tar -xvzf guacamole-server-1.3.0.tar.gz

Successivamente, cambia la directory nella directory estratta e configurala con il seguente comando:

cd guacamole-server-1.3.0  
./configure --with-init-dir=/etc/init.d

Successivamente, installala nel tuo sistema con il seguente comando:

make  
make install  
ldconfig

Successivamente, ricarica il demone systemd con il seguente comando:

systemctl daemon-reload

Successivamente, avvia il servizio Guacamole e abilitalo per avviarsi al riavvio del sistema:

systemctl start guacd  
systemctl enable guacd

Puoi controllare lo stato del Guacamole con il seguente comando:

systemctl status guacd

Dovresti ottenere il seguente output:

? guacd.service - LSB: Guacamole proxy daemon
   Loaded: loaded (/etc/rc.d/init.d/guacd; generated)
   Active: active (running) since Tue 2021-02-16 09:37:15 EST; 4s ago
     Docs: man:systemd-sysv-generator(8)
  Process: 35723 ExecStart=/etc/rc.d/init.d/guacd start (code=exited, status=0/SUCCESS)
    Tasks: 1 (limit: 12523)
   Memory: 12.1M
   CGroup: /system.slice/guacd.service
           ??35726 /usr/local/sbin/guacd -p /var/run/guacd.pid

Feb 16 09:37:15 centos8 systemd[1]: Starting LSB: Guacamole proxy daemon...
Feb 16 09:37:15 centos8 guacd[35723]: Starting guacd: guacd[35724]: INFO:        Guacamole proxy daemon (guacd) version 1.3.0 started
Feb 16 09:37:15 centos8 guacd[35723]: SUCCESS
Feb 16 09:37:15 centos8 guacd[35726]: Listening on host 127.0.0.1, port 4822
Feb 16 09:37:15 centos8 systemd[1]: Started LSB: Guacamole proxy daemon.

Installa il client Guacamole

Successivamente, crea una directory per Guacamole e scarica il file del client Guacamole con il seguente comando:

mkdir /etc/guacamole  
wget https://downloads.apache.org/guacamole/1.3.0/binary/guacamole-1.3.0.war

Una volta scaricato, sposta il file scaricato nella directory /etc/guacamole:

mv guacamole-1.3.0.war /etc/guacamole/guacamole.war

Successivamente, crea un collegamento simbolico del file guacamole.war nella directory /usr/share/tomcat:

ln -s /etc/guacamole/guacamole.war /usr/share/tomcat/webapps/

Successivamente, imposta la directory home di Guacamole con il seguente comando:

echo "GUACAMOLE_HOME=/etc/guacamole" | tee -a /etc/default/tomcat

Successivamente, crea un file di configurazione Guacamole con il seguente comando:

nano /etc/guacamole/guacamole.properties

Aggiungi le seguenti righe:

guacd-hostname: localhost
guacd-port:    4822
user-mapping:    /etc/guacamole/user-mapping.xml
auth-provider:    net.sourceforge.guacamole.net.basic.BasicFileAuthenticationProvider

Salva e chiudi il file, quindi crea un collegamento simbolico della directory /etc/guacamole:

ln -s /etc/guacamole /usr/share/tomcat/.guacamole

Configura Guacamole

Successivamente, dovrai creare un file di mapping utente Guacamole per definire il server remoto a cui desideri connetterti da Guacamole.

Per prima cosa, genera una password segreta con il seguente comando:

echo -n your-password | openssl md5

Dovresti vedere il seguente output:

(stdin)= 0f6e4a1df0cf5ee97c2066953bed21b2

Successivamente, crea un file user-mapping.xml con il seguente comando:

nano /etc/guacamole/user-mapping.xml

Aggiungi i dettagli del tuo server Windows e Linux remoto come mostrato di seguito:






        
            ssh
            69.87.218.51
            22

        

        
            rdp
            15.185.162.149
            3389
            administrator

        

    


Salva e chiudi il file, quindi riavvia sia il servizio Guacamole che Tomcat per applicare le modifiche:

systemctl restart tomcat guacd

Una volta terminato, puoi procedere al passaggio successivo.

Configura il Firewall

Successivamente, dovrai consentire le porte 4822 e 8080 attraverso un firewall. Puoi consentirle con il seguente comando:

firewall-cmd --permanent --add-port=4822/tcp  
firewall-cmd --permanent --add-port=8080/tcp

Successivamente, ricarica il firewalld per applicare le modifiche:

firewall-cmd --reload

Accedi all’interfaccia web di Guacamole

Ora, apri il tuo browser web e accedi all’interfaccia web di Guacamole utilizzando l’URL http://your-server-ip:8080/guacamole. Dovresti vedere la seguente schermata:

Login Guacamole

Fornisci il tuo nome utente admin, la password e fai clic sul pulsante Login. Dovresti vedere il dashboard di Guacamole nella seguente schermata:

Desktop remoto Guacamole

Nella schermata sopra, puoi vedere sia i server Windows che Linux. Puoi fare clic per connetterti e gestire i server remoti.

Conclusione

Congratulazioni! hai installato e configurato con successo il server Guacamole su CentOS 8. Ora puoi aggiungere più server remoti al tuo server Guacamole e gestirli tramite un browser web.

Share: X/Twitter LinkedIn

Ricevi i nuovi post nella tua casella di posta.

Nessuno spam. Disiscriviti in qualsiasi momento.