Guacamole Installation · 7 min read · Nov 11, 2025

Installieren und Verwenden von Guacamole Remote Desktop auf CentOS 8

Apache Guacamole ist eine kostenlose, Open-Source, webbasierte und clientlose Remote-Desktop-Anwendung, die Standardprotokolle wie VNC, RDP und SSH unterstützt. Sie ermöglicht den Zugriff auf Linux- und Windows-PCs über einen Webbrowser via RDP, SSH oder VNC. Es ist clientlos, sodass Sie keine Plugins oder Client-Software installieren müssen. Es besteht aus zwei Komponenten: Guacamole Server und Guacamole Client. Der Guacamole-Server bietet die serverseitigen und nativen Komponenten, die erforderlich sind, um eine Verbindung zu einem Remote-PC herzustellen, während der Guacamole-Client eine HTML 5-Webanwendung ist, die verwendet wird, um eine Verbindung zum Remote-PC herzustellen.

In diesem Tutorial zeigen wir Ihnen, wie Sie den Guacamole-Server auf CentOS 8 installieren.

Voraussetzungen

  • Ein Server, der CentOS 8 ausführt.
  • Ein Root-Passwort ist für den Server konfiguriert.

Erste Schritte

Zuerst müssen Sie einige erforderliche Pakete auf Ihrem Server installieren. Sie können alle mit dem folgenden Befehl installieren:

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

Nachdem Sie alle erforderlichen Pakete installiert haben, müssen Sie das EPEL-, PowerTools- und Devel-Repo in Ihrem System aktivieren. Sie können sie mit dem folgenden Befehl aktivieren:

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

Als Nächstes installieren Sie weitere erforderliche Tools mit dem folgenden Befehl:

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

Als Nächstes deaktivieren Sie das Devel-Repo mit dem folgenden Befehl:

dnf config-manager --disable Devel

Als Nächstes müssen Sie die Telnet-Bibliothek in Ihrem System kompilieren.

Zuerst laden Sie sie mit dem folgenden Befehl herunter:

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

Sobald der Download abgeschlossen ist, extrahieren Sie die heruntergeladene Datei mit dem folgenden Befehl:

tar -xf libtelnet-*.tar.gz

Als Nächstes wechseln Sie in das extrahierte Verzeichnis und konfigurieren es mit dem folgenden Befehl:

cd libtelnet-*/  
./configure

Als Nächstes installieren Sie es in Ihrem System mit dem folgenden Befehl:

make   
make install

Sobald es installiert ist, können Sie mit dem nächsten Schritt fortfahren.

Java installieren

Guacamole ist eine Java-basierte Software, daher muss Java auf Ihrem Server installiert sein. Wenn es nicht installiert ist, können Sie es mit dem folgenden Befehl installieren:

dnf install java-11-openjdk-devel

Sobald es installiert ist, überprüfen Sie die Java-Version mit dem folgenden Befehl:

java -version

Sie sollten die folgende Ausgabe erhalten:

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)

Tomcat installieren

Apache Tomcat wird verwendet, um den Inhalt des Guacamole-Clients bereitzustellen. Daher müssen Sie Tomcat auf Ihrem Server installieren.

Zuerst erstellen Sie einen separaten Benutzer und eine Gruppe für Tomcat mit dem folgenden Befehl:

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

Als Nächstes laden Sie die neueste Version von Tomcat mit dem folgenden Befehl herunter:

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

Sobald der Download abgeschlossen ist, extrahieren Sie die heruntergeladene Datei mit dem folgenden Befehl:

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

Als Nächstes verschieben Sie Tomcat in das Verzeichnis /usr/share

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

Als Nächstes setzen Sie die richtigen Berechtigungen für das Tomcat-Verzeichnis:

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

Sobald Sie fertig sind, können Sie mit dem nächsten Schritt fortfahren.

Erstellen Sie eine Systemd-Dienstdatei für Tomcat

Als Nächstes müssen Sie eine systemd-Dienstdatei für Tomcat erstellen. Sie können sie mit dem folgenden Befehl erstellen:

nano /etc/systemd/system/tomcat.service

Fügen Sie die folgenden Zeilen hinzu:

[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

Speichern Sie die Datei und schließen Sie sie, und laden Sie dann den systemd-Daemon mit dem folgenden Befehl neu:

systemctl daemon-reload

Als Nächstes starten Sie den Tomcat-Dienst und aktivieren ihn, damit er beim Systemneustart gestartet wird:

systemctl start tomcat  
systemctl enable tomcat

Sie können auch den Status von Tomcat mit dem folgenden Befehl überprüfen:

systemctl status tomcat

Sie sollten die folgende Ausgabe erhalten:

? 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.

Apache Guacamole installieren

Zuerst laden Sie die neueste Version von Guacamole mit dem folgenden Befehl herunter:

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

Sobald der Download abgeschlossen ist, extrahieren Sie die heruntergeladene Datei mit dem folgenden Befehl:

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

Als Nächstes wechseln Sie in das extrahierte Verzeichnis und konfigurieren es mit dem folgenden Befehl:

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

Als Nächstes installieren Sie es in Ihrem System mit dem folgenden Befehl:

make  
make install  
ldconfig

Als Nächstes laden Sie den systemd-Daemon mit dem folgenden Befehl neu:

systemctl daemon-reload

Als Nächstes starten Sie den Guacamole-Dienst und aktivieren ihn, damit er beim Systemneustart gestartet wird:

systemctl start guacd  
systemctl enable guacd

Sie können den Status von Guacamole mit dem folgenden Befehl überprüfen:

systemctl status guacd

Sie sollten die folgende Ausgabe erhalten:

? 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.

Guacamole-Client installieren

Als Nächstes erstellen Sie ein Verzeichnis für Guacamole und laden die Guacamole-Clientdatei mit dem folgenden Befehl herunter:

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

Sobald der Download abgeschlossen ist, verschieben Sie die heruntergeladene Datei in das Verzeichnis /etc/guacamole:

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

Als Nächstes erstellen Sie einen symbolischen Link der guacamole.war-Datei zum Verzeichnis /usr/share/tomcat:

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

Als Nächstes setzen Sie das Guacamole-Home-Verzeichnis mit dem folgenden Befehl:

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

Als Nächstes erstellen Sie eine Guacamole-Konfigurationsdatei mit dem folgenden Befehl:

nano /etc/guacamole/guacamole.properties

Fügen Sie die folgenden Zeilen hinzu:

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

Speichern Sie die Datei und schließen Sie sie, und erstellen Sie dann einen symbolischen Link zum Verzeichnis /etc/guacamole:

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

Guacamole konfigurieren

Als Nächstes müssen Sie eine Guacamole-Benutzermapping-Datei erstellen, um den Remote-Server zu definieren, mit dem Sie von Guacamole aus eine Verbindung herstellen möchten.

Zuerst generieren Sie ein geheimes Passwort mit dem folgenden Befehl:

echo -n your-password | openssl md5

Sie sollten die folgende Ausgabe sehen:

(stdin)= 0f6e4a1df0cf5ee97c2066953bed21b2

Als Nächstes erstellen Sie eine user-mapping.xml-Datei mit dem folgenden Befehl:

nano /etc/guacamole/user-mapping.xml

Fügen Sie die Details Ihrer Remote-Windows- und Linux-Server wie unten gezeigt hinzu:






        
            ssh
            69.87.218.51
            22

        

        
            rdp
            15.185.162.149
            3389
            administrator

        

    

Speichern Sie die Datei und schließen Sie sie, und starten Sie sowohl den Guacamole- als auch den Tomcat-Dienst neu, um die Änderungen anzuwenden:

systemctl restart tomcat guacd

Sobald Sie fertig sind, können Sie mit dem nächsten Schritt fortfahren.

Firewall konfigurieren

Als Nächstes müssen Sie die Ports 4822 und 8080 durch eine Firewall zulassen. Sie können sie mit dem folgenden Befehl zulassen:

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

Als Nächstes laden Sie die firewalld neu, um die Änderungen anzuwenden:

firebase-cmd --reload

Greifen Sie auf die Guacamole-Web-UI zu

Öffnen Sie jetzt Ihren Webbrowser und greifen Sie auf die Guacamole-Weboberfläche über die URL http://your-server-ip:8080/guacamole zu. Sie sollten den folgenden Bildschirm sehen:

Guacamole Login

Geben Sie Ihren Admin-Benutzernamen, Ihr Passwort ein und klicken Sie auf die Schaltfläche Anmelden. Sie sollten das Guacamole-Dashboard auf dem folgenden Bildschirm sehen:

Guacamole Remote Desktop

Auf dem obigen Bildschirm können Sie sowohl Windows- als auch Linux-Server sehen. Sie können darauf klicken, um eine Verbindung herzustellen und die Remote-Server zu verwalten.

Fazit

Herzlichen Glückwunsch! Sie haben den Guacamole-Server erfolgreich auf CentOS 8 installiert und konfiguriert. Sie können jetzt weitere Remote-Server zu Ihrem Guacamole-Server hinzufügen und sie über einen Webbrowser verwalten.

Share: X/Twitter LinkedIn

Erhalte neue Beiträge in deinem Posteingang.

Kein Spam. Jederzeit abmelden.