flcontainers/guacamole

Docker Guacamole

Apache Guacamole的Docker容器，这是一个无客户端远程桌面网关。它支持通过HTML5使用VNC、RDP和SSH等标准协议。

支持的Linux系统：amd64、arm64、ppc64el

此容器运行guacamole Web客户端、guacd服务器和PostgreSQL数据库（版本13）。

核心功能和特性

• 多架构支持：兼容amd64、arm64、ppc64el架构，可在多种硬件平台部署
• 集成组件：一站式包含Guacamole Web客户端、guacd代理服务器和PostgreSQL 13数据库
• 协议支持：通过HTML5浏览器实现VNC、RDP、SSH等远程协议访问，无需客户端软件
• 可扩展性：支持通过环境变量启用多种认证和功能扩展
• 数据持久化：配置文件和数据库存储在/config卷，确保容器重启或升级后数据不丢失

使用场景和适用范围

• 企业远程办公：为员工提供浏览器访问的远程桌面解决方案，无需安装客户端
• IT运维管理：管理员通过统一界面管理多台不同协议（VNC/RDP/SSH）的服务器
• 跨设备访问：支持PC、平板、手机等设备通过HTML5浏览器访问远程资源
• 教学演示环境：讲师可通过浏览器向学生展示远程服务器操作过程

使用方法（多架构）

shell
docker run \
  -p 8080:8080 \
  -v </path/to/config>:/config \
  flcontainers/guacamole

参数

参数格式为主机部分:容器部分，冒号分隔两侧路径或端口：

• -p 8080:8080 - 将服务绑定到Docker主机的8080端口，必需
• -v /config - 配置文件和数据库存储位置，必需
• -v /etc/localtime - 建议挂载以同步容器与主机系统时间
• -e TZ - 设置时区（标准格式：如Europe/Berlin）
• -e EXTENSIONS - 扩展启用参数，详见下文说明

启用扩展

通过-e EXTENSIONS环境变量启用扩展，多个扩展使用逗号分隔（无空格）。

示例：

shell
docker run \
  -p 8080:8080 \
  -v </path/to/config>:/config \
  -v /etc/localtime:/etc/localtime:ro \
  -e TZ="UTC" \
  -e EXTENSIONS="auth-ldap,auth-duo" \
  flcontainers/guacamole

支持的扩展列表：

• auth-duo - Duo双因素认证
• auth-header - HTTP头认证
• auth-jdbc-mysql - MySQL数据库认证
• auth-jdbc-postgresql - PostgreSQL数据库认证
• auth-jdbc-sqlserver - SQL Server数据库认证
• auth-json - JSON配置认证
• auth-ldap - LDAP认证
• auth-quickconnect - 快速连接功能
• auth-sso-openid - OpenID单点登录
• auth-sso-saml - SAML单点登录
• auth-sso-cas - CAS单点登录
• auth-totp - TOTP双因素认证
• vault-ksm - HashiCorp Vault密钥管理
• history-recording-storage - 会话记录存储

注意：仅启用所需扩展，错误的扩展配置可能导致系统无法启动。扩展配置详情见官方文档

默认用户

默认用户名为guacadmin，默认密码为guacadmin。

Windows Docker主机配置

在Windows系统上运行Docker时，卷映射可能导致PostgreSQL权限问题。建议使用本地卷驱动以保留配置数据，示例docker-compose.yml如下：

yaml
version: "3"
services:
  guacamole:
    image: flcontainers/guacamole
    container_name: guacamole
    environment:
      TZ: 'UTC'
      EXTENSIONS: 'auth-totp,auth-ldap'
    volumes:
      - postgres:/config
      - /etc/localtime:/etc/localtime:ro
    ports:
      - 8080:8080
volumes:
  postgres:
    driver: local

注意：使用此配置时需确保容器正常停止，避免数据丢失。

许可证

本程序为自由软件，可根据GNU通用公共许可证（GPLv3或更高版本）条款重新分发和修改。程序提供时不附带任何明示或暗示担保，包括但不限于适销性或特定用途适用性担保。详情见GNU通用公共许可证。