tianon/handbrake

HandBrake Docker镜像

镜像概述

本镜像包含开源视频转码工具HandBrake，从官方PPA (ppa:stebbins/handbrake-releases)安装，提供命令行版本(handbrake-cli)。容器化部署消除了本地环境依赖，可在任何支持Docker的系统中快速执行视频转码操作，适用于处理多种输入输出格式的视频文件。

核心功能与特性

• 官方源保障：基于HandBrake官方PPA构建，确保软件版本最新且安全可靠
• 多格式支持：兼容主流视频格式输入(MP4、MKV、AVI、FLV等)和输出(H.264/AVC、H.265/HEVC、MPEG-4等)
• 命令行驱动：通过handbrake-cli提供丰富的转码参数控制，支持自定义编码、分辨率、比特率等
• 轻量部署：容器化设计减少系统依赖，启动快速，资源占用可控
• 跨平台运行：可在Linux、Windows、macOS等支持Docker的环境中一致运行

使用场景

• 服务器批量转码：在云服务器或本地服务器中处理用户上传的视频文件，生成适配不同设备的格式
• 自动化工作流：集成到CI/CD或任务调度系统(如Cron、Airflow)，执行定时视频处理任务
• 开发测试环境：快速验证不同转码参数组合的效果，无需修改本地系统配置
• 资源隔离处理：通过容器隔离转码任务，避免与主机系统的依赖冲突

使用方法

基础转码操作

将当前目录下的input.mp4转码为output.mkv，挂载本地目录作为数据卷：

bash
docker run --rm -v "$(pwd):/workdir" tianon/handbrake handbrake-cli -i /workdir/input.mp4 -o /workdir/output.mkv

指定高级转码参数

转码为H.265编码，设置质量参数20，分辨率调整为720p：

bash
docker run --rm -v "$(pwd):/workdir" tianon/handbrake handbrake-cli \
  -i /workdir/input.mp4 \
  -o /workdir/output_h265.mp4 \
  -e x265 \          # 使用H.265编码器
  -q 20 \            # 质量参数(范围0-51，值越小质量越高)
  --width 1280 \     # 设置宽度
  --height 720 \     # 设置高度
  -r 30 \            # 帧率30fps
  -B 192             # 音频比特率192kbps

批量转码示例

使用find命令批量处理目录下所有MP4文件：

bash
find ./source -name "*.mp4" -exec sh -c '
  input="{}"
  output="${input%.mp4}_converted.mkv"
  docker run --rm -v "$(pwd):/workdir" tianon/handbrake handbrake-cli -i "/workdir/$input" -o "/workdir/$output"
' \;

配置参数

数据卷挂载

常用handbrake-cli参数

权限控制

默认以root用户运行，如需调整输出文件权限，可指定本地用户ID：

bash
docker run --rm -u $(id -u):$(id -g) -v "$(pwd):/workdir" tianon/handbrake handbrake-cli -i /workdir/input.mp4 -o /workdir/output.mkv

性能优化建议

• 资源限制：转码为CPU密集型任务，可通过--cpus限制CPU使用：

  bash
  docker run --rm --cpus 2 -v "$(pwd):/workdir" tianon/handbrake handbrake-cli ...
  

• 硬件加速：如主机支持，可挂载GPU设备启用硬件编码(需主机安装对应驱动)：

  bash
  docker run --rm --device /dev/dri -v "$(pwd):/workdir" tianon/handbrake handbrake-cli -i /workdir/input.mp4 -o /workdir/output.mp4 -e nvenc_h265
  

镜像维护

• 获取最新版本：

  bash
  docker pull tianon/handbrake
  

• 查看版本信息：

  bash
  docker run --rm tianon/handbrake handbrake-cli --version
  

详细参数说明可参考HandBrake CLI官方文档