Docker搭建Guacd

关注

原创最新推荐文章于 2026-04-15 17:26:08 发布 1.6k 阅读 AI 写同款· GEO 优化 ›

超详细讲解搭建guacamole实现远程桌面由于项目需求需要一个远程桌面的内容，开始调研了guacamole，毕竟大厂，下面说下集成细节，希望帮助更多小伙伴。官网地址：http://guacamole.apache.org/ 由于项目不需要Kubernetes与group等内容，只是简单的远程桌面，这里就使用了1.0.0的版本。根据官网地址选择下载客户端与服务端 1、环境准备按照API内容，服务端需要依赖更改lib，这里选择yum安装。API地址：http://guacamole.apache.org/doc/gug/ -... 阅读详情

Guacd 是 Apache Guacamole 项目的一部分，它是一个服务器端的代理，用于处理通过 Guacamole 客户端进行的远程桌面协议（RDP）、虚拟网络计算（VNC）和其他协议的连接。Guacd 使得远程桌面连接更加高效，因为它减少了客户端和远程服务器之间的直接通信需求，从而提高了安全性和性能。

应用场景

远程桌面访问：Guacd 可以用于提供远程桌面访问，使得用户可以通过网络连接到他们的工作站或服务器。
远程管理：系统管理员可以使用 Guacd 远程管理服务器，无需直接物理接触。
教育和演示：教师或演讲者可以利用 Guacd 进行实时演示或教学，同时允许学生或听众进行互动。
协作工作环境：团队成员可以同时连接到同一台机器上，共同工作或讨论。

使用 Docker CLI 搭建 Guacd

以下是使用 Docker 命令行界面（CLI）部署 Guacd 的步骤：

拉取 Guacd 镜像：
```
docker pull guacamole/guacd
```
运行 Guacd 容器：
```
docker run --name some-guacd -d guacamole/guacd
```
- --name some-guacd：为容器指定一个名称。
- -d：以守护进程模式运行容器。
- guacamole/guacd：指定要运行的 Docker 镜像。

使用 Docker Compose 搭建 Guacd

Docker Compose 是一个用于定义和运行多容器 Docker 应用程序的工具。以下是使用 Docker Compose 部署 Guacd 的步骤：

创建 docker-compose.yml 文件：
```
version: '3'
services:
  guacd:
    image: guacamole/guacd
    container_name: some-guacd
    restart: always
```
- version：指定 Docker Compose 文件格式的版本。
- services：定义服务的列表。
- guacd：服务的名称。
- image：指定要使用的镜像。
- container_name：为容器指定一个名称。
- restart：配置容器的重启策略。
运行 Docker Compose：
```
docker-compose up -d
```
- up：创建并启动服务。
- -d：在后台运行服务。

官方参数解释

在使用 Guacd 镜像时，可以通过环境变量或 Docker 链接来配置 Guacd。以下是一些官方支持的参数及其作用：

GUACD_LOG_LEVEL：设置 Guacd 的日志级别。默认为 info，可以设置为 debug、info、warning、error 或 fatal。
```
docker run -e GUACD_LOG_LEVEL=debug -d guacamole/guacd
```
GUACD_HOSTNAME：当 Guacd 不是通过 Docker 链接提供时，用于建立远程桌面连接的主机名。
```
docker run --name some-guacamole -e GUACD_HOSTNAME=172.17.42.1 -d -p 8080:8080 guacamole/guacamole
```
GUACD_PORT：Guacamole 连接到 Guacd 时使用的端口。默认为标准的 Guacd 端口 4822。
```
docker run --name some-guacamole -e GUACD_PORT=4822 -d -p 8080:8080 guacamole/guacamole
```