rattydave/guacamole-uk

Guacamole

镜像概述

本镜像为独立的Guacamole（[***]

核心功能和特性

• 独立运行：无需数据库，配置直接通过XML文件管理
• UK键盘布局：内置en-gb-qwerty键盘布局支持
• 文件传输：支持通过挂载目录实现客户端与服务器间的文件传输
• 简化部署：通过卷挂载配置文件，无需复杂的数据库初始化

使用场景

• 个人或小型团队的远程桌面集中访问
• 临时或测试环境的快速远程连接部署
• 对数据库依赖有严格限制的环境
• 需要UK键盘布局的远程访问需求

使用方法

前置准备

1. 创建配置目录和数据目录：

   bash
   mkdir -p ./config ./data
   

2. 在config目录中创建用户映射配置文件usermapping.xml（详见配置文件部分）

启动容器

使用以下命令启动Guacamole容器：

bash
docker run \
   -dit \
   --name guac \
   -p 8080:8080 \
   -v ${PWD}/config:/etc/guacamole \
   -v ${PWD}/data:/file-transfer \
   rattydave/guacamole-uk:latest

访问服务

容器启动后，通过以下地址访问Guacamole：

http://<docker服务器IP>:8080/remote

配置文件说明

用户映射文件（usermapping.xml）

在./config目录下创建usermapping.xml文件，配置远程连接信息。基础示例：

xml
<user-mapping>
    <authorize username="John" password="securepassword">
        <protocol>vnc</protocol>
        <param name="hostname">somevnc.hostname.com</param>
        <param name="port">5900</param>
        <param name="password">vncpassword</param>
    </authorize>
</user-mapping>

启用文件传输

在用户授权配置中添加以下参数：

xml
<param name="enable-drive">true</param>
<param name="drive-path">/file-transfer</param>

配置UK键盘布局

在用户授权配置中添加以下参数：

xml
<param name="server-layout">en-gb-qwerty</param>

自动更新

推荐使用Watchtower实现容器自动更新：

bash
docker run -d \
    --name watchtower \
    -v /var/run/docker.sock:/var/run/docker.sock \
    containrrr/watchtower 

完整版本部署（含数据库）

如需使用完整版Guacamole（带数据库支持），可按以下步骤部署：

bash
####### Guacamole 完整版本部署 #######

# 设置MySQL环境变量
MYSQL_ROOT_PASSWORD=pass@word01
MYSQL_DATABASE=guacamole_db
MYSQL_USER=guacamole_user
MYSQL_PASSWORD=some_password

# 设置Docker实例名称
MYSQL_NAME=mysqldb
GUACD_NAME=some_guacd
GUACAMOLE_NAME=some-guacamole

# 拉取所需镜像
docker pull guacamole/guacamole
docker pull guacamole/guacd
docker pull mysql

# 初始化数据库
mkdir /root/dbinit
docker run --rm guacamole/guacamole /opt/guacamole/bin/initdb.sh --mysql > /root/dbinit/guacamole_initdb.sql

# 启动MySQL容器
docker run -d --name $MYSQL_NAME \
    -v /root/dbinit:/docker-entrypoint-initdb.d \
    -e MYSQL_ROOT_PASSWORD=$MYSQL_ROOT_PASSWORD \
    -e MYSQL_DATABASE=$MYSQL_DATABASE \
    -e MYSQL_USER=$MYSQL_USER \
    -e MYSQL_PASSWORD=$MYSQL_PASSWORD \
    mysql

# 清理初始化文件
rm -r /root/dbinit

# 启动guacd服务
docker run --name $GUACD_NAME -d guacamole/guacd

# 启动Guacamole服务
docker run --name $GUACAMOLE_NAME \
    --link $GUACD_NAME:guacd \
    --link $MYSQL_NAME:mysql \
    -e MYSQL_DATABASE=$MYSQL_DATABASE \
    -e MYSQL_USER=$MYSQL_USER \
    -e MYSQL_PASSWORD=$MYSQL_PASSWORD \
    -d -p 8080:8080 \
    guacamole/guacamole

# 访问地址：http://<docker服务器IP>:8080/guacamole
# 默认账号：guacadmin，默认密码：guacadmin
####### 部署结束 #######

完整版本用户映射配置示例可参考：[***] 安装脚本示例：https://raw.githubusercontent.com/RattyDAVE/guacamole-uk/master/install.sh