Instalar e Usar o Guacamole Remote Desktop no CentOS 8

Apache Guacamole é um aplicativo de desktop remoto gratuito, de código aberto, baseado na web e sem cliente que suporta protocolos padrão como VNC, RDP e SSH. Ele permite que você acesse PCs Linux e Windows a partir de um navegador da web via RDP, SSH ou VNC. É sem cliente, então você não precisa instalar nenhum plugin ou software cliente. É composto por dois componentes: Guacamole Server e Guacamole Client. O servidor Guacamole fornece os componentes nativos e do lado do servidor necessários para se conectar ao PC remoto, enquanto o cliente Guacamole é um aplicativo web HTML 5 usado para se conectar ao PC remoto.

Neste tutorial, mostraremos como instalar o servidor Guacamole no CentOS 8.

Pré-requisitos

• Um servidor executando o CentOS 8.
• Uma senha de root configurada no servidor.

Começando

Primeiro, você precisará instalar alguns pacotes necessários em seu servidor. Você pode instalar todos eles com o seguinte comando:

dnf install -y unzip curl make cmake wget gcc zlib-devel compat-openssl10

Após instalar todos os pacotes necessários, você precisará habilitar o repositório EPEL, PowerTools e Devel em seu sistema. Você pode habilitá-los com o seguinte comando:

dnf install epel-release -y  
dnf config-manager --set-enabled PowerTools  
dnf config-manager --enable Devel

Em seguida, instale outras ferramentas necessárias com o seguinte comando:

dnf install cairo-devel libuv-devel libjpeg-turbo-devel libjpeg-devel libpng-devel libtool uuid-devel freerdp-devel pango-devel libvncserver-devel pulseaudio-libs-devel openssl-devel libvorbis-devel libwebp-devel libssh2-devel libtheora opus lame-libs

Em seguida, desative o repositório Devel com o seguinte comando:

dnf config-manager --disable Devel

Em seguida, você precisará compilar a biblioteca telnet em seu sistema.

Primeiro, faça o download com o seguinte comando:

curl -s https://api.github.com/repos/seanmiddleditch/libtelnet/releases/latest | grep browser_download_url | cut -d '"' -f 4 | wget -qi -

Uma vez baixado, extraia o arquivo baixado com o seguinte comando:

tar -xf libtelnet-*.tar.gz

Em seguida, mude o diretório para o diretório extraído e configure-o com o seguinte comando:

cd libtelnet-*/  
./configure

Em seguida, instale-o em seu sistema com o seguinte comando:

make   
make install

Uma vez instalado, você pode prosseguir para a próxima etapa.

Instalar Java

Guacamole é um software baseado em Java, então o Java deve ser instalado em seu servidor. Se não estiver instalado, você pode instalá-lo com o seguinte comando:

dnf install java-11-openjdk-devel

Uma vez instalado, verifique a versão do Java usando o seguinte comando:

java -version

Você deve obter a seguinte saída:

openjdk version "11.0.9.1" 2020-11-04
OpenJDK Runtime Environment (build 11.0.9.1+1-Ubuntu-0ubuntu1.20.04)
OpenJDK 64-Bit Server VM (build 11.0.9.1+1-Ubuntu-0ubuntu1.20.04, mixed mode, sharing)

Instalar Tomcat

Apache Tomcat é usado para servir o conteúdo do cliente Guacamole. Portanto, você precisará instalar o Tomcat em seu servidor.

Primeiro, crie um usuário e grupo separados para o Tomcat com o seguinte comando:

groupadd --system tomcat  
useradd -d /usr/share/tomcat -r -s /bin/false -g tomcat tomcat

Em seguida, faça o download da versão mais recente do Tomcat com o seguinte comando:

wget https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.43/bin/apache-tomcat-9.0.43.tar.gz

Uma vez que o download esteja completo, extraia o arquivo baixado com o seguinte comando:

tar -xvf apache-tomcat-9.0.43.tar.gz

Em seguida, mova o Tomcat para o diretório /usr/share

mv apache-tomcat-9.0.43 /usr/share/tomcat

Em seguida, defina a propriedade adequada para o diretório do Tomcat:

chown -R tomcat:tomcat /usr/share/tomcat/

Uma vez que você tenha terminado, pode prosseguir para a próxima etapa.

Criar um Arquivo de Serviço Systemd para Tomcat

Em seguida, você precisará criar um arquivo de serviço systemd para o Tomcat. Você pode criá-lo com o seguinte comando:

nano /etc/systemd/system/tomcat.service

Adicione as seguintes linhas:

[Unit]
Description=Tomcat Server
After=syslog.target network.target

[Service]
Type=forking
User=tomcat
Group=tomcat

Environment=JAVA_HOME=/usr/lib/jvm/jre
Environment='JAVA_OPTS=-Djava.awt.headless=true'
Environment=CATALINA_HOME=/usr/share/tomcat
Environment=CATALINA_BASE=/usr/share/tomcat
Environment=CATALINA_PID=/usr/share/tomcat/temp/tomcat.pid
Environment='CATALINA_OPTS=-Xms512M -Xmx1024M'
ExecStart=/usr/share/tomcat/bin/catalina.sh start
ExecStop=/usr/share/tomcat/bin/catalina.sh stop

[Install]
WantedBy=multi-user.target

Salve e feche o arquivo, então recarregue o daemon systemd com o seguinte comando:

systemctl daemon-reload

Em seguida, inicie o serviço Tomcat e habilite-o para iniciar na reinicialização do sistema:

systemctl start tomcat  
systemctl enable tomcat

Você também pode verificar o status do Tomcat com o seguinte comando:

systemctl status tomcat

Você deve obter a seguinte saída:

? tomcat.service - Tomcat Server
   Loaded: loaded (/etc/systemd/system/tomcat.service; disabled; vendor preset: disabled)
   Active: active (running) since Tue 2021-02-16 09:34:45 EST; 6s ago
  Process: 26546 ExecStart=/usr/share/tomcat/bin/catalina.sh start (code=exited, status=0/SUCCESS)
 Main PID: 26551 (java)
    Tasks: 35 (limit: 12523)
   Memory: 89.7M
   CGroup: /system.slice/tomcat.service
           ??26551 /usr/lib/jvm/jre/bin/java -Djava.util.logging.config.file=/usr/share/tomcat/conf/logging.properties -Djava.util.logging.man>

Feb 16 09:34:45 centos8 systemd[1]: Starting Tomcat Server...
Feb 16 09:34:45 centos8 systemd[1]: Started Tomcat Server.

Instalar Apache Guacamole

Primeiro, faça o download da versão mais recente do Guacamole com o seguinte comando:

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

Uma vez que o download esteja completo, extraia o arquivo baixado com o seguinte comando:

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

Em seguida, mude o diretório para o diretório extraído e configure-o com o seguinte comando:

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

Em seguida, instale-o em seu sistema com o seguinte comando:

make  
make install  
ldconfig

Em seguida, recarregue o daemon systemd com o seguinte comando:

systemctl daemon-reload

Em seguida, inicie o serviço Guacamole e habilite-o para iniciar na reinicialização do sistema:

systemctl start guacd  
systemctl enable guacd

Você pode verificar o status do Guacamole com o seguinte comando:

systemctl status guacd

Você deve obter a seguinte saída:

? guacd.service - LSB: Guacamole proxy daemon
   Loaded: loaded (/etc/rc.d/init.d/guacd; generated)
   Active: active (running) since Tue 2021-02-16 09:37:15 EST; 4s ago
     Docs: man:systemd-sysv-generator(8)
  Process: 35723 ExecStart=/etc/rc.d/init.d/guacd start (code=exited, status=0/SUCCESS)
    Tasks: 1 (limit: 12523)
   Memory: 12.1M
   CGroup: /system.slice/guacd.service
           ??35726 /usr/local/sbin/guacd -p /var/run/guacd.pid

Feb 16 09:37:15 centos8 systemd[1]: Starting LSB: Guacamole proxy daemon...
Feb 16 09:37:15 centos8 guacd[35723]: Starting guacd: guacd[35724]: INFO:        Guacamole proxy daemon (guacd) version 1.3.0 started
Feb 16 09:37:15 centos8 guacd[35723]: SUCCESS
Feb 16 09:37:15 centos8 guacd[35726]: Listening on host 127.0.0.1, port 4822
Feb 16 09:37:15 centos8 systemd[1]: Started LSB: Guacamole proxy daemon.

Instalar Cliente Guacamole

Em seguida, crie um diretório para o Guacamole e faça o download do arquivo do cliente Guacamole com o seguinte comando:

mkdir /etc/guacamole  
wget https://downloads.apache.org/guacamole/1.3.0/binary/guacamole-1.3.0.war

Uma vez baixado, mova o arquivo baixado para o diretório /etc/guacamole:

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

Em seguida, crie um link simbólico do arquivo guacamole.war para o diretório /usr/share/tomcat:

ln -s /etc/guacamole/guacamole.war /usr/share/tomcat/webapps/

Em seguida, defina o diretório home do Guacamole com o seguinte comando:

echo "GUACAMOLE_HOME=/etc/guacamole" | tee -a /etc/default/tomcat

Em seguida, crie um arquivo de configuração do Guacamole com o seguinte comando:

nano /etc/guacamole/guacamole.properties

Adicione as seguintes linhas:

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

Salve e feche o arquivo, então crie um link simbólico do diretório /etc/guacamole:

ln -s /etc/guacamole /usr/share/tomcat/.guacamole

Configurar Guacamole

Em seguida, você precisará criar um arquivo de mapeamento de usuário do Guacamole para definir o servidor remoto ao qual deseja se conectar a partir do Guacamole.

Primeiro, gere uma senha secreta com o seguinte comando:

echo -n sua-senha | openssl md5

Você deve ver a seguinte saída:

(stdin)= 0f6e4a1df0cf5ee97c2066953bed21b2

Em seguida, crie um arquivo user-mapping.xml com o seguinte comando:

nano /etc/guacamole/user-mapping.xml

Adicione os detalhes do seu servidor Windows e Linux remoto conforme mostrado abaixo:

        
            ssh
            69.87.218.51
            22

        

        
            rdp
            15.185.162.149
            3389
            administrator

        

    

Salve e feche o arquivo, então reinicie os serviços Guacamole e Tomcat para aplicar as alterações:

systemctl restart tomcat guacd

Uma vez que você tenha terminado, pode prosseguir para a próxima etapa.

Configurar Firewall

Em seguida, você precisará permitir a porta 4822 e 8080 através de um firewall. Você pode permitir com o seguinte comando:

firebase-cmd --permanent --add-port=4822/tcp  
firebase-cmd --permanent --add-port=8080/tcp

Em seguida, recarregue o firewalld para aplicar as alterações:

firebase-cmd --reload

Acessar a Interface Web do Guacamole

Agora, abra seu navegador da web e acesse a interface web do Guacamole usando a URL http://seu-ip-do-servidor:8080/guacamole. Você deve ver a seguinte tela:

Forneça seu nome de usuário admin, senha e clique no botão Login. Você deve ver o painel do Guacamole na seguinte tela:

Na tela acima, você pode ver tanto servidores Windows quanto Linux. Você pode clicar para se conectar e gerenciar os servidores remotos.

Conclusão

Parabéns! você instalou e configurou com sucesso o servidor Guacamole no CentOS 8. Agora você pode adicionar mais servidores remotos ao seu servidor Guacamole e gerenciá-los através de um navegador da web.