willprice/nvidia-ffmpeg

NVIDIA加速FFmpeg镜像

镜像概述

本镜像集成了NVIDIA硬件加速功能的FFmpeg工具，利用NVIDIA Video Codec SDK提供的NVENC（编码加速）和NVDECODE（解码加速）能力，实现高效的音视频编解码处理。镜像包含多种主流音视频编解码器，适用于需要高性能音视频处理的场景。

核心功能

• 硬件加速支持：集成NVENC（编码）和NVDECODE（解码）加速能力，大幅提升编解码效率
• 编解码器支持：
  • 视频编解码器：x264、x265
  • 音频编解码器：AAC
• 硬件加速编码器：h264_nvenc、nvenc、nvenc_h264、nvenc_hevc、hevc_nvenc
• 硬件加速解码器：h264_cuvid、hevc_cuvid、mjpeg_cuvid、mpeg1_cuvid、mpeg2_cuvid、mpeg4_cuvid、vc1_cuvid、vp8_cuvid、vp9_cuvid
• 硬件加速过滤器：hwupload_cuda、scale_cuda、scale_npp、thumbnail_cuda

使用场景

• 批量音视频转码（如MP4转MKV、高清视频压缩）
• 直播流实时编码/解码处理
• 视频监控系统的视频流分析与转码
• 需要高性能编解码的多媒体应用开发与测试

配置说明与部署示例

基础使用（无硬件加速）

将当前目录挂载到容器的/workspace，处理input.mp4生成output.avi：

bash
docker run --rm -it --runtime=nvidia \
    --volume $PWD:/workspace \
    docker.xuanyuan.run/willprice/nvidia-ffmpeg -i input.mp4 output.avi

硬件加速转码

使用NVDECODE解码和NVENC编码，将input.mp4转码为HEVC格式的out.mkv：

bash
docker run --rm -it --runtime=nvidia \
    --volume $PWD:/workspace \
    docker.xuanyuan.run/willprice/nvidia-ffmpeg \
      -hwaccel_device 0 \
      -hwaccel cuvid \
      -c:v h264_cuvid \
      -i input.mp4 \
      -c:v hevc_nvenc out.mkv

进入容器调试

获取容器内的Shell终端，用于调试：

bash
docker run --rm -it --runtime=nvidia \
    --volume $PWD:/workspace \
    --entrypoint bash docker.xuanyuan.run/willprice/nvidia-ffmpeg

构建说明

镜像采用多阶段构建：第一阶段（构建阶段）编译静态链接的FFmpeg二进制文件，第二阶段（运行阶段）仅复制该二进制文件，减少依赖并缩小镜像体积。

参考资源

• https://trac.ffmpeg.org/wiki/HWAccelIntro
• https://gist.github.com/jniltinho/9c009e9771651aa4a004ad3d1f6857e3
• https://gist.github.com/Brainiarc7/18fca697891aea0e879f13ed092cb213
• https://gist.github.com/Brainiarc7/c6164520f082c27ae7bbea9556d4a3ba
• https://gist.github.com/Brainiarc7/8b471ff91319483cdb725f615908286e
• https://gist.github.com/Brainiarc7/ebf3091efd2bf0a0ded0f9715cd43a38
• https://github.com/zimbatm/ffmpeg-static