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-openssl10Dopo 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 DevelSuccessivamente, 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-libsSuccessivamente, disabilita il repo Devel con il seguente comando:
dnf config-manager --disable DevelSuccessivamente, 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.gzSuccessivamente, cambia la directory nella directory estratta e configurala con il seguente comando:
cd libtelnet-*/
./configureSuccessivamente, installala nel tuo sistema con il seguente comando:
make
make installUna 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-develUna volta installato, verifica la versione di Java utilizzando il seguente comando:
java -versionDovresti 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 tomcatSuccessivamente, 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.gzUna volta completato il download, estrai il file scaricato con il seguente comando:
tar -xvf apache-tomcat-9.0.43.tar.gzSuccessivamente, sposta Tomcat nella directory /usr/share
mv apache-tomcat-9.0.43 /usr/share/tomcatSuccessivamente, 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.serviceAggiungi 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.targetSalva e chiudi il file, quindi ricarica il demone systemd con il seguente comando:
systemctl daemon-reloadSuccessivamente, avvia il servizio Tomcat e abilitalo per avviarsi al riavvio del sistema:
systemctl start tomcat
systemctl enable tomcatPuoi anche controllare lo stato di Tomcat con il seguente comando:
systemctl status tomcatDovresti 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.gzUna volta completato il download, estrai il file scaricato con il seguente comando:
tar -xvzf guacamole-server-1.3.0.tar.gzSuccessivamente, cambia la directory nella directory estratta e configurala con il seguente comando:
cd guacamole-server-1.3.0
./configure --with-init-dir=/etc/init.dSuccessivamente, installala nel tuo sistema con il seguente comando:
make
make install
ldconfigSuccessivamente, ricarica il demone systemd con il seguente comando:
systemctl daemon-reloadSuccessivamente, avvia il servizio Guacamole e abilitalo per avviarsi al riavvio del sistema:
systemctl start guacd
systemctl enable guacdPuoi controllare lo stato del Guacamole con il seguente comando:
systemctl status guacdDovresti 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.warUna volta scaricato, sposta il file scaricato nella directory /etc/guacamole:
mv guacamole-1.3.0.war /etc/guacamole/guacamole.warSuccessivamente, 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/tomcatSuccessivamente, crea un file di configurazione Guacamole con il seguente comando:
nano /etc/guacamole/guacamole.propertiesAggiungi 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/.guacamoleConfigura 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 md5Dovresti vedere il seguente output:
(stdin)= 0f6e4a1df0cf5ee97c2066953bed21b2
Successivamente, crea un file user-mapping.xml con il seguente comando:
nano /etc/guacamole/user-mapping.xmlAggiungi 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 guacdUna 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/tcpSuccessivamente, ricarica il firewalld per applicare le modifiche:
firewall-cmd --reloadAccedi 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:

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

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.
Ricevi i nuovi post nella tua casella di posta.
Nessuno spam. Disiscriviti in qualsiasi momento.