dpvduncan/guacamole-client

Guacamole Client 镜像文档

镜像概述

Guacamole Client是Apache Guacamole项目的Web客户端组件，用于提供基于浏览器的远程桌面访问界面。它需与Guacamole Server（guacd）及后端数据库（如MySQL、PostgreSQL）配合使用，实现用户通过Web浏览器安全访问远程服务器、桌面或应用，无需在本地安装专用客户端软件。

核心功能与特性

• 多协议支持：兼容RDP（Windows远程桌面）、VNC（虚拟网络计算）、SSH（安全外壳）、Telnet等多种远程访问协议
• 纯Web访问：用户通过标准Web浏览器即可连接远程资源，无需安装额外客户端软件
• 跨平台兼容：支持在Windows、macOS、Linux等操作系统的主流浏览器（Chrome、Firefox、Edge等）中运行
• 集中式管理：通过Guacamole管理界面配置和管理多个远程连接，支持用户权限控制
• 安全性：支持SSL/TLS加密传输，可集成LDAP、Active Directory等身份认证系统

使用场景与适用范围

• 企业远程办公：员工通过浏览器安全访问公司内部桌面或应用，无需***客户端
• 服务器远程管理：系统管理员通过Web界面管理多台服务器（Linux/Windows），支持SSH/RDP连接
• 教学与演示：教师远程演示操作，学生通过浏览器实时查看，无需安装专用软件
• 云环境访问：访问云服务器（如AWS EC2、Azure VM）或容器化桌面环境

使用方法与配置说明

前置条件

部署Guacamole Client需配合以下组件：

• Guacamole Server（guacd）：处理远程连接协议的后端服务
• 数据库：存储用户、连接配置等数据（支持MySQL、PostgreSQL、SQLite等）

基本部署（Docker Run）

1. 启动Guacamole Server（guacd）

bash
docker run -d --name guacd -p 4822:4822 guacamole/guacd

2. 启动数据库（以MySQL为例）

bash
docker run -d --name guacamole-mysql \
  -e MYSQL_ROOT_PASSWORD=rootpassword \
  -e MYSQL_DATABASE=guacamole_db \
  -e MYSQL_USER=guacamole_user \
  -e MYSQL_PASSWORD=guacamole_password \
  mysql:8.0

3. 初始化数据库

bash
docker run --rm guacamole/guacamole /opt/guacamole/bin/initdb.sh --mysql > initdb.sql
docker exec -i guacamole-mysql mysql -u root -p rootpassword guacamole_db < initdb.sql

4. 启动Guacamole Client

bash
docker run -d --name guacamole-client \
  -p 8080:8080 \
  --link guacd:guacd \
  --link guacamole-mysql:mysql \
  -e GUACD_HOSTNAME=guacd \
  -e GUACD_PORT=4822 \
  -e MYSQL_HOSTNAME=mysql \
  -e MYSQL_DATABASE=guacamole_db \
  -e MYSQL_USER=guacamole_user \
  -e MYSQL_PASSWORD=guacamole_password \
  guacamole/guacamole

Docker Compose配置示例

yaml
version: '3'

services:
  guacd:
    image: guacamole/guacd
    container_name: guacd
    restart: always
    ports:
      - "4822:4822"

  mysql:
    image: mysql:8.0
    container_name: guacamole-mysql
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: rootpassword
      MYSQL_DATABASE: guacamole_db
      MYSQL_USER: guacamole_user
      MYSQL_PASSWORD: guacamole_password
    volumes:
      - mysql-data:/var/lib/mysql

  guacamole-client:
    image: guacamole/guacamole
    container_name: guacamole-client
    restart: always
    ports:
      - "8080:8080"
    environment:
      GUACD_HOSTNAME: guacd
      GUACD_PORT: 4822
      MYSQL_HOSTNAME: mysql
      MYSQL_DATABASE: guacamole_db
      MYSQL_USER: guacamole_user
      MYSQL_PASSWORD: guacamole_password
    depends_on:
      - guacd
      - mysql

volumes:
  mysql-data:

配置说明

环境变量

访问与配置

1. 部署完成后，通过浏览器访问 http://<宿主机IP>:8080/guacamole
2. 使用默认管理员账号登录：用户名 guacadmin，密码 guacadmin（首次登录需修改密码）
3. 在管理界面添加远程连接（如RDP、VNC、SSH），配置目标主机、端口、认证信息等
4. 创建用户并分配连接权限，实现多用户管理

注意事项

• 生产环境中需启用SSL/TLS加密（可通过反向代理如Nginx配置HTTPS）
• 定期更新镜像以获取安全补丁：docker pull guacamole/guacamole
• 数据库数据需持久化存储（如使用Docker Volume），避免容器删除导致数据丢失
• Guacamole Client需与Guacamole Server版本匹配，避免兼容性问题