热门搜索:
glyptodon/guacamole-ssl-nginx
glyptodon
基于Nginx的反向代理镜像，为Glyptodon Enterprise提供自动SSL终止功能，支持Let's Encrypt证书自动获取、自签名证书生成及现有证书使用。
1 次收藏下载次数: 0状态：社区镜像维护者：glyptodon仓库类型：镜像最近更新：4 年前
glyptodon/guacamole-ssl-nginx 镜像文档
镜像概述和主要用途
Glyptodon Enterprise 提供 Apache Guacamole 的软件包，遵循最佳实践，接收定期更新并提供商业支持。这些软件包的更新仅通过上游Apache Guacamole的贡献进行，且在不破坏兼容性的前提下进行。
本镜像（glyptodon/guacamole-ssl-nginx）是基于 https://hub.docker.com/_/nginx 构建的Docker化Nginx部署，预配置用于为Guacamole提供SSL终止。它支持：
- 从Let's Encrypt自动获取证书
- 自动生成自签名证书
- 使用已从证书颁发机构获取的现有证书
该镜像作为 Glyptodon Enterprise 的一部分提供，遵循相同的 EULA。通常用于为使用 glyptodon/guacamole 镜像 的容器提供SSL终止。
核心功能和特性
- 多证书支持：兼容Let's Encrypt自动证书、自签名证书和现有第三方证书
- 自动证书管理：Let's Encrypt证书自动续期，自签名证书定期更新（每21天）
- 灵活配置：通过环境变量轻松配置Guacamole后端连接参数
- Docker集成：支持Docker secrets管理敏感信息，与docker-compose无缝配合
- 基于官方Nginx：继承官方Nginx镜像的所有功能和特性
使用场景和适用范围
- 为Glyptodon Enterprise部署提供安全的HTTPS访问
- 开发/测试环境中快速搭建带有SSL的Guacamole服务
- 生产环境中通过Let's Encrypt实现自动化证书管理
- 需要使用企业内部CA颁发证书的安全环境
使用方法和配置说明
启动SSL终止的Nginx实例
要启动一个自动初始化为Apache Guacamole提供SSL终止的Nginx实例（包括从Let's Encrypt自动获取证书）：
shelldocker run --name some-guacamole-ssl \ -e ACCEPT_EULA=Y \ -e GUACAMOLE_HOSTNAME=some-guacamole \ -e SSL_HOSTNAME=guac.example.net \ -e LETSENCRYPT_ACCEPT_TOS=Y \ -e LETSENCRYPT_EMAIL=your.email@example.net \ -d glyptodon/guacamole-ssl-nginx
其中：
some-guacamole-ssl是你希望分配给容器的名称some-guacamole是 Guacamole实例或glyptodon/guacamole容器 的主机名或IP地址guac.example.net是用于通过互联网访问Guacamole的公共域名your.email@example.net是你希望注册到Let's Encrypt的电子邮件地址
使用 docker-compose
如果使用Docker部署Glyptodon Enterprise，强烈推荐使用 https://github.com/docker/compose%EF%BC%8C%E5%9B%A0%E4%B8%BA%E4%BB%BB%E4%BD%95%E4%BD%BF%E7%94%A8%E6%8F%90%E4%BE%9B%E7%9A%84Docker%E9%95%9C%E5%83%8F%E7%9A%84Glyptodon Enterprise部署都将涉及多个容器，docker-compose 可以极大地帮助编排这些容器。
例如，使用Let's Encrypt获取SSL证书并使用自动初始化的MySQL数据库进行身份验证的完整Glyptodon Enterprise部署如下：
yamlversion: "3" services: guacd: image: glyptodon/guacd environment: ACCEPT_EULA: Y db: image: glyptodon/guacamole-db-mysql environment: ACCEPT_EULA: Y MYSQL_RANDOM_ROOT_PASSWORD: "yes" GUACAMOLE_DATABASE: guacamole_db GUACAMOLE_USERNAME: guacamole_user GUACAMOLE_PASSWORD: some_password guacamole: image: glyptodon/guacamole environment: ACCEPT_EULA: Y GUACD_HOSTNAME: guacd MYSQL_HOSTNAME: db MYSQL_DATABASE: guacamole_db MYSQL_USERNAME: guacamole_user MYSQL_PASSWORD: some_password ssl: image: glyptodon/guacamole-ssl-nginx ports: - "80:80" - "443:443" environment: ACCEPT_EULA: Y GUACAMOLE_HOSTNAME: guacamole SSL_HOSTNAME: guac.example.net LETSENCRYPT_ACCEPT_TOS: Y LETSENCRYPT_EMAIL: your.email@example.net
支持的SSL证书类型
glyptodon/guacamole-ssl-nginx 支持多种生成、获取或使用现有SSL证书的机制。使用的机制取决于创建Docker容器时指定的环境变量。
除了这些机制特定的环境变量外，必须始终指定一组环境变量：
ACCEPT_EULA- 是否接受Glyptodon Enterprise EULA（使用镜像需要接受EULA）GUACAMOLE_HOSTNAME- Guacamole实例的主机名/地址SSL_HOSTNAME- 用于访问Guacamole的公共域名
Let's Encrypt
如果未提供现有证书且未请求生成自签名证书，默认使用Let's Encrypt。glyptodon/guacamole-ssl-nginx 镜像将使用"certbot"工具连接Let's Encrypt服务以获取SSL证书。
如果使用Let's Encrypt证书，严格要求的Let's Encrypt特定环境变量只有一个：
LETSENCRYPT_ACCEPT_TOS- 是否接受Let's Encrypt服务条款（使用该服务需要接受Let's Encrypt的服务条款）
除了接受其服务条款外，请注意Let's Encrypt强烈建议提供电子邮件地址，以便获取有关证书的重要警报。除非有特殊原因，否则应额外提供电子邮件地址：
LETSENCRYPT_EMAIL- 请求证书时提交给Let's Encrypt的电子邮件地址
如果只是测试Let's Encrypt的使用，应使用 Let's Encrypt staging/testing environment 而非生产环境：
LETSENCRYPT_STAGING- 设置为"Y"以使用Let's Encrypt的staging环境而非生产环境
获取的证书将在必要时由镜像自动续期。如果获取失败，容器将停止，失败详情将被记录，下次容器启动时将重试该过程。
glyptodon/guacamole-ssl-nginx 镜像利用Docker卷使Let's Encrypt证书和状态在容器重建时保持持久。
来自任意CA的现有证书
如果已从证书颁发机构获取证书，可以通过 CERTIFICATE_FILE 和 PRIVATE_KEY_FILE 环境变量指向相关文件来使用该证书。需要使用Docker卷挂载将相关文件暴露给镜像。
CERTIFICATE_FILE- 证书PEM文件的完整路径PRIVATE_KEY_FILE- 私钥PEM文件的完整路径
当证书需要向CA续期时，需要替换证书和私钥并重新加载Nginx。替换挂载的文件后，可以通过向容器进程发送SIGHUP信号来重新加载Nginx：
shelldocker kill --signal=SIGHUP some-guacamole-ssl
自签名证书
如果用于测试部署，镜像可以自动生成和维护自己的自签名证书：
SELF_SIGNED- 设置为"Y"以自动生成用于测试的自签名证书
glyptodon/guacamole-ssl-nginx 镜像将在启动时重新生成自签名证书。由于证书在生成后30天过期，镜像还将每21天自动重新生成证书以确保其不会过期。
每次证书重新生成时，将记录证书过期日期和指纹，允许基本的服务器身份验证。
环境变量
除下面记录的环境变量外，还接受 官方Docker Nginx镜像 支持的所有环境变量，因为官方Nginx镜像是此镜像的基础。
ACCEPT_EULA
ACCEPT_EULA 环境变量必须设置为"Y"，以表示您接受 Glyptodon Enterprise EULA。此Docker镜像只能在EULA条款下使用。
SSL_HOSTNAME
运行Docker的服务器的面向公众的主机名。此环境变量是必需的，应该是用于通过互联网访问Guacamole的完整公共域名，已与到达运行Docker和此镜像的服务器的IP地址相关联。
GUACAMOLE_HOSTNAME
Guacamole服务器的内部主机名或IP地址。此环境变量是必需的，应该是Nginx在处理连接时将在内部连接的主机名/地址。
请注意，此处提供的主机名/地址的Guacamole服务应仅在内部网络上可访问。只有SSL终止服务（此镜像）应面向公众。
GUACAMOLE_PORT
Guacamole服务器正在监听的TCP端口号。此环境变量是可选的。如果省略，将默认使用典型的8080端口。
GUACAMOLE_CONTEXT_PATH
Guacamole服务所在的路径。此环境变量是可选的。默认情况下，这将为空，表示Guacamole从根路径提供服务。与 glyptodon/guacamole 镜像的 GUACAMOLE_CONTEXT_PATH 环境变量一样，此参数不能包含斜杠。
例如，如果Guacamole在内部运行于 http://some-host/guacamole/，则应将 GUACAMOLE_CONTEXT_PATH 设置为 guacamole。
SELF_SIGNED
如果设置为"Y"，则请求为 SSL_HOSTNAME 自动生成自签名证书，而不是使用现有证书或从Let's Encrypt获取新证书。
自签名证书本质上是不安全的。此选项应仅用于测试。
CERTIFICATE_FILE 和 PRIVATE_KEY_FILE
SSL证书和相关私钥的PEM文件路径。这些路径是相对于Docker容器的文件系统的。需要使用Docker卷挂载将外部提供的SSL证书PEM文件暴露在容器内。
这些环境变量仅在提供自己的证书时需要。如果使用 SELF_SIGNED 进行测试的自签名证书，它们将被忽略。
LETSENCRYPT_ACCEPT_TOS
如果打算使用Let's Encrypt，LETSENCRYPT_ACCEPT_TOS 环境变量必须设置为"Y"，以表示您接受 Let's Encrypt服务条款。除非同意相关服务条款，否则不能使用Let's Encrypt。
此环境变量仅在使用Let's Encrypt时需要。如果使用 CERTIFICATE_FILE 和 PRIVATE_KEY_FILE 提供自己的证书，或使用 SELF_SIGNED 进行测试的自签名证书，则会被忽略。
LETSENCRYPT_EMAIL
请求证书时应提供给Let's Encrypt的电子邮件地址。此环境变量是可选的，如果使用 CERTIFICATE_FILE 和 PRIVATE_KEY_FILE 提供自己的证书，或使用 SELF_SIGNED 进行测试的自签名证书，则会被忽略。
虽然此环境变量是可选的，但请注意Let's Encrypt强烈建议在使用其服务获取证书时提供电子邮件地址。来自certbot工具的帮助内容：
... 强烈不建议这样做，因为在密钥丢失或账户泄露的情况下，您将不可挽回地失去对账户的访问权限。您也将无法收到有关证书即将过期或吊销的通知。订阅协议的更新仍然会影响您，并在网站上发布更新后14天生效。
LETSENCRYPT_STAGING
如果设置为"Y"，则请求使用 Let's Encrypt staging环境 获取SSL证书，而非生产环境。如果只是测试Let's Encrypt功能，应使用此选项。
Docker secrets
除了直接在环境变量中传递数据外，可以为该镜像支持的任何环境变量添加 _FILE 后缀，以强制从容器内的指定文件读取该变量。由于Docker secrets将敏感数据存储在容器内 /run/secrets/ 下的文件中，这可用于从Docker secrets加载敏感数据。
例如，从Docker secrets加载Let's Encrypt账户电子邮件：
shelldocker run --name some-guacamole-ssl \ -e ACCEPT_EULA=Y \ -e LETSENCRYPT_ACCEPT_TOS=Y \ -e LETSENCRYPT_EMAIL_FILE=/run/secrets/letsencrypt-email \ -d glyptodon/guacamole-ssl-nginx
许可证
此Docker镜像仅根据 Glyptodon Enterprise EULA 的条款提供。通过将环境变量 ACCEPT_EULA 的值设置为"Y"，表示您拥有有效的Glyptodon Enterprise许可证，并且接受您对此Docker镜像的使用受这些条款约束。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 guacamole-ssl-nginx 镜像标签
docker pull docker.xuanyuan.run/glyptodon/guacamole-ssl-nginx:<标签>
DockerHub 原生拉取命令
docker pull glyptodon/guacamole-ssl-nginx:<标签>
更多 guacamole-ssl-nginx 镜像推荐
keeper/guacamole-ssl-nginx
keeper
暂无描述
1万+ 次下载
3 个月前更新
nginx/nginx-ingress
NGINX 官方镜像
NGINX和NGINX Plus入口控制器是专为Kubernetes设计的流量管理工具，主要用于管理外部HTTP/HTTPS流量进入Kubernetes集群，支持请求路由、负载均衡、SSL终止、流量控制等功能，适用于容器化应用和微服务架构，其中NGINX Plus还提供商业支持、高级监控和增强的负载均衡能力，帮助提升集群流量管理的效率与安全性。
118 次收藏10亿+ 次下载
10 天前更新
nginx/nginx-prometheus-exporter
NGINX 官方镜像
NGINX Prometheus Exporter用于收集并导出NGINX与NGINX Plus的监控指标，供Prometheus采集以实现对其运行状态的监控。
51 次收藏5000万+ 次下载
2 个月前更新
nginxinc/nginx-unprivileged
nginxinc
非特权NGINX Docker构建文件是指用于构建以非root用户身份在Docker容器中运行NGINX的配置文件，通过预设用户权限、环境变量及安全参数，确保NGINX在低权限模式下仍能正常处理HTTP请求、反向代理及负载均衡等功能，有效降低因容器漏洞引发的权限提升风险，适用于对安全性要求较高的生产环境部署场景。
188 次收藏10亿+ 次下载
11 天前更新
nginx/nginx-ingress-operator
NGINX 官方镜像
用于NGINX和NGINX Plus入口控制器的NGINX入口操作器，基于Helm图表构建。
3 次收藏100万+ 次下载
1 个月前更新
nginxinc/nginx-s3-gateway
nginxinc
基于NGINX的认证和缓存网关，用于S3 API后端服务。
6 次收藏500万+ 次下载
12 天前更新
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
专属域名拉取
无需登录使用专属域名
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
Harbor 镜像源配置
Harbor Proxy Repository 对接专属域名
Portainer 镜像源配置
Portainer Registries 加速拉取
Nexus 镜像源配置
Nexus3 Docker Proxy 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
使用与功能问题
配置了专属域名后，docker search 为什么会报错？
docker search 限制
Docker Hub 上有的镜像，为什么在轩辕镜像网站搜不到？
站内搜不到镜像
机器不能直连外网时，怎么用 docker save / load 迁镜像？
离线 save/load
docker pull 拉插件报错（plugin v1+json）怎么办？
插件要用 plugin install
WSL 里 Docker 拉镜像特别慢，怎么排查和优化？
WSL 拉取慢
轩辕镜像安全吗？如何用 digest 校验镜像没被篡改？
安全与 digest
第一次用轩辕镜像拉 Docker 镜像，要怎么登录和配置？
新手拉取配置
轩辕镜像合规吗？轩辕镜像的合规是怎么做的？
镜像合规机制
错误码与失败问题
docker pull 提示 manifest unknown 怎么办？
manifest unknown
docker pull 提示 no matching manifest 怎么办？
no matching manifest（架构）
镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？
invalid tar header（解压）
Docker pull 时 HTTPS / TLS 证书验证失败怎么办？
TLS 证书失败
Docker pull 时 DNS 解析超时或连不上仓库怎么办？
DNS 超时
docker 无法连接轩辕镜像域名怎么办？
域名连通性排查
Docker 拉取出现 410 Gone 怎么办？
410 Gone 排查
出现 402 或「流量用尽」提示怎么办？
402 与流量用尽
Docker 拉取提示 UNAUTHORIZED（401）怎么办？
401 认证失败
遇到 429 Too Many Requests（请求太频繁）怎么办？
429 限流
docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？
D-Bus 凭证提示
为什么会出现「单层超过 20GB」或 413，无法加速拉取？
413 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"