远程桌面网关 guacamole 配置指南

Posted 2022-11-09

1.简介

Apache Guacamole是一个使用Web(H5)做为前端的远程桌面网关，支持对使用VNC、RDP、Telnet和SSH协议服务器的远程访问。一些开源的堡垒机（安全审计工具）也是集成该组件工具实现安全远程审计和统一接入功能。

官网地址：​​​​http://guacamole.apache.org/​​

Web浏览器

用户通过浏览器连接和管理后端的服务器，既可以是 Linux 服务器，也可以是 Windows 服务器。因为是 H5 页面，实际上，甚至可以在移动设备，如手机上进行访问。

guacamole

guacamole 是用户与 guacd 交互的中转站，主要功能是权限管理、配置管理和协议转换，实际上是一个 Web 服务器，通常是 Tomcat，用户登录到 guacamole 上之后，鉴权通过后，会请求后端的 guacd

guacd

guacd 实现与后端真实服务器的通信，支持 VNC、RDP、Telnet 和 SSH 协议

安装环境基于 CentOS 7

2.组件配置

2.1.配置操作系统组件

增加必要的系统组件，已经安装了 mysql  数据库环境的无需再次安装

yum -y localinstall --nogpgcheck https://download1.rpmfusion.org/free/el/rpmfusion-free-release-7.noarch.rpm https://download1.rpmfusion.org/nonfree/el/rpmfusion-nonfree-release-7.noarch.rpm yum install -y cairo-devel libjpeg-turbo-devel libwebsockets-devel libpng-devel uuid-devel ffmpeg-devel freerdp-devel pango-devel libssh2-devel libvncserver-devel pulseaudio-libs-devel openssl-devel libvorbis-devel libwebp-devel libtool libtelnet-devel freerdp mariadb-server wget tomcat

2.2.下载安装包

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

2.3.编译安装

./configure --perfix=/usr/local/guacamole-server --with-systemd-dir=/etc/systemd/system/ make make install

2.4.启用相关服务

systemctl enable tomcat && systemctl enable mariadb && systemctl enable guacd cp ~/guacamole-1.1.0.war /var/lib/tomcat/webapps/guacamole.war firewall-cmd --permanent --add-port=8080/tcp firewall-cmd --reload

2.5.配置数据库组件

mkdir -p /usr/share/tomcat/.guacamole/extensions,lib wget https://cdn.mysql.com//Downloads/Connector-J/mysql-connector-java-8.0.26.tar.gz tar -xzf mysql-connector-java-8.0.26.tar.gz cp mysql-connector-java-8.0.26/mysql-connector-java-8.0.26.jar /usr/share/tomcat/.guacamole/lib/ wget https://downloads.apache.org/guacamole/1.3.0/binary/guacamole-auth-jdbc-1.3.0.tar.gz tar -xzf guacamole-auth-jdbc-1.3.0.tar.gz cp guacamole-auth-jdbc-1.3.0/mysql/guacamole-auth-jdbc-mysql-1.3.0.jar /usr/share/tomcat/.guacamole/extensions/ systemctl start mariadb && systemctl start tomcat

2.6.数据库配置

mysql -u root -p CREATE DATABASE IF NOT EXISTS guacdb DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci; create user guacuser@localhost identified with mysql_native_password by xxxxxxxxxxx; grant all privileges on guacdb.* to guacuser@localhost; flush privileges; quit wget https://downloads.apache.org/guacamole/1.3.0/source/guacamole-client-1.3.0.tar.gz tar -xzf guacamole-client-1.3.0.tar.gz cat guacamole-client-1.3.0/extensions/guacamole-auth-jdbc/modules/guacamole-auth-jdbc-mysql/schema/*.sql | mysql -u root -p guacdb

3.配置 guacamole 

3.1.创建必须的文件

mkdir -p /etc/guacamole/ && vi /etc/guacamole/guacamole.properties

----------------------------------Inset Into VI--------------------------------------- hostname: 192.168.111.243 guacd-port: 4822 enable-clipboard-integration:true # MySQL properties mysql-hostname: localhost mysql-port: 3306 mysql-database: guacdb mysql-username: guacuser mysql-password: guacpass #Additional settings mysql-default-max-connections-per-user: 0 mysql-default-max-group-connections-per-user: 0 # TOTP settings totp-issuer: Remote Desktop totp-digits: 6 #----------------------------------End Inset Into VI---------------

3.2.配置对应的权限

chmod 0400 /etc/guacamole/guacamole.properties chown tomcat:tomcat /etc/guacamole/guacamole.properties ln -s /etc/guacamole/guacamole.properties /usr/share/tomcat/.guacamole/ chown tomcat:tomcat /var/lib/tomcat/webapps/guacamole.war

3.3.增加 totp 2次验证

wget https://apache.org/dyn/closer.lua/guacamole/1.3.0/binary/guacamole-auth-totp-1.3.0.tar.gz cp guacamole-auth-totp-1.3.0/guacamole-auth-totp-1.3.0.jar /usr/share/tomcat/.guacamole/extensions/ systemctl restart tomcat

3.4.配置域名访问

​​通过 apisix 网关的方式实现基于域名的 http 访问​​。技术上主要的难点在于 URI 的改写。

1、通过 IP 地址的登录访问为： ​​http://192.168.111.243:8080/guacamole​​ ，如果只输入 IP 地址加端口会提示 404 错误。

2、在 apisix 的 GUI 配置管理界面中需要将默认的域名访问自动增加 /guacamole 的前缀

4. 远程桌面配置

4.1. 组件和授权

确保已完成远程桌面的配置（本例中的 IP 地址是 192.168.112.250）并且已完成授权的激活。具体情况如下图所示：

4.2. 添加用户

在操作系统中添加远程桌面的登录用户，确保该用户隶属于“users”和“remote desktops”组。如下图所示：

4.3. 添加应用

要测试应用的执行结果，有些应用存在只能运行单个进程的情况（多个登录用户只能执行一个应用程序）。这里选用的远程工具是 RustDesk。安装后的结果如下图所示：

5. WEB 远程配置

5.1. 管理员登录

输入 ​​http://remote.test.lan​​ 进入 WEB 网关的登录界面，在登录界面输入 guacadmin 的用户名和密码进入管理员的配置界面，登录后的情况如下图所示：