gennyproject/video-converter

视频转换Docker镜像文档

1. 镜像概述

本Docker镜像提供了一个便捷的视频格式转换解决方案，集成了主流视频处理工具，可快速实现不同视频格式间的转换。镜像设计轻量高效，无需在主机环境安装复杂的视频处理依赖，通过容器化方式简化视频格式转换流程，适用于需要灵活处理视频文件的场景。

2. 核心功能与特性

• 多格式支持：兼容MP4、AVI、MKV、FLV、WMV等常见视频格式的相互转换
• 编解码器集成：内置H.264、H.265、MPEG-4等主流编解码器，满足不同画质需求
• 批量处理能力：支持批量导入多个视频文件并统一转换格式
• 轻量级设计：基于精简基础镜像构建，镜像体积小，资源占用低
• 灵活配置：可通过参数自定义转换质量、分辨率、帧率等输出属性

3. 使用场景

• 个人用户视频格式转换（如手机拍摄视频转电脑播放格式）
• 小型媒体服务器视频预处理
• 开发环境中视频格式兼容性测试
• 自媒体创作者的视频素材格式统一处理

4. 使用方法

4.1 基本使用（docker run）

通过挂载本地目录实现视频文件的输入与输出：

bash
docker run -it --rm \
  -v /本地输入目录:/input \
  -v /本地输出目录:/output \
  video-converter \
  -i /input/source.mp4 -o /output/target.mkv

参数说明：

• -v /本地输入目录:/input：挂载本地视频源文件目录到容器内/input
• -v /本地输出目录:/output：挂载本地输出目录到容器内/output
• -i：指定输入视频文件路径（容器内路径）
• -o：指定输出视频文件路径（容器内路径）

4.2 批量转换示例

对目录下所有视频文件进行批量转换（以转换为MP4格式为例）：

bash
docker run -it --rm \
  -v /本地视频目录:/videos \
  video-converter \
  batch-convert /videos/*.mkv /videos/output/mp4

4.3 自定义转换参数

通过添加额外参数调整输出视频质量：

bash
docker run -it --rm \
  -v /input:/input -v /output:/output \
  video-converter \
  -i /input/large_video.avi \
  -o /output/compressed.mp4 \
  -c:v libx264 -crf 23 -preset medium

常用自定义参数：

• -c:v：指定视频编码器（如libx264、libx265）
• -crf：设置视频质量（值范围0-51，越低质量越高，推荐23-28）
• -preset：设置编码速度与压缩率平衡（ultrafast至veryslow）
• -s：指定输出分辨率（如1920x1080）

5. 注意事项

• 转换过程依赖主机CPU性能，复杂转换任务建议在性能较好的设备上运行
• 确保挂载目录有读写权限，避免因权限问题导致文件处理失败
• 对于大文件转换，建议通过-v挂载本地目录而非容器内存储，以提高效率