热门搜索:
jlesage/baseimage-gui
自动构建
jlesage
用于简化X图形应用容器创建的最小化Docker基础镜像
116 次收藏下载次数: 0状态：自动构建维护者：jlesage仓库类型：镜像最近更新：10 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
用于简化X图形应用容器创建的最小Docker基础镜像
![Donate]([***]
镜像概述和主要用途
本Docker基础镜像是一个最小化构建的基础镜像，旨在简化X图形应用容器的创建过程。它允许在无头服务器（无本地显示器的服务器）上运行任何X图形应用，并通过现代Web浏览器（客户端无需额外安装或配置）或任何VNC客户端访问应用的图形界面（GUI）。
核心功能和特性
- 多发行版支持：提供基于Alpine、Debian和Ubuntu等多种Linux发行版的基础镜像，满足不同应用的依赖需求。
- 完整的图形栈：集成TigerVNC（带VNC服务器的X服务器）、Openbox（轻量级窗口管理器）和noVNC（HTML5 VNC客户端），实现图形界面的渲染和远程访问。
- Web访问能力：通过NGINX高性能HTTP服务器提供Web访问入口，无需安装VNC客户端即可通过浏览器访问应用GUI。
- 容器化优化：包含初始化系统、进程管理器（具备PID 1功能，如进程回收），以及简化容器创建的工具，环境经过优化以适应Docker应用场景。
- 语义化版本控制：遵循语义化版本规范，版本格式为
MAJOR.MINOR.PATCH，确保版本变更的兼容性管理。
使用场景和适用范围
- 无头服务器图形应用部署：在无本地显示器的服务器（如云服务器、NAS设备）上运行需要图形界面的应用。
- 跨平台远程访问：通过Web浏览器或VNC客户端，在任何设备（PC、平板、手机）上远程访问服务器上的图形应用。
- 开发与测试环境：为需要图形界面的应用提供标准化、隔离的容器化运行环境。
- 轻量级图形工具容器化：将单功能图形工具（如文本编辑器、图像处理工具）打包为容器，简化部署和维护。
镜像版本信息
可用基础镜像
本基础镜像提供多种Linux发行版版本，具体如下表所示：
| 基础发行版 | Docker镜像基础标签 | 大小 |
|---|---|---|
| Alpine 3.16 | alpine-3.16 | |
| Alpine 3.17 | alpine-3.17 | |
| Alpine 3.18 | alpine-3.18 | |
| Alpine 3.19 | alpine-3.19 | |
| Alpine 3.20 | alpine-3.20 | |
| Alpine 3.21 | alpine-3.21 | |
| Alpine 3.22 | alpine-3.22 | |
| Debian 10 | debian-10 | |
| Debian 11 | debian-11 | |
| Ubuntu 16.04 LTS | ubuntu-16.04 | |
| Ubuntu 18.04 LTS | ubuntu-18.04 | |
| Ubuntu 20.04 LTS | ubuntu-20.04 | |
| Ubuntu 22.04 LTS | ubuntu-22.04 |
标签命名规则
Docker镜像标签遵循以下命名规则：
| 标签格式 | 描述 |
|---|---|
| distro-vX.Y.Z | 镜像的精确版本（如alpine-3.19-v4.2.1）。 |
| distro-vX.Y | 特定次要版本的最新版本（如alpine-3.19-v4.2表示v4.2系列的最新补丁版本）。 |
| distro-vX | 特定主要版本的最新版本（如alpine-3.19-v4表示v4系列的最新次要版本）。 |
所有标签可在https://hub.docker.com/r/jlesage/baseimage-gui/tags%E6%9F%A5%E7%9C%8B%EF%BC%8C%E7%89%88%E6%9C%AC%E8%AF%A6%E6%83%85%E5%8F%AF%E5%8F%82%E8%80%83https://github.com/jlesage/docker-baseimage-gui/releases%E9%A1%B5%E9%9D%A2%E3%80%82
使用方法和配置说明
前提条件
- 已安装Docker Engine（20.10+推荐）。
- 基本的Dockerfile编写和容器构建知识。
构建应用容器的步骤
使用本基础镜像创建应用容器需至少包含三个组件：安装应用及其依赖的指令、应用启动脚本（路径为容器内/startapp.sh）、应用名称配置。以下以xterm终端为例，演示完整流程。
1. 创建Dockerfile
dockerfile# 拉取基础镜像（以Alpine 3.19为例） FROM jlesage/baseimage-gui:alpine-3.19-v4 # 安装应用（此处为xterm）及其依赖 RUN add-pkg xterm # 复制应用启动脚本到容器内 COPY startapp.sh /startapp.sh # 设置应用名称（将显示在Web界面标题栏） RUN set-cont-env APP_NAME "Xterm"
2. 创建应用启动脚本
创建startapp.sh文件，内容为启动应用的命令：
shell#!/bin/sh exec /usr/bin/xterm
赋予脚本可执行权限：
shellchmod +x startapp.sh
3. 构建镜像
在包含Dockerfile和startapp.sh的目录下执行构建命令：
shelldocker build -t docker-xterm .
4. 运行容器
启动容器并映射Web访问端口（5800）和VNC端口（5900）：
shelldocker run --rm -p 5800:5800 -p 5900:5900 docker-xterm
-p 5800:5800：映射Web访问端口，用于通过浏览器访问GUI。-p 5900:5900：映射VNC端口，用于通过VNC客户端访问GUI。--rm：容器停止后自动删除（可选，用于测试）。
5. 访问应用GUI
- 通过Web浏览器：在浏览器中访问
http://<主机IP地址>:5800（将<主机IP地址>替换为运行容器的服务器IP）。 - 通过VNC客户端：使用VNC客户端连接
<主机IP地址>:5900。
关键配置说明
环境变量
APP_NAME：应用名称，将显示在Web界面的标题栏。通过RUN set-cont-env APP_NAME "应用名称"在Dockerfile中配置。
端口说明
| 端口 | 用途 | 访问方式 |
|---|---|---|
| 5800 | Web访问端口（HTTP） | http://<主机IP>:5800（浏览器） |
| 5900 | VNC访问端口 | VNC客户端连接 <主机IP>:5900 |
完整文档
完整文档可参考 https://github.com/jlesage/docker-baseimage-gui%E3%80%82
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 baseimage-gui 镜像标签
docker pull docker.xuanyuan.run/jlesage/baseimage-gui:<标签>
DockerHub 原生拉取命令
docker pull jlesage/baseimage-gui:<标签>
更多 baseimage-gui 镜像推荐
jlesage/baseimage
jlesage
一个最小化的Docker基础镜像，旨在简化任何长期运行应用的容器创建过程。
10 次收藏10万+ 次下载
10 天前更新
hyperledger/fabric-baseimage
hyperledger
作为Hyperledger Fabric工作流的基础镜像，用于链码编译/执行、单元测试及集群模拟，基于Ubuntu并集成Golang、RocksDB、gRPC、Node.js等开源项目，Hyperledger Fabric实际代码在部署前即时注入。
51 次收藏100万+ 次下载
5 年前更新
phusion/baseimage
phusion
Ubuntu基础镜像的优化版本，针对Docker环境进行适配，解决了PID 1僵尸进程回收问题及其他容器化场景下的系统配置难题
1.6千 次收藏1000万+ 次下载
2 天前更新
better/baseimage
better
提供Alpine、Node Alpine等基础Docker镜像，包含常用库、Python环境、SSL证书等，支持构建应用程序和数据分析场景。
50万+ 次下载
6 年前更新
springcloud/baseimage
springcloud
Spring Cloud Data Flow、Spring Cloud Skipper、流应用及任务的基础Docker镜像，提供统一的运行环境。
3 次收藏10万+ 次下载
3 年前更新
grow/baseimage
grow
[DEPRECATED] Use grow/base instead.
1 次收藏10万+ 次下载
6 年前更新
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"