NVIDIA OpenGL 镜像文档

镜像概述与主要用途

本镜像为NVIDIA提供的OpenGL容器镜像，基于libglvnd实现，用于支持OpenGL应用程序的运行与开发。镜像需配合nvidia-docker 2.0使用，不正式支持X11、Wayland等显示系统，GPU隔离功能要求NVIDIA驱动版本390及以上。

核心功能与特性

• 基于libglvnd：采用NVIDIA/libglvnd实现OpenGL API调用的正确分发
• 多场景适配：提供三种类型镜像，满足不同使用需求
• 跨系统支持：覆盖Ubuntu 16.04/18.04/20.04及CentOS 7/8等主流操作系统版本
• 版本化管理：通过标签区分不同版本与功能，便于版本控制

最终用户许可协议

使用本镜像即表示您接受以下NVIDIA最终用户许可协议的条款与条件：

• 镜像受NVIDIA最终用户许可协议约束
• 包含的开源组件（如GPL许可组件）源码可通过此处获取
• NVIDIA深度学***容器许可协议详见此处

标签说明

OpenGL镜像分为三种类型：

• base：适用于不使用libglvnd的 legacy NVIDIA驱动环境
• <version>-glvnd-runtime：使用libglvnd分发OpenGL API调用至NVIDIA库，适用于运行预构建的OpenGL应用程序
• <version>-glvnd-devel：在glvnd-runtime镜像基础上扩展，包含***Khronos头文件，适用于从源码编译OpenGL应用程序

支持的操作系统与标签列表

Ubuntu 20.04

• base, base-ubuntu20.04 (base/Dockerfile)
• 1.0-glvnd-runtime, 1.0-glvnd-runtime-ubuntu20.04 (glvnd/runtime/Dockerfile)
• 1.0-glvnd-devel, 1.0-glvnd-devel-ubuntu20.04 (glvnd/devel/Dockerfile)
• 1.1-glvnd-runtime, 1.1-glvnd-runtime-ubuntu20.04 (glvnd/runtime/Dockerfile)
• 1.1-glvnd-devel, 1.1-glvnd-devel-ubuntu20.04 (glvnd/devel/Dockerfile)
• 1.2-glvnd-runtime, 1.2-glvnd-runtime-ubuntu20.04 (glvnd/runtime/Dockerfile)
• 1.2-glvnd-devel, 1.2-glvnd-devel-ubuntu20.04 (glvnd/devel/Dockerfile)

Ubuntu 18.04

• base-ubuntu18.04 (base/Dockerfile)
• 1.0-glvnd-runtime-ubuntu18.04 (glvnd/runtime/Dockerfile)
• 1.0-glvnd-devel-ubuntu18.04 (glvnd/devel/Dockerfile)
• 1.1-glvnd-runtime-ubuntu18.04 (glvnd/runtime/Dockerfile)
• 1.1-glvnd-devel-ubuntu18.04 (glvnd/devel/Dockerfile)
• 1.2-glvnd-runtime-ubuntu18.04 (glvnd/runtime/Dockerfile)
• 1.2-glvnd-devel-ubuntu18.04 (glvnd/devel/Dockerfile)

Ubuntu 16.04

• base-ubuntu16.04 (base/Dockerfile)
• 1.0-glvnd-runtime-ubuntu16.04 (glvnd/runtime/Dockerfile)
• 1.0-glvnd-devel-ubuntu16.04 (glvnd/devel/Dockerfile)
• 1.1-glvnd-runtime-ubuntu16.04 (glvnd/runtime/Dockerfile)
• 1.1-glvnd-devel-ubuntu16.04 (glvnd/devel/Dockerfile)
• 1.2-glvnd-runtime-ubuntu16.04 (glvnd/runtime/Dockerfile)
• 1.2-glvnd-devel-ubuntu16.04 (glvnd/devel/Dockerfile)

CentOS 8

警告：可能缺少镜像标签
CentOS 7和8的opengl镜像标签在NGC和Docker Hub上可能缺失或过时。CentOS上游镜像常因安全扫描未通过（NVIDIA发布前要求）导致无法发布。请访问此处查看安全公告。

• base-centos8 (base/Dockerfile)
• 1.0-glvnd-runtime-centos8 (glvnd/runtime/Dockerfile)
• 1.0-glvnd-devel-centos8 (glvnd/devel/Dockerfile)
• 1.1-glvnd-runtime-centos8 (glvnd/runtime/Dockerfile)
• 1.1-glvnd-devel-centos8 (glvnd/devel/Dockerfile)
• 1.2-glvnd-runtime-centos8 (glvnd/runtime/Dockerfile)
• 1.2-glvnd-devel-centos8 (glvnd/devel/Dockerfile)

CentOS 7

警告：可能缺少镜像标签
CentOS 7和8的opengl镜像标签在NGC和Docker Hub上可能缺失或过时。CentOS上游镜像常因安全扫描未通过（NVIDIA发布前要求）导致无法发布。请访问此处查看安全公告。

• base-centos7 (base/Dockerfile)
• 1.0-glvnd-runtime-centos7 (glvnd/runtime/Dockerfile)
• 1.0-glvnd-devel-centos7 (glvnd/devel/Dockerfile)
• 1.1-glvnd-runtime-centos7 (glvnd/runtime/Dockerfile)
• 1.1-glvnd-devel-centos7 (glvnd/devel/Dockerfile)
• 1.2-glvnd-runtime-centos7 (glvnd/runtime/Dockerfile)
• 1.2-glvnd-devel-centos7 (glvnd/devel/Dockerfile)

使用场景与适用范围

• 运行预构建OpenGL应用：选择<version>-glvnd-runtime标签镜像
• 编译OpenGL应用源码：选择<version>-glvnd-devel标签镜像（含Khronos头文件）
• 旧版NVIDIA驱动环境：选择base标签镜像（适用于不支持libglvnd的驱动）

使用方法与配置说明

前提条件

• 安装nvidia-docker 2.0
• 部署NVIDIA GPU驱动版本390及以上

示例参考

示例Dockerfile可参考NVIDIA samples

基本使用流程

1. 拉取镜像

   bash
   docker pull nvidia/opengl:<tag>
   

   （将<tag>替换为具体标签，如1.2-glvnd-runtime-ubuntu20.04）

2. 运行容器
   使用nvidia运行时启动容器，示例：

   bash
   nvidia-docker run --rm nvidia/opengl:<tag> glxinfo | grep "OpenGL version"
   

3. 开发编译
   基于glvnd-devel镜像构建应用时，可直接使用Khronos头文件进行编译。