doritoes/guacamole

⚠️ 本项目是oznu/docker-guacamole的分支，原项目已归档且不再维护。目前我的测试环境不包括LDAP或其他认证服务。

Docker Guacamole

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

该镜像可在大多数支持Docker的平台上运行，包括Docker for Mac、Docker for Windows、Synology DSM和Raspberry Pi 3开发板。

此容器运行Guacamole Web客户端、guacd服务器和PostgreSQL数据库。

用法

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

Raspberry Pi / ARMv6

通过使用armhf标签，此镜像还允许在Raspberry Pi或其他支持Docker的ARMv5/6/7/8设备上运行Apache Guacamole。

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

Raspberry Pi 64位 / ARMv8

通过使用arm64v8标签，此镜像还允许在Raspberry Pi或其他支持Docker的64位ARM设备上运行Apache Guacamole。

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

参数

参数分为两部分，由冒号分隔，左侧代表主机端，右侧代表容器端。

• -p 8080:8080 - 将服务绑定到Docker主机的8080端口，必需
• -v /config - 配置和数据库位置，必需
• -e EXTENSIONS - 详见下文说明

启用扩展

可使用-e EXTENSIONS变量启用扩展。多个扩展可使用逗号分隔的列表启用（无空格）。

例如：

shell
docker run \
  -p 8080:8080 \
  -v </path/to/config>:/config \
  -e "EXTENSIONS=auth-ldap,auth-duo" \
  oznu/guacamole

当前可用的扩展包括：

• auth-ldap - LDAP认证
• auth-duo - Duo双因素认证
• auth-header - HTTP头认证
• auth-cas - CAS认证
• auth-openid - OpenID Connect认证
• auth-totp - TOTP双因素认证
• auth-quickconnect - 临时连接扩展

应仅启用所需的扩展。如果guacamole.properties文件中扩展配置不正确，可能会导致系统无法加载。更多详情请参见官方文档。

默认用户

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

基于Windows的Docker主机

在运行Docker for Windows时，映射卷的行为有所不同，可能会遇到PostgreSQL文件系统权限问题。为避免这些问题并在容器升级和重建之间保留配置，可使用本地卷驱动，如下文docker-compose.yml示例所示。使用此设置时，请注意优雅地停止容器，否则可能会丢失数据。

yml
version: "2"
services:
  guacamole:
    image: doritoes/guacamole
    container_name: guacamole
    volumes:
      - postgres:/config
    ports:
      - 8080:8080
volumes:
  postgres:
    driver: local

许可证

Copyright (C) 2021-2022 doritoes

本程序是自由软件：您可以根据自由软件基金会发布的GNU通用公共许可证（第三版或更高版本）重新分发和/或修改它。

本程序的分发旨在希望它有用，但不提供任何明示或暗示的担保，包括但不限于适销性和特定用途适用性的担保。详见GNU通用公共许可证了解更多信息。