Guía de Instalación de Apache Guacamole en Ubuntu 22.04

1. Actualizar el sistema

Antes de comenzar, asegúrate de que tu sistema está actualizado:

sudo apt update && sudo apt upgrade -y

2. Instalar dependencias

Apache Guacamole requiere varios paquetes previos. Instálalos con:

sudo apt install -y build-essential libcairo2-dev libjpeg-turbo8-dev libpng-dev libtool-bin \
libossp-uuid-dev libavcodec-dev libavutil-dev libswscale-dev freerdp2-dev libpango1.0-dev \
libssh2-1-dev libtelnet-dev libvncserver-dev libpulse-dev libssl-dev libvorbis-dev libwebp-dev \
tomcat9 tomcat9-admin tomcat9-common tomcat9-user

3. Descargar Apache Guacamole

Descarga la versión más reciente de Guacamole Server y Guacamole Client:

wget https://apache.org/dyn/closer.lua/guacamole/1.5.0/source/guacamole-server-1.5.0.tar.gz
wget https://apache.org/dyn/closer.lua/guacamole/1.5.0/binary/guacamole-1.5.0.war -O guacamole.war

4. Compilar e instalar Guacamole Server

Extrae el código fuente y compílalo:

tar -xzf guacamole-server-1.5.0.tar.gz
cd guacamole-server-1.5.0
./configure --with-systemd-dir=/etc/systemd/system
make -j$(nproc)
sudo make install
sudo ldconfig

Habilita y arranca el servicio:

sudo systemctl daemon-reload
sudo systemctl enable guacd
sudo systemctl start guacd

5. Configurar Guacamole Client

Copia el archivo .war en la ruta de Tomcat:

sudo mv guacamole.war /var/lib/tomcat9/webapps/
sudo systemctl restart tomcat9

6. Configurar la autenticación

Crea el directorio de configuración:

sudo mkdir -p /etc/guacamole
sudo nano /etc/guacamole/guacamole.properties

Agrega lo siguiente:

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

Guarda el archivo (Ctrl + X, Y, Enter).

6.1 Crear usuarios

Crea el archivo user-mapping.xml:

sudo nano /etc/guacamole/user-mapping.xml

Agrega la siguiente configuración:

<user-mapping>
    <authorize username="admin" password="admin123">
        <connection name="Servidor Remoto">
            <protocol>rdp</protocol>
            <param name="hostname">192.168.1.100</param>
            <param name="port">3389</param>
            <param name="username">usuario</param>
            <param name="password">password123</param>
        </connection>
    </authorize>
</user-mapping>

Guarda el archivo y asigna permisos:

sudo chmod 600 /etc/guacamole/user-mapping.xml
sudo chown tomcat /etc/guacamole/user-mapping.xml

7. Crear un enlace simbólico

sudo ln -s /etc/guacamole /var/lib/tomcat9/.guacamole

8. Reiniciar los servicios

sudo systemctl restart guacd tomcat9

9. Acceder a Apache Guacamole

Abre un navegador y accede a:

http://<TU_SERVIDOR>:8080/guacamole

Usa el usuario admin y la contraseña admin123.

Juan José Fernández Durán

Arquitecto IT & Consultor IT

See author's posts