dpvduncan/guacamole-server

Guacamole Server 镜像文档

1. 镜像概述

Guacamole Server是Guacamole开源远程桌面网关的核心服务器组件，负责处理远程连接请求和协议转换。该镜像提供了轻量级、可部署的服务器环境，允许用户通过标准Web浏览器安全访问各类远程桌面服务，无需在客户端安装专用软件，简化远程访问流程。

2. 核心功能和特性

2.1 多协议支持

• 原生支持多种远程桌面协议，包括VNC、RDP（远程桌面协议）、SSH（安全外壳协议）及Telnet
• 支持协议扩展，可通过插件添加对其他协议的支持

2.2 Web化访问

• 基于Web技术实现远程桌面访问，用户仅需浏览器即可连接，无需客户端软件
• 支持主流浏览器（Chrome、Firefox、Edge等），跨平台兼容性强

2.3 集中式管理

• 提供集中化连接管理界面（需配合Guacamole Web应用）
• 支持用户认证与授权，可集成LDAP、Active Directory等身份系统

2.4 轻量化与可扩展

• 服务器组件资源占用低，适合边缘设备及云环境部署
• 模块化架构，支持横向扩展以应对高并发连接

3. 使用场景和适用范围

3.1 企业远程办公

• 员工通过浏览器安全访问公司内部服务器及工作站
• 替代传统***+客户端的复杂远程访问方案

3.2 多系统集中管理

• 管理员通过单一界面管理Windows、Linux、macOS等多平台服务器
• 适用于数据中心、机房设备远程维护

3.3 无客户端环境

• 公共终端、瘦客户端或临时设备（如访客电脑）无需安装软件即可访问远程系统
• 教育机构、图书馆等公共场合的远程资源访问

3.4 跨平台开发与测试

• 开发人员通过浏览器快速切换访问不同操作系统环境
• 简化多平台兼容性测试流程

4. 使用方法和配置说明

4.1 基本使用（Docker Run）

bash
docker run -d \
  --name guacamole-server \
  -p 4822:4822 \  # Guacamole服务器默认端口
  -v /path/to/guacd/logs:/var/log/guacd \  # 日志持久化
  guacamole/guacd:latest

4.2 核心环境变量

4.3 Docker Compose 配置示例

yaml
version: '3'
services:
  guacd:
    image: guacamole/guacd:latest
    container_name: guacamole-server
    ports:
      - "4822:4822"
    environment:
      - GUACD_LOG_LEVEL=info
      - GUACD_MAX_CONNECTIONS=100
    volumes:
      - guacd_logs:/var/log/guacd
      - guacd_lib:/usr/local/lib/guacamole
    restart: unless-stopped

volumes:
  guacd_logs:
  guacd_lib:

4.4 配置说明

4.4.1 端口映射

• 必须映射容器内4822端口（Guacamole服务器默认通信端口）至主机端口，供Guacamole Web应用连接

4.4.2 卷挂载

• /var/log/guacd: 日志目录，建议挂载以持久化保存连接日志
• /usr/local/lib/guacamole: 协议插件目录，如需自定义插件可挂载此目录

4.4.3 安全配置

• 生产环境建议配合反向代理（如Nginx）启用HTTPS
• 通过环境变量GUACD_MAX_CONNECTIONS限制并发连接，防止资源耗尽
• 配置网络隔离，仅允许Guacamole Web应用服务器访问4822端口

5. 注意事项

• 该镜像仅包含Guacamole服务器组件（guacd），完整功能需配合Guacamole Web应用（guacamole-client）使用
• 首次使用需通过Guacamole Web应用配置远程连接参数（如目标主机、协议类型、认证信息）
• 高并发场景下建议通过负载均衡器实现多实例部署
• 定期更新镜像以获取安全补丁和功能更新