coppit/handbrake

docker-handbrake

这是运行HandBrake（一款开源视频编码器）的Docker容器，支持UI交互模式和全自动转码模式。自动模式下，将文件放入监控目录即可触发编码，结果保存至输出目录；UI模式可通过Web或RDP访问手动操作。该镜像已在Docker Hub发布。

核心功能

1. 交互式UI：通过Web浏览器（8080端口）或RDP客户端（3389端口）访问HandBrake界面，手动设置转码参数
2. 自动转码：监控指定目录，对新增文件自动执行转码并输出到目标路径
3. 灵活配置：通过配置文件或环境变量调整转码规则、监控频率等参数
4. 资源优化：支持添加SYS_NICE权限降低转码进程优先级，减少系统资源占用

使用场景

• 个人用户转换视频格式（如压缩大文件适配移动设备）
• 批量处理视频文件，自动化完成转码任务
• 家庭媒体中心集成转码功能，统一管理媒体资源

配置说明

首次启动后，配置目录生成HandBrake.conf文件，可编辑调整监控规则和转码设置；也可通过环境变量（-e参数）配置，优先级高于配置文件。注意避免监控目录与输出目录重叠。USE_UI设置控制UI功能：启用时空闲内存约266MB，禁用时约31MB，CPU占用同步降低。

部署示例

交互式模式（UI访问）

bash
docker run --name=HandBrakeUI -e WIDTH=1280 -e HEIGHT=720 -p 3389:3389 -p 8080:8080 -v /本地电影路径:/media:rw -v /本地配置路径:/config:rw coppit/handbrake

通过Web浏览器访问http://主机IP:8080/#/client/c/HandBrake，或用RDP客户端连接主机3389端口。

非交互式模式（自动转码）

bash
docker run --name=HandBrakeCLI --cap-add=SYS_NICE -v /本地监控路径:/watch:ro -v /本地输出路径:/output:rw -v /本地配置路径:/config:rw coppit/handbrake

将文件放入监控目录，容器自动转码并保存到输出目录。

混合模式（同时支持UI和自动转码）

bash
docker run --name=HandBrake -e WIDTH=1280 -e HEIGHT=720 -p 3389:3389 -p 8080:8080 --cap-add=SYS_NICE -v /本地监控路径:/watch:ro -v /本地输出路径:/output:rw -v /本地电影路径:/media:rw -v /本地配置路径:/config:rw coppit/handbrake

credits

该容器最初基于sparklyballs/handbrake容器开发。