用于简化X图形应用容器创建的最小Docker基础镜像

![Release]([] ![Build Status]([] ![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镜像标签遵循以下命名规则：

所有标签可在Docker Hub查看，版本详情可参考Releases页面。

使用方法和配置说明

前提条件

• 已安装Docker Engine（20.10+推荐）。
• 基本的Dockerfile编写和容器构建知识。

构建应用容器的步骤

使用本基础镜像创建应用容器需至少包含三个组件：安装应用及其依赖的指令、应用启动脚本（路径为容器内/startapp.sh）、应用名称配置。以下以xterm终端为例，演示完整流程。

1. 创建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文件，内容为启动应用的命令：

#!/bin/sh
exec /usr/bin/xterm

赋予脚本可执行权限：

chmod +x startapp.sh

3. 构建镜像

在包含Dockerfile和startapp.sh的目录下执行构建命令：

docker build -t docker-xterm .

4. 运行容器

启动容器并映射Web访问端口（5800）和VNC端口（5900）：

docker 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中配置。

端口说明

完整文档

完整文档可参考 GitHub仓库。