本页内容

  • 准备工作
  • 安装 Docker Engine
  • 安装 Docker Compose
  • 下载 Apache Guacamole 服务端和客户端
  • 启动 Apache Guacamole MySQL 容器
  • 启动 Guacamole 服务端容器
  • 启动 Guacamole 客户端容器
  • 访问 Apache Guacamole 仪表盘
  • 总结

Apache Guacamole 是一款免费、开源、无客户端的远程桌面应用程序,允许你通过 Web 浏览器访问远程桌面和服务器主机。它支持 VNC、RDP、SSH 等标准协议,并使用 HTML5 进行远程连接。它可以运行在大多数 Linux 发行版上,客户端可运行于任何现代 Web 浏览器。你无需在系统上安装任何软件,只需浏览并连接到服务器上定义的任意远程主机即可。

在本文中,我们将向你展示如何在 Ubuntu 22.04 上使用 Docker 安装 Apache Guacamole 服务端和客户端。

准备工作

  • 一台运行 Ubuntu 22.04 的服务器。
  • 服务器上已配置 root 密码。

安装 Docker Engine

始终建议为你的服务器安装最新版本的 Docker。

首先,使用以下命令安装所需的依赖项:

apt install ca-certificates curl gnupg lsb-release -y

安装完所有依赖项后,使用以下命令添加 Docker GPG 密钥和软件仓库:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | gpg --dearmor > /etc/apt/trusted.gpg.d/docker-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture)] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" > /etc/apt/sources.list.d/docker.list

接下来,使用以下命令更新软件仓库并安装 Docker Engine 软件包:

apt update -y
apt install docker-ce docker-ce-cli containerd.io -y

安装完成后,使用以下命令验证 Docker 版本:

docker --version

你应该会看到以下输出:

Docker version 20.10.18, build b40c2f6

安装 Docker Compose

你还需要在服务器上安装 Docker Compose。你可以使用以下命令进行安装:

curl -sL "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

接下来,使用以下命令验证 Docker Compose 版本:

docker-compose --version

你将看到以下输出:

docker-compose version 1.29.2, build 5becea4c

下载 Apache Guacamole 服务端和客户端

首先,你需要从 Docker 镜像仓库下载 Apache Guacamole 服务端和客户端镜像。

首先,使用以下命令下载服务端镜像:

docker pull guacamole/guacd

你应该会看到以下输出:

Using default tag: latest
latest: Pulling from guacamole/guacd
4b7b4a8876e2: Pull complete 
4e542e9cf89d: Pull complete 
9741340fbbb2: Pull complete 
96fa725029d6: Pull complete 
0f0a6df13f2a: Pull complete 
a4fa6e99a790: Pull complete 
07365dfaa371: Pull complete 
Digest: sha256:efdc09beba21e2c5d7c8c77e8c6b95ffd173d75645c9c41b6024f5b835d2a034
Status: Downloaded newer image for guacamole/guacd:latest
docker.io/guacamole/guacd:latest

首先,使用以下命令下载客户端镜像:

docker pull guacamole/guacamole

你应该会看到以下输出:

Using default tag: latest
latest: Pulling from guacamole/guacamole
2b55860d4c66: Pull complete 
2ca45fc4c4ca: Pull complete 
0cd32add6672: Pull complete 
ac52cbbb8ca2: Pull complete 
7f7dc3a9f4cc: Pull complete 
5d7996a24402: Pull complete 
4819d3e4118d: Pull complete 
055afbac1f72: Pull complete 
23ee772344b7: Pull complete 
e44569de6126: Pull complete 
f7d7e8014b18: Pull complete 
Digest: sha256:8a8db8cf9f5359aa20547382213a42a720ea1c5fe86460ded727061e1995d9f2
Status: Downloaded newer image for guacamole/guacamole:latest
docker.io/guacamole/guacamole:latest

接下来,使用以下命令验证已下载的镜像:

docker images

你将看到以下输出:

REPOSITORY            TAG       IMAGE ID       CREATED        SIZE
guacamole/guacd       latest    4086ac9e35a7   9 hours ago    271MB
guacamole/guacamole   latest    959856a45436   10 hours ago   432MB

启动 Apache Guacamole MySQL 容器

首先,你需要为 Apache Guacamole 认证准备至少一个数据库容器。你可以使用以下命令下载并启动 MySQL 容器:

docker run --name guacamoledb -e MYSQL_ROOT_PASSWORD=password -e MYSQL_DATABASE=guacdb -d mysql/mysql-server

你将看到以下输出:

latest: Pulling from mysql/mysql-server
cdd8b07c6082: Pull complete 
c2f1720beca1: Pull complete 
39f143a8d6de: Pull complete 
118a8285b641: Pull complete 
b45cbcaf75c7: Pull complete 
d4574372e600: Pull complete 
1f565a3cbc52: Pull complete 
Digest: sha256:e30a0320f2e3c7b7ee18ab903986ada6eb1ce8e5ef29941b36ec331fae5f10b2
Status: Downloaded newer image for mysql/mysql-server:latest
c7a9309eac20a7d0bb6f0a16460bf2b678aae741c201efae8974ea64a3736595

接下来,创建一个用于存储数据库的目录:

mkdir -p /opt/guacamole/mysql

接下来,使用以下命令生成 MySQL 初始化脚本:

docker run --rm guacamole/guacamole /opt/guacamole/bin/initdb.sh --mysql > /opt/guacamole/mysql/01-initdb.sql

接下来,将 Guacamole MySQL 数据库初始化脚本复制到 MySQL Docker 容器中:

docker cp /opt/guacamole/mysql/01-initdb.sql guacamoledb:/docker-entrypoint-initdb.d

接下来,使用以下命令连接到 MySQL 数据库容器:

docker exec -it guacamoledb bash

连接成功后,你将进入以下 shell:

bash-4.4# 

接下来,使用以下命令列出 MySQL 初始化脚本:

cd /docker-entrypoint-initdb.d/
ls

输出:

01-initdb.sql

接下来,使用以下命令连接到 MySQL shell:

mysql -u root -p

接下来,将数据库切换为 guacd 并初始化 Guacamole 数据库:

use guacdb;
source 01-initdb.sql;

接下来,使用以下命令验证所有表:

show tables;

你将看到以下输出:

+---------------------------------------+
| Tables_in_guacdb                      |
+---------------------------------------+
| guacamole_connection                  |
| guacamole_connection_attribute        |
| guacamole_connection_group            |
| guacamole_connection_group_attribute  |
| guacamole_connection_group_permission |
| guacamole_connection_history          |
| guacamole_connection_parameter        |
| guacamole_connection_permission       |
| guacamole_entity                      |
| guacamole_sharing_profile             |
| guacamole_sharing_profile_attribute   |
| guacamole_sharing_profile_parameter   |
| guacamole_sharing_profile_permission  |
| guacamole_system_permission           |
| guacamole_user                        |
| guacamole_user_attribute              |
| guacamole_user_group                  |
| guacamole_user_group_attribute        |
| guacamole_user_group_member           |
| guacamole_user_group_permission       |
| guacamole_user_history                |
| guacamole_user_password_history       |
| guacamole_user_permission             |
+---------------------------------------+

接下来,使用以下命令创建一个管理员用户并设置密码:

create user guacadmin@'%' identified by 'password';
grant SELECT,UPDATE,INSERT,DELETE on guacdb.* to guacadmin@'%';

接下来,使用以下命令刷新权限并退出 MySQL shell:

flush privileges;
exit;

接下来,使用以下命令退出 MySQL 容器:

exit

你现在可以使用以下命令验证正在运行的容器:

docker ps

你应该在以下输出中看到 MySQL 容器:

CONTAINER ID   IMAGE                COMMAND                  CREATED         STATUS                   PORTS                       NAMES
c7a9309eac20   mysql/mysql-server   "/entrypoint.sh mysq…"   2 minutes ago   Up 2 minutes (healthy)   3306/tcp, 33060-33061/tcp   guacamoledb

你也可以使用以下命令查看容器日志:

docker logs guacamoledb

你将看到以下输出:

[Entrypoint] Starting MySQL 8.0.30-1.2.9-server
2022-10-02T11:31:52.589985Z 0 [Warning] [MY-011068] [Server] The syntax '--skip-host-cache' is deprecated and will be removed in a future release. Please use SET GLOBAL host_cache_size=0 instead.
2022-10-02T11:31:52.592352Z 0 [System] [MY-010116] [Server] /usr/sbin/mysqld (mysqld 8.0.30) starting as process 1
2022-10-02T11:31:52.602604Z 1 [System] [MY-013576] [InnoDB] InnoDB initialization has started.
2022-10-02T11:31:52.875859Z 1 [System] [MY-013577] [InnoDB] InnoDB initialization has ended.
2022-10-02T11:31:53.131572Z 0 [Warning] [MY-010068] [Server] CA certificate ca.pem is self signed.
2022-10-02T11:31:53.131639Z 0 [System] [MY-013602] [Server] Channel mysql_main configured to support TLS. Encrypted connections are now supported for this channel.
2022-10-02T11:31:53.163561Z 0 [System] [MY-011323] [Server] X Plugin ready for connections. Bind-address: '::' port: 33060, socket: /var/run/mysqld/mysqlx.sock
2022-10-02T11:31:53.163648Z 0 [System] [MY-010931] [Server] /usr/sbin/mysqld: ready for connections. Version: '8.0.30'  socket: '/var/lib/mysql/mysql.sock'  port: 3306  MySQL Community Server - GPL.

启动 Guacamole 服务端容器

现在,运行以下命令启动 Guacamole 服务端容器:

docker run --name guacamole-server -d guacamole/guacd

你可以使用以下命令查看容器日志:

docker logs --tail 10 guacamole-server

你将看到以下输出:

guacd[7]: INFO:	Guacamole proxy daemon (guacd) version 1.4.0 started
guacd[7]: INFO:	Listening on host 0.0.0.0, port 4822

要检查正在运行的容器,请使用以下命令:

docker ps

你将看到以下输出:

CONTAINER ID   IMAGE                COMMAND                  CREATED          STATUS                             PORTS                       NAMES
51b2efdab0db   guacamole/guacd      "/bin/sh -c '/usr/lo…"   26 seconds ago   Up 25 seconds (health: starting)   4822/tcp                    guacamole-server
c7a9309eac20   mysql/mysql-server   "/entrypoint.sh mysq…"   3 minutes ago    Up 3 minutes (healthy)             3306/tcp, 33060-33061/tcp   guacamoledb

启动 Guacamole 客户端容器

你也可以使用以下命令启动 Guacamole 客户端容器:

docker run --name guacamole-client --link guacamole-server:guacd --link guacamoledb:mysql -e MYSQL_DATABASE=guacdb -e MYSQL_USER=guacadmin -e MYSQL_PASSWORD=password -d -p 80:8080 guacamole/guacamole

接下来,使用以下命令验证正在运行的容器:

docker ps

你应该会看到以下输出:

CONTAINER ID   IMAGE                 COMMAND                  CREATED              STATUS                                 PORTS                                   NAMES
d4034a72bb69   guacamole/guacamole   "/opt/guacamole/bin/…"   58 seconds ago       Up 57 seconds                          0.0.0.0:80->8080/tcp, :::80->8080/tcp   guacamole-client
51b2efdab0db   guacamole/guacd       "/bin/sh -c '/usr/lo…"   About a minute ago   Up About a minute (health: starting)   4822/tcp                                guacamole-server
c7a9309eac20   mysql/mysql-server    "/entrypoint.sh mysq…"   5 minutes ago        Up 5 minutes (healthy)                 3306/tcp, 33060-33061/tcp               guacamoledb

此时,Guacamole 容器已启动并监听 80 端口。你可以使用以下命令进行检查:

ss -altnp | grep :80

你将看到以下输出:

LISTEN 0      4096         0.0.0.0:80        0.0.0.0:*    users:(("docker-proxy",pid=4006,fd=4))   
LISTEN 0      4096            [::]:80           [::]:*    users:(("docker-proxy",pid=4013,fd=4))   

访问 Apache Guacamole 仪表盘

你现在可以通过 URL http://your-server-ip/guacamole 访问 Apache Guacamole Web 界面。你应该会看到 Guacamole 登录界面:

在 Ubuntu 系统上从零部署 Apache Guacamole 远程桌面网关

输入默认凭据:

用户名:guacadmin

密码:guacadmin

然后,点击 Login 按钮。你应该会在以下界面中看到 Guacamole 仪表盘:

在 Ubuntu 系统上从零部署 Apache Guacamole 远程桌面网关

总结

恭喜!你已成功在 Ubuntu 22.04 服务器上使用 Docker 安装了 Apache Guacamole 服务端和客户端。你现在可以创建新的连接并通过 Web 浏览器访问远程服务器。如果你有任何问题,欢迎随时向我提问。