如何安装 Apache Guacamole 远程桌面网关
不乏使管理员能够连接到其服务器的应用程序。但至少可以说,将不同的应用程序用于不同的目的可能会变得忙碌。
值得庆幸的是,有一种更智能的做事方式——而且它自 2013 年以来就已存在。
输入:阿帕奇鳄梨酱。
它是一个无客户端远程桌面网关,支持 RDP、VNC 和 SSH 协议。它最好的一点是,一旦设置完毕,您只需要一个网络浏览器即可使用它。使用这个开源工具不需要任何扩展或工具!
这是设置 Apache Guacamole 的快速指南。
安装鳄梨酱的依赖项
在开始安装软件包依赖项之前,请记住以下先决条件:
- Linux 服务器(我们使用 Ubuntu 20.04 服务器)
- 根/管理员访问权限
- MariaDB数据库
- 连接到服务器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。
