Ubuntu 16.04.x LTS - Guacamole HTML5 Remotedesktop Gateway installieren mit Apache Reverse Proxy
Aus znilwiki
Changelog:
- 07.09.2016: Erste Version des Artikel mit Gucamole Version 0.9.9
- 02.11.2017: Überarbeitung auf Guacamole Version 0.9.13
- 12.11.2017: Anpassung MySQL-Connector auf Version 5.1.43
- 10.12.2018: Link zu Websocket-Test eingefügt
Nach diversen Versuchen über einen Webrowser per RDP auf eine Windows 7 VM zu zugreifen, unter anderem mit VMware View etc. habe ich im Internet Guacamole gefunden.
http://guac-dev.org/
Es handelt sich dabei um ein HTML5 Gateway über das man per RDP, VNC und SSH auf andere Systeme zugreifen kann.
In dieser Anleitung installiere ich Guacamole auf einen bestehenden Webserver in einer Subdomain.
Ausgangslage
Ich habe hier einen ESXi Server auf dem eine VM mit dem Namen WEBSERVER mit Apache2 als Webserver läuft (IP: 192.168.45.10).
Nach der Installation kann man von extern über eine Subdomain remote.znil.net auf die Guacamole-Webseite per https:// zugreifen.
Guacamole ist auch in den Paketquellen von Ubuntu 16.04. enthalten - jedoch in der alten Version 0.8.3, nicht in der aktuellen 0.9.9
Also doch selbst Hand anlegen!
nano /etc/apache2/sites-available/ispconfig.vhostmit anschließendem Neustart des Apache
Voraussetzungen installieren
apt install make libssh2-1-dev libtelnet-dev libpango1.0-dev libossp-uuid-dev libcairo2-dev libpng12-dev freerdp-x11 libssh2-1 libvncserver-dev libfreerdp-dev libvorbis-dev libssl1.0.0 gcc libssh-dev libpulse-dev tomcat7 tomcat7-admin tomcat7-docs ghostscript libwebp-dev libavcodec-dev libavutil-dev libswscale-dev
Danach sollte der Tomcat bereits auf Port 8080 lauschen - wenn ihr also
http://servername-oder-ip:8080
aufruft kommt die Standardseite von Tomcat:
Guacamole herunterladen und kompilieren
Release Version
Bei der Überarbeitung im November 2017 dieses Artikels war die Version
Guacamole 0.9.13
aktuell - ggf. müsst ihr die Namen und Pfade anpassen wenn Ihr eine neuere Version nehmt.
cd /usr/src wget http://mirror.ibcp.fr/pub/apache/incubator/guacamole/0.9.13-incubating/source/guacamole-server-0.9.13-incubating.tar.gz wget http://mirror.ibcp.fr/pub/apache/incubator/guacamole/0.9.13-incubating/binary/guacamole-0.9.13-incubating.war
Damit haben wir den Quellcode des Servers und die .war Datei des Clients heruntergeladen.
Dann den Quellcode noch entpacken:
tar xvzf guacamole-server-0.9.13-incubating.tar.gz
Kompilieren
cd /usr/src/guacamole-server-0.9.13-incubating ./configure --with-init-dir=/etc/init.d
Nach viel Text (die ganzen Checks) müsste am Ende eine Meldung wie folgt kommen:
------------------------------------------------
guacamole-server version 0.9.13-incubating
------------------------------------------------
Library status:
freerdp ............. yes
pango ............... yes
libavcodec .......... yes
libavutil ........... yes
libssh2 ............. yes
libssl .............. yes
libswscale .......... yes
libtelnet ........... yes
libVNCServer ........ yes
libvorbis ........... yes
libpulse ............ yes
libwebp ............. yes
Protocol support:
RDP ....... yes
SSH ....... yes
Telnet .... yes
VNC ....... yes
Services / tools:
guacd ...... yes
guacenc .... yes
Init scripts: /etc/init.d
Type "make" to compile guacamole-server.Wenn da irgendwo NICHT yes steht da fehlt ein Paket aus den Voraussetzungen! Bei der Überarbeitung dieses Artikels wurden da welche hinzugefügt!
Wenn da über yes steht -> Prima! Also kompilieren und installieren wir:
make make install
Test Server
Er hat uns nun ein Start-Script hinterlegt.
/etc/init.d/guacd start
Der Start schlägt aber fehl mit einem
Starting guacd: /usr/local/sbin/guacd: error while loading shared libraries: libguac.so.12: cannot open shared object file: No such file or directory FAIL
Deshalb geben wir einfach ein
ldconfig /etc/init.d/guacd start
ein und nun geht es:
Starting guacd: guacd[1608]: INFO: Guacamole proxy daemon (guacd) version 0.9.13-incubating started SUCCESS
Wir beenden den Server aber gleich wieder:
/etc/init.d/guacd stop
da wir erst einmal die Konfigurationsdateien anlegen müssen.
Guacamole Server konfigurieren
Wir legen das Verzeichnis für die Konfigurationsdateien an das Guacamole erwartet:
mkdir /etc/guacamole
und erstellen die Server-Konfigurationsdatei:
guacamole.properties
mkdir /etc/guacamole
und die Datei:
nano /etc/guacamole/guacamole.properties
Inhalt:
basic-user-mapping: /etc/guacamole/user-mapping.xml
user-mapping.xml
Wir haben ja gerade zuvor die Datei angegeben in welcher die
- Benutzernamen
- Kennwörter
- verfügbare RDP / VNC / Telnet und SSH Verbindungen
konfiguriert werden. Also müssen wir die auch anlegen:
nano /etc/guacamole/user-mapping.xml
Inhalt der Datei - müsst Ihr an eure Bedürfnisse anpassen. Im Zweifelsfall löscht überflüssige Parameter. Wenn z.B. Benutzername und Password nicht angegeben werden fragt er danach.
<user-mapping>
<!-- Pro Benutzer gibt es einen Abschnitt für Benutzername, Passwort -->
<!-- und den verfügbaren Verbindungen für diesen Benutzer -->
<!-- Benutzer Administrator-->
<authorize username="admin" password="geheimesPasswort">
<!-- Verbindung 1 für Benuter admin -->
<!-- RDP - Remotedesktop-Verbindung -->
<!-- Parameter siehe https://guacamole.incubator.apache.org/doc/gug/configuring-guacamole.html#rdp -->
<connection name="Windows 7 Test VM">
<protocol>rdp</protocol>
<param name="hostname">192.168.42.40</param> <!-- FQDN oder IP des Zielhost -->
<param name="port">3389</param> <!-- Port, Standard ist 3389 -->
<param name="username">Testbenutzer</param> <!-- Anmeldename / Benutzername -->
<param name="password">password123</param> <!-- Password für den Benutzer -->
<param name="domain">TEST-VM</param> <!-- Domäne des Benutzer, ggf. Hostname des Ziels -->
<param name="disable-audio">true</param> <!-- Audio-Übertragung deaktivieren -->
<param name="console">true</param> <!-- sorgt z.B. bei Terminalserver dafür die Consolen-Sitzung zu bekommen, ansonsten sinnlos -->
<param name="server-layout">de-de-qwertz</param> <!-- mit deutscher Tastatur verbinden -->
<param name="ignore-cert">true</param> <!-- alle Zertifikate akzeptieren -->
</connection>
<!-- Verbindung 2 für Benuter admin -->
<!-- SSH - Verbindung -->
<!-- Parameter siehe https://guacamole.incubator.apache.org/doc/gug/configuring-guacamole.html#ssh -->
<connection name="SSH Webserver">
<protocol>ssh</protocol>
<param name="hostname">192.168.42.10</param> <!-- FQDN oder IP des Zielhost -->
<param name="port">22</param> <!-- Port, Standard ist 22 -->
<param name="username">user23</param> <!-- Anmeldename / Benutzername -->
<param name="password">password123</param> <!-- Password für den Benutzer -->
</connection>
</authorize>
</user-mapping>
GUACAMOLE_HOME setzen
Die neue Version sucht in dieser Umgebungsvariablen nach dem Pfad der Konfigurationsdateien:
nano /etc/environment
und die folgende Zeile anhängen:
GUACAMOLE_HOME="/etc/guacamole"
Automatischen Start des Servers einrichten
Das geht netter Weise immer noch per
update-rc.d guacd defaults
Das für systemctl notwendige Startskript baut er uns dann automatisch
Fehler Dateiaustausch und Audio beheben
Guacamole kann in einer SSH oder RDP Sitzung auch Audiosignale weitereichen oder den Drucker nutzen.
Noch interessanter finde ich den Up- oder Download von Dateien aus der Sitzung, insbesondere bei RDP.
So wie wir bis jetzt installiert haben funktioniert das aber nicht da das genutzte FreeRDP 3 Plugins von Guacamole nicht finden kann.
Den Fehler beheben wir mit den nächsten Zeilen:
ln -s /usr/local/lib/freerdp/guacdr-client.so /usr/lib/x86_64-linux-gnu/freerdp/ ln -s /usr/local/lib/freerdp/guacsnd-client.so /usr/lib/x86_64-linux-gnu/freerdp/ ln -s /usr/local/lib/freerdp/guacsvc-client.so /usr/lib/x86_64-linux-gnu/freerdp/
Guacamole Client installieren
Den Client haben wir vorhin schon mit herunter geladen und müsste nun unter
/usr/src/guacamole-0.9.13-incubating.war
bereit liegen.
Kopieren wir diese an Ihren Bestimmungsort:
cp /usr/src/guacamole-0.9.13-incubating.war /var/lib/tomcat7/webapps/guacamole.war
Der Client sucht guacamole.properties und andere Konfigurationsdateien - allerdings an einem anderen Ort als wir diese abgelegt haben.
Deshalb legen wir einen symbolischen Link dahin an:
ln -s /etc/guacamole /usr/share/tomcat7/.guacamole
Nun müssen wir den Tomcat neu starten:
systemctl restart tomcat7.service
Der erste Test
Wir starten den Dienst wieder:
systemctl start guacd.service
Wir können nun auf die Webseite des Clients zugreifen:
http://FQDN-oder-IP:8080/guacamole/
Und melden uns mit dem gerade angelegten Benutzer an:
Ein Klick auf die Verbindungen unten startet jeweils die ausgewählte Verbindung:
Mit den Zurück Button des Browser geht es wieder ins das Menü - die Verbindung bleibt dann aber erhalten. Besser ist die Sitzung richtig zu beenden, bei RDP also abmelden.
Logdateien auswerten
Wenn mal etwas nicht wie geplant funktioniert bei einer Verbindung so können wir hierzu in das syslog schauen.
tail -f /var/log/syslog
Falls euerr Server mehr zu tun hat und das Syslog entsprechend ständig zu tun hat empfiehlt es sich die Ausgabe auf die Guacamole-Meldungen zu filtern:
tail -f -n 200 /var/log/syslog | grep guacd
Beispielausgabe beim Aufbau einer RDP-Verbindung:
May 8 10:16:54 web01 guacd[20582]: Protocol "rdp" selected May 8 10:16:54 web01 guacd[20582]: Connection ID is "$b5f8f9d9-1ab8-49bc-a5ea-970015a30a21" May 8 10:16:54 web01 guacd[20582]: Security mode: ANY May 8 10:16:54 web01 guacd[20582]: Loading keymap "base" May 8 10:16:54 web01 guacd[20582]: Loading keymap "de-de-qwertz" May 8 10:16:54 web01 guacd[20582]: Starting client May 8 10:16:54 web01 guacd[20582]: guacdr connected. May 8 10:16:54 web01 guacd[20582]: guacsnd connected. May 8 10:16:54 web01 guacd[20582]: Connected to RDPDR 1.12 as client 0x0007 May 8 10:16:54 web01 guacd[20582]: Ignoring server capability set type=0x0001, length=44 May 8 10:16:54 web01 guacd[20582]: Ignoring server capability set type=0x0002, length=8 May 8 10:16:54 web01 guacd[20582]: Ignoring server capability set type=0x0003, length=8 May 8 10:16:54 web01 guacd[20582]: Ignoring server capability set type=0x0004, length=8 May 8 10:16:54 web01 guacd[20582]: Ignoring server capability set type=0x0005, length=8 May 8 10:16:54 web01 guacd[20582]: Sending capabilities... May 8 10:16:54 web01 guacd[20582]: Capabilities sent. May 8 10:16:54 web01 guacd[20582]: Client ID confirmed May 8 10:16:58 web01 guacd[20582]: User logged on May 8 10:16:58 web01 guacd[20582]: Sending printer May 8 10:16:58 web01 guacd[20582]: Registered device 0 (Guacamole Printer) May 8 10:16:58 web01 guacd[20582]: Sending filesystem May 8 10:16:58 web01 guacd[20582]: Registered device 1 (Guacamole Filesystem) May 8 10:16:58 web01 guacd[20582]: All supported devices sent. May 8 10:16:58 web01 guacd[20582]: Device 0 (Guacamole Printer) connected successfully May 8 10:16:58 web01 guacd[20582]: Device 1 (Guacamole Filesystem) connected successfully May 8 10:17:00 web01 guacd[20582]: Accepted format: 16-bit PCM with 2 channels at 44100 Hz
Apache Reverse Proxy
So, nun wollen wir das ganze über eine Subdomain und mit SSL Verschlüsselung über https von extern erreichen.
In Apache lege ich einen neuen .vHost an und verpasse diesem ein SSL Zertifikat.
Wie das geht?
Entsprechende Datei unter /etc/apache2/sites-available anlegen:
touch /etc/apache2/sites-available/remote.znil.net.vhost
Mit dem nachfolgenden Inhalt füllen (nächster Abschnitt, erst machen!).
Ein SSL-Zertifkat könnt Ihr z.B. nach folgender Anleitung erstellen: https://thomas-leister.de/apache-webserver-ssl-verschlusselung-einrichten/
Seite aktivieren:
a2ensite remote.znil.net.vhost
und den Apache neu starten:
systemctl restart apache2.service
Ich benutze für das ganze ISPConfig und bearbeite die .vhost dann nur noch manuell.
Apache .vhost anpassen
Hinweis: Leider macht die ein oder andere Firmenfirewall ärger bei der Verbindung zu Guacamole. Insbesondere solche die den Datenverkehr trotz SSL zerlegen und überwachen. Es kann helfen wenn man den proxy_wstunnel und dessen Konfiguration, also den Abschnitt <Location /websocket-tunnel> weglässt, dann wird nur "normales" http verwendet.
Auf eurem Apache müssen die Module für den Proxy und das Rewrite aktiv sein, falls das noch nicht der Fall ist:
a2enmod rewrite a2enmod proxy_http a2enmod ssl a2enmod proxy_wstunnel
Da ich das ganze unter einer Subdomain betreibe habe ich für diese eine eigene .vhost Datei
nano /etc/apache2/sites-available/login.znil.net.vhost
Wenn ihr das ohne macht bzw. das ganze in einem virtuellen Verzeichnis haben wollt müsst ihr ggf. die Standard .vhost von Apache anpassen.
Den Inhalt der .vhost ändere ich wie folgt:
<VirtualHost 192.168.45.10:80> ServerName remote.znil.net ServerAdmin webmaster@znil.net RewriteEngine On RewriteCond %{HTTPS} !=on RewriteRule ^/?(.*) https://%{SERVER_NAME}/$1 [R,L] </VirtualHost> <VirtualHost 192.168.45.10:443> ServerName remote.znil.net ServerAdmin webmaster@znil.net SSLEngine on SSLProtocol All -SSLv2 -SSLv3 SSLCertificateFile /var/www/clients/client0/web14/ssl/remote.znil.net.crt SSLCertificateKeyFile /var/www/clients/client0/web14/ssl/remote.znil.net.key SSLCertificateChainFile /var/www/clients/client0/web14/ssl/remote.znil.net.bundle ProxyPass / http://192.168.45.10:8080/guacamole/ flushpackets=on ProxyPassReverse / http://192.168.45.55:8080/guacamole/ ProxyPassReverseCookiePath /guacamole / <Location /websocket-tunnel> Order allow,deny Allow from all ProxyPass ws://192.168.45.10:8080/guacamole/websocket-tunnel ProxyPassReverse ws://192.168.45.10:8080/guacamole/websocket-tunnel </Location> SetEnvIf Request_URI "^/tunnel" dontlog CustomLog /var/log/apache2/guac.log common env=!dontlog </VirtualHost>
Ihr müsstet folgendes anpassen:
- IP-Adresse eures Apache Servers
- Name eurer Subdomain
- Pfad zu den SSL-Dateien
- IP-Adresse zum Guacamole-Server
Nach einem Neustart des Apache
systemctl reload apache2.service
könnt Ihr nun über eben diese darauf zugreifen:
https://remote.znil.net
Bedienung von Guacamole
Wenn Ihr in einer Sitzung seit (egal ob RDP, SSH, VCN oder Telnet) drückt einmal die Tastenkombination
- STRG - ALT - SHIFT
Dann erscheint ein Menü mit weiteren Punkten und z.B. einer Zwischenablage oder der Möglichkeit die Verbindung auch einfach nur zu trennen:
Umbau auf MySQL Datenbank
Immer wenn wir einen neuen Host hinzufügen wollen oder einen Benutzer oder sogar beides müssen wir jedesmal die
nano /etc/guacamole/user-mapping.xml
bearbeiten - und dann mit
service guacd restart && service tomcat7 restart
alles neu starten - wobei aktive Verbindungen unterbrochen werden usw. ... und gerade bin ich an einem & in der XML Datei fast verzweifelt ....
Wenn wir Gucamole mit MySQL verbinden können wir die Konfiguration dynamisch ohne Neustart ändern - und das ganze auch noch in der Weboberfläche machen.
Also her damit!
MySQL installieren
Falls es noch nicht auf eurem Server ist muss MySQL erst einmal installiert werden:
apt-get install mysql-server mysql-client
MySQL Extension herunterladen und entpacken
Also, wir haben hier die Version
0.9.13
installiert - also brauchen wir auch die Extension in der passenden Version dazu:
https://guacamole.incubator.apache.org/releases/0.9.13-incubating/
Also wechseln wir wieder in src' Verzeichnis und laden es direkt herunter:
cd /usr/src/ wget http://mirror.ibcp.fr/pub/apache/incubator/guacamole/0.9.13-incubating/binary/guacamole-auth-jdbc-0.9.13-incubating.tar.gz tar xvzf guacamole-auth-jdbc-0.9.13-incubating.tar.gz cd guacamole-auth-jdbc-0.9.13-incubating/mysql/
Lib-Dateien kopieren
Die Datei guacamole-auth-jdbc-mysql-0.9.9.jar aus dem Unterverzeichnis
/usr/src/guacamole-auth-jdbc-0.9.9/mysql/
müssen in das Erweiterungsverzeichnis kopieren.
Standard ist
GUACAMOLE_HOME/extensions
Hier also
/etc/guacamole/extensions
also dorthin damit:
mkdir /etc/guacamole/extensions cp /usr/src/guacamole-auth-jdbc-0.9.13-incubating/mysql/guacamole-auth-jdbc-mysql-0.9.13-incubating.jar /etc/guacamole/extensions/
MySQL Connector herunterladen und kopieren
Guacamole braucht unbedingt eine
mysql-connector-java-x.x.xx-bin.jar
die wir leider erst einmal haben müssen. In der offziellen Anleitung ist das Ding einfach mit im heruntergeladenen Paket - ist es aber nicht!
cd /usr/src/ wget http://dev.mysql.com/get/Downloads/Connector-J/mysql-connector-java-5.1.43.tar.gz tar xvzf mysql-connector-java-5.1.43.tar.gz mkdir /etc/guacamole/lib cp /usr/src/mysql-connector-java-5.1.43/mysql-connector-java-5.1.43-bin.jar /etc/guacamole/lib/
MySQL Datenbank und Benutzer anlegen
Nun brauchen wir noch eine Datenbank mit passenden Benutzer dazu:
mysql -u root -p -e "create database guacamole" mysql -u root -p -e "grant all on guacamole.* to guacamole@localhost identified by 'guacamole'"
Es gibt nun also die Datenbank guacamole auf die der Benutzer guacamole mit dem Passwort guacamole Zugriff hat.
Keine Angst - der kann nur local auf die Datenbank zugreifen, ein Zugriff aus dem Internet ist nicht möglich.
Schema in MySQL importieren
Die liegen unter
/usr/src/guacamole-auth-jdbc-0.9.13-incubating/mysql/schema
und müssen nur importiert werden - am besten gleich unter unserem neu anlegten Benutzer:
mysql -uguacamole -pguacamole guacamole < /usr/src/guacamole-auth-jdbc-0.9.13-incubating/mysql/schema/001-create-schema.sql mysql -uguacamole -pguacamole guacamole < /usr/src/guacamole-auth-jdbc-0.9.13-incubating/mysql/schema/002-create-admin-user.sql
guacamole.properties an MySQL anpassen
Nun müssen wir noch die Konfigurationsdatei ändern.
nano /etc/guacamole/guacamole.properties
und den Inhalt wie folgt ändern (alles andere löschen):
# MySQL properties
mysql-hostname: localhost
mysql-port: 3306
mysql-database: guacamole
mysql-username: guacamole
mysql-password: guacamole
Nun noch den Tomcat neu starten:
service tomcat7 restart
An der Webseite Anmelden
Wir melden uns nun an der Guacamole Webseite folgenden Daten an:
Benutzername: guacadmin Passwort: guacadmin
Oben Rechts ist das Menü in welchem Ihr die Settings aufrufen solltet:
Geht dann auf den Reiter Einstellungen und wählt das Register Benutzer und dort den guacadmin aus:
Dort verpasst Ihr diesem erst einmal ein neues Passwort:
Ich empfehle einen neuen Administrations-Benutzer anzulegen und den guacadmin zu löschen oder zu deaktivieren.
Dateiaustausch in Remotedesktop Sitzungen
Eine richtig tolles Feature ist der Dateiaustausch bei RDP-Sitzungen.
Obwohl das ganze in einem eingeschränktem Webbrowser läuft bekommt man so sehr leicht eine Datei hoch- oder runtergeladen.
Vorbereitung
Wir benötigen mindestens einen Ordner auf unserem Linux-Host für den Dateiaustausch:
mkdir /home/tausch chmod 777 /home/tausch
Der Benutzer unter dem der Dienst guacd läuft muss volle Zugriffsrechte auf diesen Ordner haben.
Wenn Ihr nichts geändert habt läuft der Dienst als Benutzer root - und habt auch als dieser den Ordner angelegt.
Konfiguration der Verbindung
In einer RDP-Verbindung wählen wir nun folgende Optionen
Enable drive .............: X Drive path ...............: /home/tausch Automatically create drive: X
Das ist schon alles. Sind wir nun Verbunden wird uns der Ordner unter dem Arbeitsplatz angezeigt:
Zum Testen zieht nun einfach eine Datei in das Browserfenster:
Die Dateien erscheinen dann innerhalb des Ordners - ggf. einmal F5 drücken.
Wollt Ihr eine Datei herunterladen so schiebt diese einfach in den Order Download:
Er lädt die Datei dann runter und mit dem Klick auf den Link könnt Ihr diese lokal speichern.