x11docker/xwayland

x11docker/xwayland

镜像概述和主要用途

在Docker容器中运行Xwayland。主机上无需安装X服务器，只需安装weston或kwin_wayland即可。可在X、Wayland环境或tty/控制台中运行。
使用x11docker运行镜像：https://github.com/mviereck/x11docker

构建说明

由于Docker Hub不再提供免费自动构建服务，此镜像可能已过时。建议本地构建，x11docker可通过以下命令完成构建：

bash
x11docker --build x11docker/xwayland

使用示例

基本运行

bash
x11docker --wayland --weston --gpu x11docker/xwayland

运行不带窗口管理器的Xwayland

bash
x11docker --wayland --weston --gpu x11docker/xwayland sleep infinity

自定义窗口管理器或桌面环境

以下示例在容器中运行X服务器（Xwayland）和fvwm窗口管理器。可通过调整Dockerfile添加所需的窗口管理器或桌面环境，或基于x11docker/xwayland创建新镜像：

dockerfile
# 在Xwayland上运行afterstep窗口管理器
FROM docker.xuanyuan.run/x11docker/xwayland
RUN apt-get update
RUN apt-get install -y --no-install-recommends afterstep
CMD afterstep

配置选项

• --home：在主机上存储持久化主目录
• --share DIR：共享主机目录
• --gpu：启用硬件加速
• --clipboard：启用剪贴板共享
• --alsa：启用声音支持
• --pulseaudio：若镜像中包含pulseaudio，启用声音支持
• --lang [=$LANG]：设置语言区域

更多选项请查看x11docker --help。

在容器化X服务器上运行主机应用

可在Docker中的Xwayland上运行主机应用：

bash
mkdir /tmp/.X11-unix && chmod 1777 /tmp/.X11-unix   # 确保目录存在
read Xenv < <(x11docker --wayland --gpu --share /tmp/.X11-unix x11docker/xwayland)
env $Xenv libreoffice

注意：主机上的/tmp/.X11-unix目录必须存在且权限为1777。

Xenv包含Xwayland的DISPLAY变量，可通过--display N指定自定义显示编号。

集成主机应用启动器

可运行面板或启动器以访问所有主机应用。launchy 提供较好的集成，可在容器桌面创建托盘图标或通过<CRTL><space>调用。

安全警告

--sharedir /tmp/.X11-unix会共享主机X unix socket。若主机X通过xhost允许访问（检查xhost输出），容器应用可能滥用此权限进行键盘记录等***操作。

解决方案

使用x11docker的--clean-xhost选项移除主机X的xhost认证，主机应用将使用XAUTHORITY中的cookie，容器应用无法访问。

单行命令示例

使用--display和--clean-xhost选项，并延迟运行主机的launchy：

bash
x11docker --display 50 \
    --clean-xhost \
    --runfromhost 'sleep 3 && DISPLAY=:50 launchy &' \
    --share /tmp/.X11-unix \
    --wayland \
    --weston \
    --gpu \
    x11docker/xwayland

截图

在Docker容器中运行Xwayland，包含fvwm窗口管理器和主机的launchy：

!https://raw.githubusercontent.com/mviereck/x11docker/screenshots/screenshot-xwayland.png "在Weston Wayland窗口中运行fvwm桌面的Docker Xwayland"