网站搜索

在 Ubuntu 22.04 (Jammy Jellyfish) 上安装 Guacamole 远程桌面 |


本指南涵盖了在 Ubuntu 22.04 (Jammy Jellyfish) 上安装鳄梨酱远程桌面所需的所有步骤。

如果您从未收到过备忘录,Ubuntu 22.04 LTS 已作为新的长期版本发布。它会带来改进,今天我们将利用房子里的这把新扫帚来清理我们的通道操作。众所周知,大多数管理员每天都会考虑在一个地方访问服务器,这种便利是他们每天的主菜之一。为了满足这一需求,本指南详细介绍了建立这样一个平台的细节。在本指南结束时,我们应该已经在新的 Ubuntu 版本上设置了一个可用的 Apache Guacamole 服务器,可以利用该服务器提供一个位置来访问所有服务器。无论是 Windows 还是 Linux,Apache Guacamole 都能为您服务。

在深入了解这个工具的核心之前,如果我们知道它的全部内容不是很好吗?好吧,让我们继续揭开这个工具的神秘面纱。 Apache Guacamole 是一种无客户端远程桌面网关,支持 VNC、RDP 和 SSH 等标准协议。借助 HTML5,一旦在服务器上安装了 Guacamole,您只需使用 Web 浏览器即可访问桌面。

Guacamole 分为两部分:guacamole-server,它提供 guacd 代理和相关库;以及 guacamole-client,它提供由 servlet 容器提供服务的客户端。在大多数情况下,您需要构建的唯一源是鳄梨酱服务器,从项目网站下载最新的 guacamole.war 将足以提供客户端。

步骤一:服务器准备

Apache Guacamole 有许多依赖项,我们将在这一步中处理其中的大部分。让我们继续安装我们的鳄梨酱服务器呼吸和生存所需的每一个依赖项。按如下方式将它们全部安装:

sudo apt update
sudo apt install -y gcc nano vim curl wget g++ libcairo2-dev libjpeg-turbo8-dev libpng-dev libtool-bin libossp-uuid-dev

安装其他依赖项:

sudo apt install -y libavcodec-dev  libavformat-dev libavutil-dev libswscale-dev build-essential libpango1.0-dev libssh2-1-dev libvncserver-dev libtelnet-dev libpulse-dev libvorbis-dev libwebp-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 default-jdk

安装完成后可以查看安装的版本

$ java --version
openjdk 11.0.20 2023-07-18
OpenJDK Runtime Environment (build 11.0.20+8-post-Ubuntu-1ubuntu122.04)
OpenJDK 64-Bit Server VM (build 11.0.20+8-post-Ubuntu-1ubuntu122.04, mixed mode, sharing)

安装 Apache Tomcat

Apache Tomcat 存在于默认的 Ubuntu 22.04 存储库中,可以使用以下命令进行安装:

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

安装后,确保服务已启动并启用:

sudo systemctl enable --now tomcat9

Tomcat 应该会像下面这样愉快地运行:

$ 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 16:54:54 EAT; 3s ago
       Docs: https://tomcat.apache.org/tomcat-9.0-doc/index.html
    Process: 150975 ExecStartPre=/usr/libexec/tomcat9/tomcat-update-policy.sh (code=exited, status=0/SUCCESS)
   Main PID: 150979 (java)
      Tasks: 14 (limit: 4617)
     Memory: 80.2M
        CPU: 3.779s
     CGroup: /system.slice/tomcat9.service
             └─150979 /usr/lib/jvm/default-java/bin/java -Djava.util.logging.config.file=/var/lib/tomcat9/conf/logging.properties -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogM>

Ago 16 16:54:55 computingforgeeks tomcat9[150979]: Initializing ProtocolHandler ["http-nio-8080"]
Ago 16 16:54:56 computingforgeeks tomcat9[150979]: Server initialization in [1246] milliseconds
....

Tomcat 默认侦听端口 8080,您可以猜到,我们需要通过允许防火墙上的端口来允许远程访问应用程序。这就像一行命令一样简单,如下所示:

sudo ufw allow 8080/tcp

第 3 步:从源代码构建鳄梨酱服务器

guacamole-server 包含 Guacamole 连接到远程桌面所需的所有本机服务器端组件。它提供了一个通用的 C 库 libguac(所有其他本机组件都依赖该库),以及每个支持的协议的单独库,以及一个代理守护进程 guacd(Guacamole 的核心)。

下载最新稳定版本的 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 --disable-guacenc --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.......... yes
     libavutil ........... yes
     libssh2 ............. yes
     libssl .............. yes
     libswscale .......... yes
     libtelnet ........... yes
     libVNCServer ........ yes
     libvorbis ........... yes
     libpulse ............ yes
     libwebsockets ....... no
     libwebp ............. yes
     wsock32 ............. no

   Protocol support:

      Kubernetes .... no
      RDP ........... yes
      SSH ........... yes
      Telnet ........ yes
      VNC ........... yes

   Services / tools:

      guacd ...... yes
      guacenc .... yes
      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 restart 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 16:58:37 EAT; 45s ago
       Docs: man:systemd-sysv-generator(8)
      Tasks: 1 (limit: 4564)
     Memory: 9.8M
     CGroup: /system.slice/guacd.service
             └─173294 /usr/local/sbin/guacd -p /var/run/guacd.pid

Hag 16 14:30:37 workstation systemd[1]: Starting LSB: Guacamole proxy daemon...
Hag 16 14:30:37 workstation guacd[173292]: Guacamole proxy daemon (guacd) version 1.5.3 started
Hag 16 14:30:37 workstation guacd[173291]: Starting guacd:
Hag 16 14:30:37 workstation guacd[173292]: guacd[173292]: INFO:        Guacamole proxy daemon (guacd) version 1.5.3 started
Hag 16 14:30:37 workstation guacd[173291]: SUCCESS
Hag 16 14:30:37 workstation systemd[1]: Started LSB: Guacamole proxy daemon.
Hag 16 14:30:37 workstation guacd[173294]: Listening on host 127.0.0.1, port 4822

第 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(鳄梨酱服务器的一部分),以便为他们提供有权访问的任何远程桌面。

在 Ubuntu 22.04 LTS 上安装鳄梨酱客户端

鳄梨酱客户端以二进制形式提供。要安装它,只需从鳄梨酱二进制文件下载页面中提取它,如下所示,将其复制到 /etc/guacamole/ 目录并同时重命名。

VER=1.5.3
wget https://archive.apache.org/dist/guacamole/$VER/binary/guacamole-$VER.war
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 的单个文件中读取所有用户和连接。但是,此方法只能用于测试目的。为了做好生产准备,我们需要设置数据库身份验证。

确保您的系统上已安装 MySQL 或 MariaDB。这可以通过遵循以下指南来实现:

  • 如何在 Ubuntu 上安装 MariaDB
  • 如何在 Ubuntu 上安装 MySQL

安装后,下载 MySQL Connector/J(Java 连接器)。导出页面的最新可用版本:

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/

您还需要 Guacamole 的 JDBC 身份验证插件。导出可用的最新版本:

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/

现在使用 root 用户和密码登录数据库服务器:

sudo mysql -u root -p

连接后,为鳄梨酱创建数据库和用户:

CREATE 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

切换到提取的 JDBC 插件路径:

cd guacamole-auth-jdbc-*/mysql/schema

导入 SQL 架构:

cat *.sql | sudo mysql -u root -p guacamole_db

提供 root 用户的密码以导入架构。接下来,修改Guacamole的属性

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 的 Web 界面,只需将浏览器指向 http://ip-or-domain-name:8080/guacamole,您就会看到如下所示的登录屏幕:

使用guacadmin作为用户名和guacadmin作为密码登录

连接后,出于安全目的,您可以创建新管理员并删除默认管理员。为此,请单击guacadmin用户下拉箭头,然后转到设置 ->用户->新用户。

确保已分配所有必需的权限,然后单击创建。创建用户后,注销并使用新的管理员用户登录。

然后,您可以导航至设置并删除旧管理员用户。

创建 SSH 连接

默认情况下,用户没有 SSH 连接。我们可以通过点击设置 ->连接->新建连接来创建新连接

您需要在参数->网络下提供连接名称、服务器的IP/主机名和端口、用户名和密码。

如果您在远程主机上配置了 SSH 密钥身份验证,请考虑将以下行添加到 SSH 配置以避免错误“ssh 握手失败”。 ”

$ sudo vim /etc/ssh/sshd_config
HostKeyAlgorithms +ssh-rsa
PubkeyAcceptedKeyTypes +ssh-rsa

重新启动服务:

sudo systemctl restart sshd

创建后,您可以通过导航到主页(用户名下拉菜单)来测试连接

只需单击您想要连接的连接,系统就会提示您输入用户名和密码,无论是通过 SSH 还是 RDP,具体取决于操作系统。

您还可以使用其他身份验证方法,如下所示:

  • 鳄梨酱与 Active Directory、OTP 和 Duo 2FA 集成

要配置 SSL,请查看我们的文章:

  • 使用 Let’s Encrypt SSL 为鳄梨酱配置 Nginx 代理

如果凭据正确,您应该被允许进入您的服务器

结束语

通过利用 Apache Guacamole 使用其炫酷的功能(安装后您将看到),让您的环境井井有条,并且即使对于环境中的新用户也易于使用。检查一下并利用它的灵活性和便利性。

  • 在 CentOS 8 上安装和使用 Guacamole 远程桌面
  • 在 Debian 上安装 Guacamole 远程桌面

相关文章: