dustynv/gstreamer

GStreamer Docker镜像文档

镜像概述与主要用途

GStreamer Docker镜像是为NVIDIA Jetson平台优化的多媒体处理框架容器，基于L4T（Linux for Tegra）系统，支持JetPack 4.6及以上版本。该镜像集成了GStreamer多媒体框架及相关依赖库，提供硬件加速的视频处理能力，是构建Jetson平台上多媒体应用、深度学习视频分析系统的基础组件。

核心功能与特性

• 集成GStreamer框架：提供完整的多媒体处理管道，支持视频采集、编码、解码、流转等功能
• 硬件加速支持：结合CUDA、cuDNN实现GPU加速，优化Jetson设备上的媒体处理性能
• 多版本兼容：支持L4T R32.7（JetPack 4.6+）、R35.x（JetPack 5.1+）等多个JetPack版本
• 丰富依赖集成：包含build-essential、Python、NumPy、OpenCV等基础库，简化应用开发
• 基础组件定位：作为DeepStream、jetson-inference、jetson-utils等关键应用的依赖项

依赖与被依赖关系

依赖项

• build-essential：基础构建工具
• cuda：NVIDIA CUDA工具包
• cudnn：CUDA深度神经网络库
• python：Python运行环境
• numpy：数值计算库
• opencv：计算机视觉库

被依赖项

• deepstream：NVIDIA深度学习视频分析SDK
• jetson-inference：Jetson推理库
• jetson-utils：Jetson工具集
• l4t-ml：L4T机器学习镜像
• nanoowl：视觉Transformer应用

镜像标签与兼容性

兼容性说明：

• L4T R32.7容器可运行于其他L4T R32.7版本（JetPack 4.6+）
• L4T R35.x容器可运行于其他L4T R35.x版本（JetPack 5.1+）

使用方法

运行容器

可通过jetson-containers run命令（自动适配版本）或手动docker run命令启动容器：

使用jetson-containers（推荐）

bash
# 自动拉取或构建兼容的容器镜像
jetson-containers run $(autotag gstreamer)

# 或显式指定镜像标签
jetson-containers run dustynv/gstreamer:r36.2.0

使用docker run

bash
sudo docker run --runtime nvidia -it --rm --network=host dustynv/gstreamer:r36.2.0

说明：jetson-containers run会自动添加默认参数（如--runtime nvidia、挂载/data缓存、检测设备），autotag工具会根据当前JetPack版本匹配兼容镜像。

挂载目录

使用-v参数将主机目录挂载到容器内：

bash
jetson-containers run -v /主机目录路径:/容器内路径 $(autotag gstreamer)

运行命令

启动容器时直接执行命令（非交互式shell）：

bash
jetson-containers run $(autotag gstreamer) 应用命令 --参数

构建容器

如需手动构建镜像，先完成https://github.com/dusty-nv/jetson-containers/tree/master/docs/setup.md%EF%BC%8C%E7%84%B6%E5%90%8E%E6%89%A7%E8%A1%8C%EF%BC%9A

bash
jetson-containers build gstreamer

可通过--help查看构建选项：

bash
jetson-containers build gstreamer --help

构建状态

• gstreamer_jp51：
• gstreamer_jp46：
• gstreamer_jp60：

Dockerfile

https://github.com/dusty-nv/jetson-containers/tree/master/packages/gstreamer/Dockerfile