在Docker容器中运行Unity3D Vulkan应用的技术求助

问题背景 #

• 需部署Unity HDRP开发的应用到Docker容器，渲染视频流推送到Web服务器
• 已在桌面Linux上验证过Linux构建版本，Linux环境下HDRP仅支持Vulkan渲染
• 具备Docker基础操作能力（创建/运行容器、搭建Web服务器）

当前配置 #

使用的Dockerfile：

FROM ubuntu:bionic

RUN apt-get update && \
    apt-get install -y libglu1 xvfb libxcursor1

WORKDIR /app
COPY build/ /app
COPY entrypoint.sh /app

CMD [ "/bin/bash", "/app/entrypoint.sh" ]
EXPOSE 80

问题现象 #

• 镜像可运行，但Unity使用"null"GPU，无法正常渲染图形
• 尝试过andrewmackrodt/ubuntu-x11基础镜像，未得到有效图形输出
• 了解Nvidia容器工具包但未配置成功，不确定是否适用于游戏引擎渲染

解决方案 #

一、使用Nvidia容器工具包实现硬件加速Vulkan渲染 #

Unity HDRP需要真实GPU的硬件加速，虚拟显卡无法满足需求，Nvidia容器工具包可让容器直接访问宿主机GPU，支持Vulkan渲染。

1. 宿主机前置条件

• 宿主机为带Nvidia显卡的Linux系统
• 已安装对应版本的Nvidia驱动（建议最新稳定版）

2. 安装Nvidia容器工具包

# 添加Nvidia软件源
distribution=$(. /etc/os-release;echo $ID$VERSION_ID)
curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add -
curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list

# 安装工具包并重启Docker服务
sudo apt-get update && sudo apt-get install -y nvidia-docker2
sudo systemctl restart docker

3. 修改Dockerfile

使用支持Nvidia的基础镜像，并安装Vulkan相关依赖：

FROM nvidia/cuda:11.8.0-runtime-ubuntu18.04

# 安装Unity Vulkan及X11依赖
RUN apt-get update && \
    apt-get install -y --no-install-recommends \
        libglu1-mesa \
        xvfb \
        libxcursor1 \
        vulkan-utils \
        libvulkan1 \
        mesa-vulkan-drivers && \
    rm -rf /var/lib/apt/lists/*

# 指定Vulkan ICD配置文件
ENV VK_ICD_FILENAMES=/usr/share/vulkan/icd.d/nvidia_icd.json

WORKDIR /app
COPY build/ /app
COPY entrypoint.sh /app

CMD [ "/bin/bash", "/app/entrypoint.sh" ]
EXPOSE 80

4. 运行容器

• 若宿主机有桌面环境，直接映射X11套接字：

docker run --gpus all -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix -p 80:80 your-image-tag

• 若服务器无桌面环境，修改entrypoint.sh用Xvfb创建虚拟显示：

#!/bin/bash
# 启动虚拟X服务器
Xvfb :1 -screen 0 1920x1080x24 &
export DISPLAY=:1
# 强制Unity使用Vulkan渲染
./YourUnityApp -force-vulkan

二、验证Vulkan环境 #

在容器内执行vulkaninfo命令，若输出中能识别到Nvidia GPU信息，说明Vulkan环境配置正常。

三、常见排查点 #

• 版本兼容：确保宿主机Nvidia驱动版本与容器内CUDA版本兼容
• Unity启动参数：添加-force-vulkan强制Unity使用Vulkan渲染后端
• 权限问题：临时添加--privileged参数运行容器测试，排查权限限制
• 构建配置：确认Unity Linux版本构建时已勾选Vulkan选项，HDRP配置未禁用硬件加速

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