在 Ubuntu 20.04 上安装和使用 Guacamole 远程桌面 |
大多数管理员可以在每天的主菜中考虑拥有一个位置来访问服务器的便利性。为了满足这一需求,本指南详细介绍了建立这样一个平台的细节。在本指南结束时,我们应该已经建立了一个可用的 Apache Guacamole 服务器,可以利用它来提供一个访问所有服务器的位置。无论是 Windows 还是 Linux,Apache Guacamole 都能为您服务。
在深入了解这个工具的核心之前,如果我们知道它的全部内容不是很好吗?好吧,让我们继续揭开这个工具的神秘面纱。 Apache Guacamole 是一种无客户端远程桌面网关,支持 VNC、RDP 和 SSH 等标准协议。得益于 HTML5,一旦 Guacamole 安装在服务器上,您只需使用 Web 浏览器即可访问桌面。
Guacamole 分为两部分:guacamole-server,它提供 guacd 代理和相关库;以及 guacamole-client,它提供由 servlet 容器提供服务的客户端。在大多数情况下,您需要构建的唯一源是 guacamole-server,从项目网站下载最新的 guacamole.war 就足以提供客户端。
对于 CentOS,请参阅:在 CentOS 8 上安装和使用 Guacamole 远程桌面
第1步:服务器准备
Apache Guacamole 有许多依赖项,我们将在这一步中处理其中的大部分。让我们继续安装鳄梨酱服务器呼吸和生存所需的所有依赖项。按如下方式将它们全部安装:
sudo apt update
sudo apt install -y gcc vim curl wget g++ libcairo2-dev libjpeg-turbo8-dev libpng-dev libtool-bin libossp-uuid-dev libavcodec-dev libavformat-dev libavutil-dev libswscale-dev build-essential libpango1.0-dev libssh2-1-dev libvncserver-dev libtelnet-dev libpulse-dev libssl-dev libvorbis-dev libwebp-dev libwebsockets-dev安装FreeRDP2
我们将安装 Remmina PPA 中托管的 FreeRDP2 版本,如下所示:
sudo add-apt-repository ppa:remmina-ppa-team/remmina-next-daily
sudo apt update
sudo apt install freerdp2-dev freerdp2-x11 -y一旦满足了先决条件,我们现在就有机会享用主菜,其中还涉及接下来的几个步骤。
第 2 步:安装 Apache Tomcat
在此步骤中,我们将安装 Apache Tomcat Java servlet 容器,该容器将运行 Guacamole Java war 文件,从而为 Guacamole java 客户端提供服务。由于它是Java语言,我们必须先安装Java。
sudo apt install openjdk-11-jdk安装完成后可以查看安装的版本
$ java --version
openjdk 11.0.17 2022-10-18
OpenJDK Runtime Environment (build 11.0.17+8-post-Ubuntu-1ubuntu220.04)
OpenJDK 64-Bit Server VM (build 11.0.17+8-post-Ubuntu-1ubuntu220.04, mixed mode, sharing)使用以下命令安装 Tomcat 和所有必需的软件包:
sudo apt install tomcat9 tomcat9-admin tomcat9-common tomcat9-user安装后,启动并启用该服务:
sudo systemctl enable --now tomcat9Tomcat 应该运行得很愉快
$ systemctl status tomcat9
tomcat9.service - Apache Tomcat 9 Web Application Server
Loaded: loaded (/lib/systemd/system/tomcat9.service; enabled; vendor preset: enabled)
Active: active (running) since Wed 2023-08-16 13:27:41 EDT; 2min 48s ago
Docs: https://tomcat.apache.org/tomcat-9.0-doc/index.html
Main PID: 18458 (java)
Tasks: 29 (limit: 4660)
Memory: 101.3M
CPU: 5.938s
CGroup: /system.slice/tomcat9.service
└─18458 /usr/lib/jvm/java-11-openjdk-amd64/bin/java -Djava.util.logging.config.file=/var/lib/tomcat9/conf/logging.properties -Djava.util.logging.manager=org.apache.juli.ClassLo>
~Tomcat 默认侦听端口 8080,您可以猜到,我们需要通过允许防火墙上的端口来允许远程访问应用程序。这就像一行命令一样简单,如下所示:
sudo ufw allow 8080/tcp第 3 步:从源代码构建鳄梨酱服务器
guacamole-server 包含 Guacamole 连接到远程桌面所需的所有本机服务器端组件。它提供了一个通用 C 库 libguac(所有其他本机组件都依赖该库),以及每个受支持协议的单独库,以及一个代理守护进程 guacd(其核心)鳄梨酱。
下载最新稳定版本的 guacamole-server
cd ~/
VER=1.5.3
wget https://archive.apache.org/dist/guacamole/$VER/source/guacamole-server-$VER.tar.gz
下载后解压源tarball
tar xzf ~/guacamole-server-*.tar.gz切换到鳄梨酱服务器源代码目录;
cd ~/guacamole-server-*/然后执行配置脚本以检查是否缺少任何必需的依赖项并使鳄梨酱服务器适应您的系统。
./configure --with-init-dir=/etc/init.d上面的命令将导致一长串输出。当它结束时,您应该看到以下输出,其中应该有以下选项:RDP、SSH、Telnet和 VNC 。
guacamole-server version 1.5.3
------------------------------------------------
Library status:
freerdp2 ............ yes
pango ............... yes
libavcodec .......... yes
libavformat.......... no
libavutil ........... yes
libssh2 ............. yes
libssl .............. yes
libswscale .......... yes
libtelnet ........... yes
libVNCServer ........ yes
libvorbis ........... yes
libpulse ............ no
libwebsockets ....... no
libwebp ............. yes
wsock32 ............. no
Protocol support:
Kubernetes .... no
RDP ........... yes
SSH ........... yes
Telnet ........ yes
VNC ........... yes
Services / tools:
guacd ...... yes
guacenc .... no
guaclog .... yes
FreeRDP plugins: /usr/lib/x86_64-linux-gnu/freerdp2
Init scripts: /etc/init.d
Systemd units: no
Type "make" to compile guacamole-server.之后,只需按照最后一条消息中的建议运行 make 命令即可
make给它一些时间,让它发挥作用。完成后,安装鳄梨酱服务器,如下所示
sudo make install要完成这一切,请运行ldconfig命令来创建必要的链接并缓存到鳄梨酱服务器目录中找到的最新共享库。
sudo ldconfig
sudo mkdir -p /etc/guacamole/{extensions,lib}创建 guacd.conf 配置文件:
$ sudo vim /etc/guacamole/guacd.conf
[daemon]
pid_file = /var/run/guacd.pid
#log_level = debug
[server]
#bind_host = localhost
bind_host = 127.0.0.1
bind_port = 4822
#[ssl]
#server_certificate = /etc/ssl/certs/guacd.crt
#server_key = /etc/ssl/private/guacd.key刷新 systemd 以查找安装在 /etc/init.d/ 目录中的 guacd(鳄梨酱代理守护进程)服务。
sudo systemctl daemon-reload重新加载后,启动并启用 guacd 服务。
sudo systemctl start guacd
sudo systemctl enable guacd
要让涡轮升力产生这种情绪,请检查其状态。
$ systemctl status guacd
● guacd.service - LSB: Guacamole proxy daemon
Loaded: loaded (/etc/init.d/guacd; generated)
Active: active (running) since Wed 2023-08-16 13:34:38 EDT; 5s ago
Docs: man:systemd-sysv-generator(8)
Tasks: 1 (limit: 4660)
Memory: 9.9M
CPU: 12ms
CGroup: /system.slice/guacd.service
└─32087 /usr/local/sbin/guacd -p /var/run/guacd.pid
...第 4 步:安装鳄梨酱 Web 应用程序
Guacamole 的部署涉及两个关键文件:guacamole.war(包含 Web 应用程序的文件)和 guacamole.properties(Guacamole 的主要配置文件) 。设置鳄梨酱的推荐方法是将这些文件放置在标准位置,然后创建指向它们的符号链接,以便 Tomcat 可以找到它们。
guacamole-client 包含 Guacamole 的所有 Java 和 Maven 组件(guacamole、guacamole-common、guacamole-ext 和 guacamole-common-js)。这些组件最终构成了 Web 应用程序,该应用程序将为连接到服务器的用户提供 HTML5 Guacamole 客户端。该 Web 应用程序将代表连接的用户连接到 guacd(鳄梨酱服务器的一部分),以便为他们提供有权访问的任何远程桌面。
鳄梨酱客户端以二进制形式提供。要安装它,只需从鳄梨酱二进制文件下载页面中提取它,如下所示,将其复制到 /etc/guacamole/ 目录并同时重命名。
VER=1.5.3
wget https://archive.apache.org/dist/guacamole/$VER/binary/guacamole-$VER.war
sudo mkdir /etc/guacamole要安装 Guacamole 客户端二进制文件,请将 Guacamole 客户端移动到 Tomcat webapps 目录,如下所示;
sudo mv guacamole-$VER.war /var/lib/tomcat9/webapps/guacamole.war第 5 步:配置鳄梨酱服务器
安装Guacamole服务器守护程序后,您需要在/etc/guacamole/guacamole.properties配置文件下定义Guacamole客户端如何连接到Guacamole服务器(guacd)。在此配置中,您只需定义鳄梨酱服务器主机名、端口、用户映射配置文件和身份验证提供程序。
GUACAMOLE_HOME 是 Guacamole 配置目录的名称,默认位于 /etc/guacamole。所有配置文件、扩展等都驻留在该目录中。
创建GUACAMOLE_HOME环境变量
echo "GUACAMOLE_HOME=/etc/guacamole" | sudo tee -a /etc/default/tomcat
echo "export GUACAMOLE_HOME=/etc/guacamole" | sudo tee -a /etc/profile创建 /etc/guacamole/guacamole.properties 配置文件并填充它,如下所示:
$ sudo vim /etc/guacamole/guacamole.properties
guacd-hostname: localhost
guacd-port: 4822配置如上所示后,保存并继续设置所需的身份验证,如下所示。
第 6 步:设置鳄梨酱数据库身份验证
Guacamole 的默认身份验证方法从名为 user-mapping.xml 的单个文件中读取所有用户和连接。在此文件中,您需要定义允许访问 Guacamole Web UI 的用户、要连接的服务器以及连接方法。但在那里,我们将使用推荐用于生产环境的数据库身份验证。
首先,确保已安装 MariaDB 或 MySQL:
- 如何在 Ubuntu 上安装 MariaDB
- 如何在 Ubuntu 上安装 MySQL
安装后,以 root 用户身份登录:
sudo mysql -u root -p创建鳄梨酱所需的数据库和用户:
REATE DATABASE guacamole_db;
CREATE USER 'guacamole_user'@'localhost' IDENTIFIED BY 'Passw0rd!';
GRANT SELECT,INSERT,UPDATE,DELETE ON guacamole_db.* TO 'guacamole_user'@'localhost';
FLUSH PRIVILEGES;
QUIT接下来,我们需要安装 MySQL Java Connector。首先,导出最新的可用版本:
VER=8.1.0现在拉取存档:
wget https://dev.mysql.com/get/Downloads/Connector-J/mysql-connector-j-$VER.tar.gz提取文件并将其复制到 /etc/guacamole/lib/ 目录:
tar -xf mysql-connector-j-*.tar.gz
sudo cp mysql-connector-j-$VER/mysql-connector-j-$VER.jar /etc/guacamole/lib/我们还需要下载 JDBC auth 插件。同样在这里导出最新的可用版本:
VER=1.5.3下载存档:
wget https://downloads.apache.org/guacamole/$VER/binary/guacamole-auth-jdbc-$VER.tar.gz提取文件并将其移动到 /etc/guacamole/extensions/ ,如下所示:
tar -xf guacamole-auth-jdbc-$VER.tar.gz
sudo mv guacamole-auth-jdbc-$VER/mysql/guacamole-auth-jdbc-mysql-$VER.jar /etc/guacamole/extensions/您现在需要导入数据库架构。为此,请切换到以下目录:
cd guacamole-auth-jdbc-*/mysql/schema通过运行以下命令导入架构:
cat *.sql | sudo mysql -u root -p guacamole_db请记住提供您的 MySQL root 密码才能继续。
现在调整您的鳄梨酱配置以适应您的数据库,如下所示:
sudo vim /etc/guacamole/guacamole.properties在文件中添加数据库详细信息:
##MySQL properties
mysql-hostname: 127.0.0.1
mysql-port: 3306
mysql-database: guacamole_db
mysql-username: guacamole_user
mysql-password: Passw0rd!保存文件并重新启动服务:
sudo systemctl restart tomcat9 guacd第 7 步:获取鳄梨酱 Web 界面
到目前为止,我们已经设置好了一切,因此我们应该准备好访问我们一直在努力启动的应用程序。要访问 Guacamole 的网络界面,只需将浏览器指向http://ip-or-domain-name:8080/guacamole,您就会看到一个登录屏幕,如下所示如下图所示:
在上面的页面上,使用默认凭据 guacadmin 作为用户名,使用 guacadmin 作为密码登录。通过身份验证后,您需要创建另一个管理员用户并删除旧的默认用户。
要添加新用户,请导航至设置 ->用户->新用户。
确保为新管理员用户启用所有权限。创建后,注销并使用新的管理员用户登录。然后您可以继续并删除旧的默认用户:
在鳄梨酱上建立联系
然后,您可以将所需的远程连接添加到鳄梨酱。这是通过导航到设置 ->连接->新连接来完成的
如上所示,在“参数”->“网络”下设置首选名称、协议以及主机名/IP 地址和端口。对于 SSH 协议,如果您之前在主机之间启用了 SSH 身份验证,则可能会收到错误“ssh 握手失败”。要解决该错误,您需要修改远程系统上的 SSH 配置,如下所示:
$ sudo vim /etc/ssh/sshd_config
HostKeyAlgorithms +ssh-rsa
PubkeyAcceptedKeyTypes +ssh-rsa重新启动服务:
sudo systemctl restart sshd添加的连接现在应该出现在您的鳄梨酱主页上,如下所示:
要启动连接,请单击它。如果一切正常,连接应该启动,如下所示:
您还可以使用其他身份验证方法,如下所示:
- 鳄梨酱与 Active Directory、OTP 和 Duo 2FA 集成
要配置 SSL,请查看我们的文章:
- 使用 Let's Encrypt SSL 为鳄梨酱配置 Nginx 代理
高潮
通过利用 Apache Guacamole 使用其炫酷的功能(安装后您将看到),让您的环境井井有条,并且即使对于环境中的新用户也易于使用。检查一下并利用它的灵活性和便利性,尤其是在这个季节,我们大多数人都会与我们关心的人留下回忆。
您可能感兴趣的其他指南包括:
- 在 CentOS 8 上安装和使用 Guacamole 远程桌面
- 在 Linux CLI 上创建 SSH 隧道的简单方法
- 在 Windows Server 2019 上安装和配置 OpenSSH 服务器
- 在 CentOS/RHEL 7/8 上为 SSH 设置两因素 (2FA) 身份验证





