x11docker/xserver

x11docker/xserver 镜像文档

镜像概述

该Docker镜像提供了一组可被https://github.com/mviereck/x11docker%E4%BD%BF%E7%94%A8%E7%9A%84X%E6%9C%8D%E5%8A%A1%E5%99%A8%E3%80%82%E7%94%9F%E6%88%90%E7%9A%84%E9%95%9C%E5%83%8F%60x11docker/xserver%60%E5%8F%AF%E8%87%AA%E5%8A%A8%E5%9C%A8%E5%AE%B9%E5%99%A8%E4%B8%AD%E8%BF%90%E8%A1%8C%E6%94%AF%E6%8C%81%E7%9A%84X%E6%9C%8D%E5%8A%A1%E5%99%A8%EF%BC%8C%E4%BB%8E%E8%80%8C%E5%AE%9E%E7%8E%B0X%E6%9C%8D%E5%8A%A1%E5%99%A8%E4%B8%8E%E4%B8%BB%E6%9C%BA%E7%9A%84%E9%9A%94%E7%A6%BB%EF%BC%8C%E5%B9%B6%E5%87%8F%E5%B0%91x11docker%E5%AF%B9%E4%B8%BB%E6%9C%BA%E7%9A%84%E4%BE%9D%E8%B5%96%E3%80%82

获取镜像

拉取镜像

使用以下命令从Docker Hub拉取镜像：

bash
docker pull x11docker/xserver

构建镜像

也可使用x11docker自行构建镜像：

bash
x11docker --build x11docker/xserver

注意：构建过程可能需要较长时间，因为nxagent会从源代码构建。

核心功能与特性

包含的X服务器和工具

该镜像集成了多种X服务器、Wayland合成器及相关工具，具体包括：

• X服务器：nxagent、Xephyr、Xorg、Xvfb、Xwayland、xpra
• Wayland合成器：kwin_wayland、weston

核心特性

• 支持x11docker的所有X服务器选项
• 内置工具集，减少x11docker对主机系统的依赖
• 容器化运行X服务器，实现与主机环境的隔离，提升安全性

支持的x11docker选项

原主机选项

使用x11docker/xserver镜像时，支持以下原仅主机可用的x11docker选项：

• --kwin
• --nxagent
• --weston
• --weston-xwayland
• --xephyr
• --xorg
• --xpra
• --xpra-xwayland
• --xvfb
• --xwayland

新选项

依赖x11docker/xserver镜像和主机xpra客户端的新选项：

• --xpra2：在容器中运行X服务器和xpra服务器，主机运行xpra客户端
• --xpra2-xwayland：结合--xpra2与Xwayland功能

--xpra2和--xpra2-xwayland旨在提供安全性与性能的最佳平衡。

使用方法

基本使用

通过x11docker使用该镜像时，无需额外配置，x11docker会自动调用x11docker/xserver运行对应X服务器。示例：

bash
# 使用Xorg服务器运行图形应用
x11docker --xorg --xserver x11docker/xserver <应用镜像>

注：<应用镜像>为需要运行的图形化应用Docker镜像。

GPU支持

开源MESA驱动

镜像内置免费开源的MESA驱动，若主机使用MESA驱动，无需额外配置即可直接使用硬件加速。

NVIDIA驱动

若主机安装闭源NVIDIA驱动，需确保容器内驱动版本与主机一致（仅支持驱动版本≥470.x），可通过以下两种方式配置：

方法一：容器启动时自动安装

在~/.local/share/x11docker目录放置NVIDIA驱动安装文件，x11docker会在x11docker/xserver容器每次启动时自动安装驱动。

注意：此方法会延长容器启动时间。详情参考https://github.com/mviereck/x11docker/wiki/NVIDIA-driver-support-for-docker-container#automated-install-of-nvidia-driver-during-container-startup%E3%80%82

方法二：基于nvidia-base镜像构建

1. 创建x11docker/nvidia-base基础镜像，可使用https://github.com/mviereck/x11docker/wiki/NVIDIA-driver-support-for-docker-container#nvidia-driver-base-image%E6%8F%90%E4%BE%9B%E7%9A%84%E8%84%9A%E6%9C%AC%E3%80%82
2. 修改x11docker/xserver的Dockerfile，将基础镜像从debian:bullseye改为x11docker/nvidia-base，然后构建：

bash
x11docker --build x11docker/xserver

注意：此方法构建的镜像仅与主机NVIDIA驱动版本兼容，不具备可移植性。