无显示器服务器Docker容器中GLFW初始化失败的解决方法问询

我要复用一段依赖GLFW的旧代码，运行环境是无外接显示器的服务器，通过SSH访问并在nvidia docker容器（镜像nvcr.io/nvidia/tensorrt:21.06-py3）中执行。调用脚本时持续抛出异常：

EXCEPTION: GLFW initialization failed.

对应触发异常的代码：

if (glfwInit() != GLFW_TRUE) { 
    throw std::runtime_error("GLFW initialization failed."); 
}

调用glfwGetError(&description)得到具体错误：

X11: Failed to open display unix:0

服务器无默认$DISPLAY值，我尝试过用ssh -X bla@bla开启X11转发连接服务器，手动设置export DISPLAY=:0并共享X11套接字到容器：

docker run --gpus all -e DISPLAY=unix$DISPLAY -it --rm --shm-size 1G  \
        -v /tmp/.X11-unix:/tmp/.x11-unix \
        <image>

但问题未解决。想请教如何让脚本在无SSH连接、无需X11转发的独立环境下运行？是否需要重新编译GLFW或在容器中模拟显示？

方案1：用Xvfb创建虚拟显示（无需修改代码/重新编译GLFW） #

这是最快捷的方案，无需改动现有代码，直接在容器内模拟一个虚拟X11显示环境，满足GLFW的X11依赖要求。

步骤1：在容器内安装Xvfb #

进入容器后执行：

apt update && apt install -y xvfb

步骤2：启动虚拟显示并运行脚本 #

在执行你的业务脚本前，先启动Xvfb并指定DISPLAY环境变量：

# 启动编号为:1的虚拟显示，分辨率设为1920x1080，颜色深度24位
Xvfb :1 -screen 0 1920x1080x24 &
# 将DISPOINT指向这个虚拟显示
export DISPLAY=:1
# 运行你的脚本
./your_script

容器启动时集成（可选） #

如果要在docker run命令中直接完成配置，可修改为：

docker run --gpus all -it --rm --shm-size 1G \
    -e DISPLAY=:1 \
    <image> \
    /bin/bash -c "Xvfb :1 -screen 0 1920x1080x24 & export DISPLAY=:1 && ./your_script"

方案2：重新编译GLFW为无头模式（完全摆脱X11依赖） #

如果你的代码仅需要GLFW的OpenGL上下文管理能力，不需要实际渲染到窗口，可重新编译GLFW启用无头模式，彻底移除X11依赖。

步骤1：在容器内安装编译依赖 #

apt update && apt install -y git cmake build-essential

步骤2：克隆GLFW源码并编译（启用无头模式） #

git clone https://github.com/glfw/glfw.git
cd glfw
mkdir build && cd build
# 配置cmake：禁用X11、Wayland等显示后端，启用无头模式
cmake -DGLFW_BUILD_X11=OFF -DGLFW_BUILD_WAYLAND=OFF -DGLFW_BUILD_HEADLESS=ON ..
# 并行编译并安装
make -j$(nproc)
make install

步骤3：重新编译你的facewarp代码 #

确保你的编译脚本链接新编译的GLFW库，重新编译后即可直接运行，无需设置DISPLAY变量。

注意事项 #

• 若代码需要实际输出OpenGL渲染结果，优先选择Xvfb方案；若仅需GLFW上下文做离线计算，无头模式更轻量高效。
• 容器内用户权限可能影响Xvfb运行，必要时可切换至root用户执行，或确保当前用户拥有虚拟显示资源访问权限。

内容的提问来源于stack exchange，提问作者preciselyv