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.
