网站搜索

在 Debian 11/Debian 10 上安装 Guacamole 远程桌面 |


在日常生活中,大多数系统管理员认为访问服务器是其职业的一个组成部分。本文深入演示如何建立这样一个平台。在本指南结束时,您应该具备如何在 Debian 11 (Bullseye)/Debian 10 (Buster) 上安装和使用 Guacamole 远程桌面的知识。

在我们深入了解这个工具的核心之前,我们有必要阐明并了解这个工具的全部内容。 Guacamole 是一个 HTML Web 应用程序,提供对服务器的远程访问。它支持 RDP、SSH 和 VNC 等协议。鳄梨酱非常有用,因为它可以从您的设备(计算机、手机或平板电脑)远程访问一个或多个桌面。鳄梨酱远程桌面的一些优点是:

  • 允许从任何设备访问计算机。
  • 提供对组的轻松访问。
  • 使人们能够向现有基础设施添加 HTML5 远程访问。

鳄梨酱由两部分组成:

  1. Guacamole-server - 这提供了代理(guacd)和所需的库。
  2. Guacamole-client - 这是由 servlet 容器提供服务的客户端。

第 1 步:安装依赖项

让我们首先更新我们的系统并安装鳄梨酱远程桌面所需的依赖项。

sudo apt update
sudo apt install -y vim build-essential libcairo2-dev libjpeg62-turbo-dev libpng-dev \
libtool-bin libossp-uuid-dev libavcodec-dev libavformat-dev libavutil-dev libswscale-dev \
libpango1.0-dev libssh2-1-dev libvncserver-dev libtelnet-dev \
libssl-dev libvorbis-dev libwebp-dev libpulse-dev

我们需要安装的另一个工具是 FreeRDP2,它托管在 Remmina PPA 中

echo "deb http://deb.debian.org/debian $(lsb_release -cs)-backports main" | sudo tee /etc/apt/sources.list.d/backports.list
sudo apt update
sudo apt install freerdp2-x11 freerdp2-dev

步骤 2:在 Debian 上安装 Apache Tomcat

由于我们使用 Apache Tomcat 来运行 Guacamole Java war 文件,因此我们需要在 Debian 系统上安装 Java。

sudo apt install openjdk-11-jdk

检查安装的版本

$ java --version
openjdk 11.0.16 2022-07-19
OpenJDK Runtime Environment (build 11.0.16+8-post-Debian-1deb11u1)
OpenJDK 64-Bit Server VM (build 11.0.16+8-post-Debian-1deb11u1, mixed mode, sharing)

在 Debian 上安装 Apache Tomcat

要在 Debian 11/Debian 10 上安装 Tomcat,请发出以下命令:

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 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 apt install ufw 安装 ufw

sudo ufw allow 8080/tcp

第 3 步:下载鳄梨酱远程服务器

鳄梨酱远程服务器包含远程桌面连接所需的所有本机和服务器组件。它提供了所有本机组件所依赖的所有库以及作为 Guacamole 中心的 guacd。

从发布页面检查 Guacamole Server 的最新稳定可用版本。

或者,使用 Wget 下载,如下所示。设置版本变量

VER=1.5.3

然后下载它:

wget https://archive.apache.org/dist/guacamole/$VER/source/guacamole-server-$VER.tar.gz

提取下载的文件。

tar xzf guacamole-server-$VER.tar.gz

导航到鳄梨酱目录。

cd guacamole-server-$VER

然后发出配置脚本,该脚本检查可用的依赖项并使鳄梨酱服务器适应它们。

./configure --with-init-dir=/etc/init.d

上述命令的示例输出:

...
------------------------------------------------
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.

步骤 4:在 Debian 上安装 Guacamole 远程桌面

完成上述检查后,现在是时候将 Guacamole 安装到我们的 Debian 系统中了。我们需要通过发出如下 make 命令来编译 Guacamole-server。

make

make 命令需要一些时间,完成后,现在继续安装 Guacamole-server。

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

然后重新加载守护进程以查找添加的 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

下载相同版本的鳄梨酱客户端二进制文件。设置版本变量:

VER=1.5.3

拉取存档:

wget https://archive.apache.org/dist/guacamole/$VER/binary/guacamole-$VER.war

将文件复制到 Tomcat Web 应用程序目录:

sudo mv guacamole-$VER.war /var/lib/tomcat9/webapps/guacamole.war

步骤 5:在 Debian 上配置 Apache Guacamole

鳄梨酱有两个主要的配置文件,即

  • 存储在 GACAMOLE_HOME 环境变量引用的 /etc/guacamole 中
  • 存储在 /etc/guacamole/guacamole.properties 这是鳄梨酱及其扩展使用的主文件。

创建 GUACAMOLE_HOME 环境变量。

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

然后通过在 /etc/guacamole 下创建 guacamole.properties 文件来定义 Guacamole 如何与 guacd 进行通信,如下所示。

sudo vim /etc/guacamole/guacamole.properties

编辑您的文件如下:

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

第6步:设置鳄梨酱数据库身份验证方法

默认情况下,Guacamole 的身份验证方法从名为 user-mapping.xml 的单个文件中读取所有用户和连接。在此文件中,定义了访问 Guacamole Web UI 的所有用户、要连接的服务器以及连接方法。但不推荐这种定义身份验证的方法。对于生产,您可以使用数据库、LDAP 或 DUO 身份验证。

在本指南中,我们将使用数据库身份验证。首先,在 Debian 系统上安装 MySQL 或 MariaDB。

  • 在 Debian 上安装 MariaDB
  • 在 Debian 上安装 MySQL

安装后,以 root 用户身份访问 shell:

sudo mysql -u root -p

使用以下 SQL 命令为 Guacamole 创建用户和数据库:

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

接下来,下载 MySQL 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/

另一个需要的东西是 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/

我们现在需要导入 Guacamole 的 SQL 架构。使用以下命令导航到 JDBC 路径:

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 界面

现在 Apache Guacamole 已设置完毕,我们现在可以使用以下 URL 从浏览器访问它:

http://server-IP:8080/guacamole

您应该能够看到下面的登录屏幕:

使用默认凭据 guacadmin 作为用户名,guacadmin 作为密码登录。连接后,建议删除默认管理员用户并创建一个新用户。

要创建新的管理员用户,请导航至设置 ->用户->新用户。

创建用户后,您可以使用新用户注销并登录。然后继续并删除旧的默认用户:

创建新的鳄梨酱连接

为了能够建立 SSH、VNC、RDP 连接,我们需要在 Guacamole 上定义它们。为此,请导航至设置 ->连接->新连接

创建连接时,请在参数->网络下提供协议以及服务器的 IP/主机名和端口、用户名和密码。

如果您之前在远程系统上配置了 SSH 密钥身份验证,则需要进行以下调整以避免 SSH 出现“ssh 握手失败”问题。 ”

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

应用更改:

sudo systemctl restart sshd

现在,您的连接将显示在您的鳄梨酱主页上,如下所示:

单击所需的连接以启动它。例如,ssh登录Rocky8服务器,点击它,您将看到如图所示的登录提示:

使用终端上的 exit 结束会话,您仍然可以随时从鳄梨酱服务器重新连接/转到主页/注销设备,即计算机、手机、平板电脑等。

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

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

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

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

结论

这就对了!您可以向鳄梨酱远程桌面服务器添加更多连接。我成功地演示了如何在 Debian Linux 系统上安装和使用 Guacamole 远程桌面。我希望这可以帮到你。

查看更多文章:

  • 在 CentOS 8 上安装和使用 Guacamole 远程桌面
  • 在 Ubuntu 上安装和使用 Guacamole 远程桌面
  • 在 Ubuntu 和 Debian 上安装 NoMachine 远程桌面工具
  • 智能手机远程桌面的未来

相关文章: