🚧Guacamole

Apache Guacamole Manual — Apache Guacamole Manual v1.5.4

🥑

Revisar la topología de maquinas

Guacamole dispone de un servidor proxy para redirigir desde servidor a otras maquinas

Funcionamiento Guacamole

Instalación nativa

instalar Apache Guacamole en un servidor Ubuntu:

Paso 1: Actualización del sistema

sudo apt update
sudo apt upgrade

Paso 2: Instalación de dependencias

sudo apt install libcairo2 libjpeg-turbo8 libjpeg8 libpng16-16 \
libossp-uuid16 libavcodec58 libavutil56 libswscale5 libpango-1.0-0 \
libssh2-1 freerdp2-2 libtelnet2 libvncserver1 \
tomcat9 tomcat9-admin tomcat9-common tomcat9-user \
tomcat9-examples tomcat9-docs

Paso 3: Descarga de Apache Guacamole

wget https://apache.osuosl.org/guacamole/1.4.0/source/guacamole-server-1.4.0.tar.gz
wget https://apache.osuosl.org/guacamole/1.4.0/binary/guacamole-1.4.0.war
wget https://downloads.apache.org/guacamole/1.4.0/source/guacamole-client-1.4.0.tar.gz

Paso 4: Extracción de archivos

tar -xzf guacamole-server-1.4.0.tar.gz
tar -xzf guacamole-client-1.4.0.tar.gz

Paso 5: Compilación e instalación de guacamole-server

cd guacamole-server-1.4.0
./configure --with-init-dir=/etc/init.d
make
sudo make install
sudo ldconfig
sudo systemctl enable guacd

Paso 6: Instalación de Guacamole Cliente

cd ../guacamole-client-1.4.0
sudo mv guacamole-1.4.0.war /var/lib/tomcat9/webapps/guacamole.war
sudo systemctl restart tomcat9

Paso 7: Configuración de Guacamole

sudo nano /etc/guacamole/guacamole.properties

Agrega las siguientes líneas:

guacd-hostname: localhost
guacd-port: 4822

Paso 8: Configuración de Tomcat

sudo nano /etc/tomcat9/server.xml

Busca <Context> y agrega lo siguiente adentro:

<Parameter name="guacamole-config" value="/etc/guacamole/guacamole.properties"/>

Paso 9: Reinicio de Tomcat y guacd

sudo systemctl restart tomcat9
sudo systemctl restart guacd

Paso 10: Acceso a Guacamole Abre un navegador web y visita http://dirección_IP_del_servidor:8080/guacamole.

Esto te llevará a la interfaz web de Apache Guacamole. Inicia sesión con las credenciales predeterminadas (usuario: guacadmin, contraseña: guacadmin). Desde aquí, puedes agregar conexiones remotas y acceder a ellas desde cualquier navegador web.

Instalación con docker

Para la instalación en docker, hay que usar tres imágenes: guacamole/guacd, guacamole/guacamole y mysql o postgresql. Para facilitar el despliegue, he decidido usar docker y buscar un script para docker compose que junte las tres imágenes.

info: https://github.com/boschkundendienst/guacamole-docker-compose

Clona el repositorio antes mencionado con GIT y ejecuta el docker-compose con guacamole:

git clone "https://github.com/boschkundendienst/guacamole-docker-compose.git"
cd guacamole-docker-compose
./prepare.sh
docker-compose up -d

El servidor de guacamole deberia estar disponible em https://IP-DEL_SERVIDOR:8443/. El usuario por defecto es guacadmin con la contraseña guacadmin.

El script te habrá creado varios adaptadores, para revisarlos recuerda usar ip a show enp0s3

Ejecución de la conexión

Al acceder por primera vez te encontrarás con esto:

Agrega una conexión en Guacamole: Inicia sesión en la interfaz web de Guacamole. Una vez dentro, sigue estos pasos:

• Haz clic en el botón "Crear conexión" o "Crear nuevo cliente".

• Selecciona el protocolo que deseas utilizar para conectarte a tu máquina (por ejemplo, SSH, RDP, VNC).

• Completa los parámetros necesarios:

Parámetro	Configuración
Nombre
Ubicación
Protocolo
Nº máximo conexiones
Nº máximo por usuario
Peso conx.
failover
proxy - nombre host
proxy - puerto
proxy - cifrado
red - nombre host
red - puerto
user
pwd

• Guarda la conexión.

Prueba la conexión: Después de guardar la conexión, deberías verla en la lista de conexiones disponibles en la interfaz de Guacamole. Haz clic en ella para iniciar la conexión y probarla.