网站搜索

如何安装 Apache Guacamole 远程桌面网关


不乏使管理员能够连接到其服务器的应用程序。但至少可以说,将不同的应用程序用于不同的目的可能会变得忙碌。

值得庆幸的是,有一种更智能的做事方式——而且它自 2013 年以来就已存在。

输入:阿帕奇鳄梨酱。

它是一个无客户端远程桌面网关,支持 RDP、VNC 和 SSH 协议。它最好的一点是,一旦设置完毕,您只需要一个网络浏览器即可使用它。使用这个开源工具不需要任何扩展或工具!

这是设置 Apache Guacamole 的快速指南。

安装鳄梨酱的依赖项

在开始安装软件包依赖项之前,请记住以下先决条件:

  1. Linux 服务器(我们使用 Ubuntu 20.04 服务器)
  2. 根/管理员访问权限
  3. MariaDB数据库
  4. 连接到服务器IP的域名

鳄梨酱分为两部分:服务器和客户端。必须使用源代码手动安装服务器。客户端是在 Tomcat 下运行的 Java Serverlet Web 应用程序前端。

要安装依赖项,请启动终端,连接到服务器,然后运行以下命令:

sudo apt install build-essential libcairo2-dev libjpeg-turbo8-dev libpng-dev libtool-bin uuid-dev libossp-uuid-dev libavcodec-dev libavformat-dev libavutil-dev libswscale-dev freerdp2-dev libpango1.0-dev libssh2-1-dev libtelnet-dev libvncserver-dev libwebsockets-dev libpulse-dev libssl-dev libvorbis-dev libwebp-dev -y


您还需要为 Web 应用程序安装 Tomcat 9:

sudo apt install tomcat9 -y


接下来的两个命令将分别启动和启用 Tomcat 9,并验证其状态:

sudo systemctl enable –now tomcat9

sudo systemctl status tomcat9

编译并安装鳄梨酱服务器

首先运行以下 wget 命令来下载所需的源代码:

wget https://dlcdn.apache.org/guacamole/1.4.0/source/guacamole-server-1.4.0.tar.gz

现在您的计算机上已经有了该文件,请使用以下命令将其解压缩:

tar -xzf guacamole-server-1.4.0.tar.gz

接下来,将目录更改为提取的文件,如下所示:

cd guacamole-server-1.4.0/

使用以下脚本设置服务器:

./configure –with-systemd-dir=/etc/systemd/system/ –disable-dependency-tracking

上面命令中的第一个选项会自动将脚本安装到 /etc 中提到的目录。第二个选项禁用依赖项跟踪,从而缩短构建时间。

输出将向您显示鳄梨酱版本、库状态、协议支持以及鳄梨酱附带的工具/服务。如果您看到此输出,则说明您正在安装鳄梨酱。

下面的命令将编译 Guacamole 服务器并将二进制文件安装在 usr/local/bin 和 usr/local/sbin 中。这些库将安装在 usr/local/lib 中。

make

make install

然后,使用以下命令更新系统库的符号链接并重新加载 systemd:

sudo ldconfig

sudo systemctl daemon-reload

最后,启动并启用鳄梨酱服务器并使用以下命令验证其状态:

sudo systemctl enable –now guacd

sudo systemctl status guacd

您应该看到一个输出,表明 guacd 正在运行。

创建配置并设置目录

鳄梨酱安装需要一个配置目录才能工作。创建 /etc/guacamole/ 目录是 Guacamole 存储配置文件的地方。

下面的命令将创建一个环境变量“GUACAMOLE_HOME”并将其设置为 Tomcat 配置,确保 Tomcat 始终加载 Guacamole 配置目录。

echo GUACAMOLE_HOME=/etc/guacamole >> /etc/default/tomcat9

运行下面的命令将创建实际的配置目录,以及“extensions”和“lib”目录。

mkdir -p /etc/guacamole/{extensions,lib}

最后,您可以像这样创建配置文件:

touch /etc/guacamole/{guacamole.properties,guacd.conf}

设置 MariaDB 数据库

首先以 root 用户身份登录 MariaDB shell:

mysql -u root -p

然后,创建一个新数据库,并退出 shell:

CREATE DATABASE guacamole_db;

exit

要继续,您需要鳄梨酱的数据库身份验证扩展。运行此命令来下载它:

wget https://dlcdn.apache.org/guacamole/1.4.0/binary/guacamole-auth-jdbc-1.4.0.tar.gz

解压它并将您的目录切换到解压的文件,如下所示:

tar -xf guacamole-auth-jdbc-1.4.0.tar.gz

cd guacamole-auth-jdbc-1.4.0/mysql/

将 Guacamole MariaDB 数据库方案导入到新创建的数据库中:

ls

cat schema/*.sql | mysql -u root -p guacamole_db

您需要输入 MariaDB root 用户的密码。完成后,运行以下命令再次登录 MariaDB shell。

mysql -u root -p

我们再次登录,为 Guacamole 创建一个新的 MariaDB 用户。运行这些,你就可以开始了:

CREATE USER ‘guacamole_user’@’localhost’ IDENTIFIED BY ‘StrongPassword’;

GRANT SELECT,INSERT,UPDATE,DELETE ON guacamole_db.* TO ‘guacamole_user’@’localhost’;

FLUSH PRIVILEGES;

exit

安装数据库身份验证扩展和 MySQL/J 库

该扩展使您能够使用数据库身份验证设置鳄梨酱。虽然我们使用的是 MariaDB,但您也可以使用 PostgreSQL。

使用这些命令将工作目录更改为所需的 mysql 文件夹,然后列出文件:

cd guacamole-auth-jdbc-1.4.0/mysql/

ls -lah

剩下要做的就是使用以下命令安装扩展:

cp guacamole-auth-jdbc-mysql-1.4.0.jar /etc/guacamole/extensions/guacamole-auth-jdbc-mysql.jar

我们还必须安装 MySQL/J 库才能连接到 MariaDB。让我们开始下载它:

wget https://cdn.mysql.com//Downloads/Connector-J/mysql-connector-java_8.0.28-1ubuntu20.04_all.deb

接下来,使用 dpkg 命令安装连接器:

dpkg -i mysql-connector-java_8.0.28-1ubuntu20.04_all.deb

在我们继续之前,将连接器库复制到 /etc/guacamole 中的 /lib 文件夹,以便 Guacamole 可以使用它连接到 MariaDB:

cp /usr/share/java/mysql-connector-java-8.0.28.jar /etc/guacamole/lib/mysql-connector.jar

将鳄梨酱与 MariaDB 连接

尽管您已经安装了扩展程序和连接器,但除非您使用数据库身份验证,否则它们不会执行任何操作。您将通过 guacamole.properties 文件中的配置应用身份验证。

使用任何文本编辑器打开 /etc/guacamole/guacamole.properties 并将以下配置粘贴到文件中:

mysql-hostname: localhost

mysql-port: 3306

mysql-database: guacamole_db

mysql-username: guacamole_user

mysql-password: StrongPassword

接下来,您必须在 /etc/guacamole/guacd.conf 中设置 guacd 绑定 IP 地址。将以下内容放入文件中:

[server]

bind_host = 0.0.0.0

bind_port = 4822

运行以下命令以应用您所做的更改:

sudo systemctl restart guacd

sudo systemctl restart tomcat9

安装鳄梨酱客户端

您已经到达了鳄梨酱设置的倒数第二部分。首先下载预构建的鳄梨酱客户端包,如下所示:

wget <https://dlcdn.apache.org/guacamole/1.4.0/binary/guacamole-1.4.0.war>

然后,运行以下命令重命名包并将其移动到 /var/lib/tomcat9 中的 webapps 目录:

mv guacamole-1.4.0.war guacamole.war

cp guacamole.war /var/lib/tomcat9/webapps

ls /var/lib/tomcat9/webapps

为了使客户端能够从路径 URL 进行访问,需要移动文件。

将 Apache 设置为客户端的反向代理

在您最终开始使用 Guacamole 之前,您必须安装并配置具有虚拟主机配置的网络服务器。这个想法是使用网络服务器作为客户端的反向代理。

首先使用 certbot 文档为您的域名获取免费的 LetsEncrypt SSL 证书。接下来,使用以下命令安装 Apache Web 服务器:

sudo apt install apache2 -y

此命令将启用反向代理的模块:

sudo a2enmod proxy proxy_wstunnel proxy_http ssl rewrite

创建虚拟主机配置文件 /etc/apache2/sites-available/guacamole.conf 并粘贴以下配置。请记住,您必须将 example.io 域名更改为您拥有的域名。 SSL 证书的路径也是如此。

<VirtualHost *:80>

ServerName example.io

ServerAlias www.example.io

Redirect permanent / https://example.io/

</VirtualHost>

<VirtualHost *:443>

ServerName example.io

ServerAlias www.example.io

<If “%{HTTP_HOST} == ‘www.example.io'”>

Redirect permanent / https://example.io/

</If>

ErrorLog /var/log/apache2/example.io-error.log

CustomLog /var/log/apache2/example.io-access.log combined

SSLEngine On

SSLCertificateFile /etc/letsencrypt/live/example.io/fullchain.pem

SSLCertificateKeyFile /etc/letsencrypt/live/example.io/privkey.pem

<Location /guacamole/>

Order allow,deny

Allow from all

ProxyPass http://127.0.0.1:8080/guacamole/ flushpackets=on

ProxyPassReverse http://127.0.0.1:8080/guacamole/

</Location>

<Location /guacamole/websocket-tunnel>

Order allow,deny

Allow from all

ProxyPass ws://127.0.0.1:8080/guacamole/websocket-tunnel

ProxyPassReverse ws://127.0.0.1:8080/guacamole/websocket-tunnel

</Location>

</VirtualHost>

激活配置并通过运行验证它:

a2ensite guacamole.conf

apachectl configtest

打开 /etc/tomcat9/server.xml 中的 Tomcat 配置并将以下内容粘贴到 部分:

<Valve className=”org.apache.catalina.valves.RemoteIpValve”

internalProxies=”127.0.0.1″

remoteIpHeader=”x-forwarded-for”

remoteIpProxiesHeader=”x-forwarded-by”

protocolHeader=”x-forwarded-proto” />

通过运行以下命令应用更改:

sudo systemctl restart apache2

sudo systemctl restart tomcat9

就是这样,你已经设置好了鳄梨酱!该 Web 应用程序在 Tomcat 下的端口 8080 上运行,路径为 /guacamole。

相关文章: