Tutoriales

Cómo instalar Apache Guacamole en Ubuntu

En este post veremos cómo instalar y configurar la herramienta Apache Guacamole Remote Desktop Connection (RDP) en Ubuntu 20.04 | 18.04.

Para aquellos que no lo saben, Apache Guacamole es una puerta de enlace de escritorio remoto sin cliente de código abierto y gratuita. Admite protocolos estándar como VNC, RDP y SSH.

Debido a que usa HTML5, todo lo que necesita hacer es conectarse al servidor a través de un navegador web y comenzar a acceder a máquinas remotas.

Sin software que instalar, nada que configurar. Simplemente navegue y conéctese a cualquier host remoto definido en el portal.

Para comenzar a instalar Apache Guacamole en Ubuntu, sigue los pasos a continuación:

Instalar dependencias

Antes de instalar Guacamole, deberá instalar las dependencias necesarias para poder compilarlo desde la fuente.

Ejecute los siguientes comandos para actualizar Ubuntu e instalar estos paquetes.

sudo apt update
sudo apt install make gcc g++ 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 libvncserver-dev libtelnet-dev libssl-dev libvorbis-dev libwebp-dev

Después de instalar los paquetes anteriores, continúe a continuación.

Instalar el servidor Tomcat

Apache Guacamole usa Tomcat para conectar clientes a hosts remotos a través de su portal web.

Como necesitará Tomcat, ejecute los siguientes comandos para instalar rápidamente la versión 9 en Ubuntu.

sudo apt install tomcat9 tomcat9-admin tomcat9-common tomcat9-user

Después de instalar Tomcat arriba, los comandos a continuación se pueden usar para iniciarlo y habilitarlo para que se inicie automáticamente cuando inicie la máquina.

sudo systemctl start tomcat9
sudo systemctl enable tomcat9

Para verificar que Tomcat esté instalado y en ejecución, ejecute los siguientes comandos:

sudo systemctl status tomcat9

Eso mostrará líneas similares a las siguientes:

● tomcat9.service: servidor de aplicaciones web Apache Tomcat 9 cargado: cargado (/lib/systemd/system/tomcat9.service; habilitado; proveedor prese> Activo: activo (corriendo) desde el viernes 26 de febrero de 2021 a las 16:12:16 CST;  55s ago Docs: https://tomcat.apache.org/tomcat-9.0-doc/index.html Main PID: 8809 (java) Tareas: 29 (límite: 4654) Memoria: 81.0M CGroup: /system.slice/tomcat9 .servicio └─8809 / usr / lib / jvm / default-java / bin / java -Djava.util.logging.conf> 26 de febrero 16:12:27 ubuntu2004 tomcat9[8809]: Despliegue del descriptor de despliegue [>

Install Guacamole

Ubuntu doesn’t have Guacamole packages it its repositories. If you want to install Guacamole in Ubuntu, you’ll need to compile the source and build it yourself.

The steps below will show you how to do that.

To start compiling Guacamole, run the commands below to download version 1.3.0.

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

Once the downloaded run the commands below to extract the download package.

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

After extracting the file, change into the extracted folder and run the commands below to check that all requirements are met.

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

When you run the above, you’ll see confirmations that packages and requirements are met. When everything checked out, run the commands below to begin the installation.

sudo make
sudo make install
sudo ldconfig

After installing, the commands below can be used to start and enable Guacamole service to always startup when the system is booted.

sudo systemctl enable guacd
sudo systemctl start guacd

To verify that Guacamole is installed and functioning, run the commands below:

sudo systemctl status guacd

That should display something similar to the lines below:

● guacd.service - LSB: Guacamole proxy daemon
     Loaded: loaded (/etc/init.d/guacd; generated)
     Active: active (running) since Fri 2021-02-26 16:22:10 CST; 8s ago
       Docs: man:systemd-sysv-generator(8)
    Process: 20381 ExecStart=/etc/init.d/guacd start (code=exited, status=0/SUC>
      Tasks: 1 (limit: 4654)
     Memory: 10.0M
     CGroup: /system.slice/guacd.service
             └─20384 /usr/local/sbin/guacd -p /var/run/guacd.pid

Feb 26 16:22:10 ubuntu2004 systemd[1]: Iniciando LSB: Demonio de proxy Guacamole ...

Instalar Guacamole Client

Después de instalar el servidor anterior, continúe a continuación para instalar su cliente. El cliente está basado en Java y utiliza HTML5 para realizar conexiones a máquinas remotas.

Ejecute los siguientes comandos para descargar el cliente Java.

wget https://mirrors.estointernet.in/apache/guacamole/1.3.0/binary/guacamole-1.3.0.war

Después de descargar el archivo, cópielo en el / etc / guacamole directorio usando el siguiente comando:

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

Después de eso, ejecute los siguientes comandos para crear un enlace simbólico del cliente guacamole al directorio de aplicaciones web de Tomcat.

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

Cuando haya terminado, reinicie los servicios Tomcat8 y Guacamole.

sudo systemctl restart tomcat9
sudo systemctl restart guacd

Después de reiniciar, continúe a continuación.

Configurar Guacamole

En este punto, querrá configurar el archivo de configuración de Guacamole. Ejecute los siguientes comandos para crear un archivo de propiedades de configuración.

sudo nano /etc/guacamole/guacamole.properties

Agregue estas líneas en el archivo save the save.

guacd-hostname: localhost
guacd-port: 4822
user-mapping: /etc/guacamole/user-mapping.xml

Guarde la salida cuando termine.

A continuación, ejecute los siguientes comandos para crear dos directorios para bibliotecas y extensiones.

sudo mkdir /etc/guacamole/{extensions,lib}

También querrá establecer la variable de entorno del directorio de inicio de guacamole en / etc / default / tomcat9 archivo de configuración.

sudo sh -c "echo 'GUACAMOLE_HOME=/etc/guacamole' >> /etc/default/tomcat9"

Después de eso, crea un user-mapping.xml expediente. Este archivo contendrá la configuración para acceder al portal web.

Necesitará un hash de contraseña para la configuración de asignación de usuarios. Para generar una contraseña, use los siguientes comandos.

echo -n type_your_password_here | openssl md5

Reemplazar type_your_password_here con su contraseña real. Eso debería sacar un hash de contraseña. Copie el valor hash para usar en la configuración a continuación.

(estándar) = 36160e235d67eb4d4e234r449a4798ee37a8d

A continuación, ejecute los siguientes comandos para crear un nuevo user-mapping.xml

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

Luego copie y pegue el contenido a continuación en el archivo y guárdelo.

<user-mapping>
    <authorize 
            username="admin"
            password="36160e235d67eb4d4e234r449a4798ee37a8d"
            encoding="md5">

        <connection name="Ubuntu20.04-Server">
            <protocol>ssh</protocol>
            <param name="hostname">192.168.1.2</param>
            <param name="port">22</param>
            <param name="username">root</param>
        </connection>
        <connection name="Windows Server">
            <protocol>rdp</protocol>
            <param name="hostname">192.168.2.3</param>
            <param name="port">3389</param>
        </connection>
    </authorize>
</user-mapping>

Guardar y Salir.

A continuación, reinicie el servicio Tomcat y Guacamole para aplicar los cambios.

sudo systemctl restart tomcat9
sudo systemctl restart guacd

Deberias hacer eso.

Abra su navegador y busque el nombre de host del servidor o la dirección IP como se muestra a continuación:

 http://localhost:8080/guacamole

Luego debería ver el portal de Guacamole para iniciar sesión.

Ingrese el nombre de usuario y la contraseña que definió en el archivo de asignación de usuarios anterior.

¡Eso es!

Conclusión:

En este tutorial hemos visto cómo instalar Apache guacamole en Ubuntu 20.04 | 18.04. Si encuentra algún error arriba, utilice el formulario a continuación para informar.

También te puede gustar la publicación a continuación:

Leave a Comment

You may also like