linuxserver/xvfb

XVFB (DRI3/Glamor补丁版) Docker镜像文档

1. 镜像概述和主要用途

本镜像包含经过补丁的最新版本XVFB（X Virtual Framebuffer）二进制文件，支持DRI3（Direct Rendering Infrastructure v3）和Glamor渲染框架。XVFB是一款在内存中运行的X服务器，无需物理显示设备，可模拟图形显示环境。本镜像旨在为容器化应用提供高性能、无外设依赖的X服务器支持，适用于需要图形环境但无物理显示器的场景。

2. 核心功能和特性

2.1 核心功能

• 提供经过补丁的XVFB二进制文件，修复潜在兼容性问题，确保与现代图形栈兼容。
• 支持DRI3图形加速接口，优化图形渲染性能。
• 集成Glamor渲染框架，提升2D图形渲染效率。

2.2 关键特性

• 多架构支持：同时构建x86_64和aarch64平台镜像，适配不同硬件环境。
• 多发行版兼容：适配多种Linux发行版（如Alpine、Debian、Ubuntu等），满足多样化基础镜像需求。
• 轻量集成：可通过多阶段构建无缝集成到目标应用镜像中，最小化镜像体积。

3. 使用场景和适用范围

3.1 典型使用场景

• 无头服务器环境：在无物理显示器的服务器/容器中运行GUI应用（如桌面软件、图形化工具）。
• CI/CD自动化测试：为图形应用（如GUI程序、Web前端）提供自动化测试环境，无需依赖物理显示设备。
• 服务器端图形渲染：用于生成图像、视频或PDF等需要图形上下文的任务（如报表生成、可视化渲染）。
• 容器化图形应用：为依赖X服务器的容器化应用（如基于Qt、GTK的程序）提供基础图形环境。

3.2 适用范围

• 需在容器内运行X11应用的场景。
• 对图形渲染性能有要求的无头环境。
• 基于Alpine、Debian、Ubuntu等主流Linux发行版的容器化应用。

4. 使用方法和配置说明

4.1 基础集成方式

本镜像需通过多阶段构建集成到目标应用镜像中。以下为Dockerfile示例：

dockerfile
# 从XVFB补丁版镜像获取二进制文件
FROM lscr.io/linuxserver/xvfb:alpine322 AS xvfb

# 基于目标基础镜像构建应用
FROM ghcr.io/linuxserver/baseimage-selkies:alpine322

# 复制XVFB文件到目标镜像
COPY --from=xvfb / /

4.2 说明

• 多阶段构建：通过FROM lscr.io/linuxserver/xvfb:<tag>拉取对应发行版的XVFB镜像作为构建阶段，再通过COPY --from=xvfb / /将XVFB相关文件复制到目标应用镜像中，实现轻量集成。
• 标签选择：需根据目标应用的基础镜像发行版，选择对应标签的XVFB镜像（详见下方"支持的发行版和标签"）。

5. 支持的发行版和标签

本镜像针对多种Linux发行版构建，支持x86_64和aarch64架构。具体发行版与标签对应关系如下：

6. 注意事项

• 本镜像仅包含XVFB核心文件，需与目标应用镜像的基础发行版匹配（如Alpine基础镜像需使用alpine322标签），否则可能出现依赖冲突。
• 若需自定义XVFB配置（如分辨率、显示端口等），可通过启动脚本或环境变量（如XVFB_ARGS）调整，具体参数参考XVFB官方文档。