什么是 HandBrake ？
HandBrake是一款适用于
Linux、
Mac和
Windows的开源视频转码器。
HandBrake可以处理大多数常见的视频文件和格式，包括消费者和专业摄像机创建的文件、手机和平板电脑等移动设备的文件、游戏和计算机屏幕录制的文件，以及
DVD和蓝光光盘的文件。
HandBrake利用
FFmpeg、
x264和
x265等工具从这些源文件创建新的
MP4或
MKV视频文件。
什么是 docker-handbrake ?
docker-handbrake实现了一个用于
HandBrake的
Docker容器。应用程序的图形用户界面可以通过现代的
Web浏览器访问（客户端无需安装或配置），也可以通过任何
VNC客户端进行访问。还提供了完全自动化模式：将文件放入监视文件夹中，让
HandBrake在没有任何用户交互的情况下处理它们。
安装
在群晖上以 Docker 方式安装。
在注册表中搜索
handbrake
，选择第一个
jlesage/handbrake
，版本选择
latest
。
本文写作时，
latest版本对应为
v24.01.2；
卷
在
docker
文件夹中，创建一个新文件夹
handbrake
，并在其中建四个子文件夹
config
、
output
、
storage
和
watch
文件夹装载路径说明
docker/handbrake/config
/config
存储其配置、状态、日志和任何需要持久性的文件
docker/handbrake/output
/output
存储转换后的视频文件
docker/handbrake/watch
/watch
存储需要转换的视频文件
docker/handbrake/storage
/storage
包含需要应用程序访问的主机文件
端口
本地端口不冲突就行，不确定的话可以用命令查一下
# 查看端口占用netstat-tunlp|grep 端口号
本地端口容器端口
5803
5800
默认暴露了
2
个端口，其中
5900
是
VNC
连接端口
如果没有
VNC
客户端的话，可以删掉
环境
可变值
LANG
默认值为
en_US.UTF-8
，改设为
zh_CN.UTF-8
TZ
默认值为
Etc/UTC
，改设为
Asia/Shanghai
更多的变量参数及功能介绍，请参考官方文档：https://github.com/jlesage/docker-handbrake#environment-variables
命令行安装
如果你熟悉命令行，可能用
docker cli
更快捷
如果你的设备支持
Intel Quicksync (QSV)，可以增加一行
--device /dev/dri开启硬件加速编码
# 新建文件夹 handbrake 和 子目录mkdir-p /volume1/docker/handbrake/{config,output,storage,watch}# 进入 handbrake 目录cd /volume1/docker/handbrake
# 运行容器docker run -d\--restart unless-stopped \--name handbrake \-p5803:5800 \-v$(pwd)/config:/config:rw \-v$(pwd)/output:/output:rw \-v$(pwd)/storage:/storage:ro \-v$(pwd)/watch:/watch:rw \
jlesage/handbrake
也可以用
docker-compose
安装，将下面的内容保存为
docker-compose.yml
文件
version:'3'services:handbrake:image: jlesage/handbrake
container_name: handbrake
restart: unless-stopped
ports:- 5803:5800volumes:- ./config:/config:rw
- ./output:/output:rw \
- ./storage:/storage:ro \
- ./watch:/watch:rw \
然后执行下面的命令
# 新建文件夹 handbrake 和 子目录mkdir-p /volume1/docker/handbrake/{config,output,storage,watch}# 进入 handbrake 目录cd /volume1/docker/handbrake
# 将 docker-compose.yml 放入当前目录# 一键启动docker-compose up -d
运行
在浏览器中输入
http://群晖IP:5803
就能看到主界面
中文界面
如果你配置了环境变量
LANG
为
zh_CN.UTF-8
，看到册主界面是👇这样的
这应该是容器里没有中文字体导致的，在网上搜索
Songti.ttc
，将下载的字体文件放到
handbrake
目录
Songti.ttc下载地址：Songti.ttc（https://portrait.gitee.com/ishelo/QQZoneMood/blob/master/Songti.ttc）
将字体放到容器内即可
# 从群晖拷贝到容器内dockercp ./Songti.ttc handbrake:/usr/share/fonts/
## --- 以下几步为验证，可以不需要执行 --- ### 进入容器内dockerexec-it--user root handbrake /bin/bash
# 扫描字体目录并生成字体信息的缓存
fc-cache -vf# 查看系统内所有中文字体及字体文件的路径
fc-list :lang=zh
必须要重启一次容器
原来的小方框已经可以正常显示了
转码本身是比较耗性能的，如果能使用硬件编解码会有效的降低
CPU
的占用，从官方说明看，
HandBrake
支持
Intel Quick Sync Video
，只需要将设备
/dev/dri
暴露在容器中即可。在大多数情况下，
HandBrake
是可以成功访问
/dev/dri
设备的
软件的使用，说简单也简单，说复杂也复杂，不过好在是中文界面，而且网上能找到使用教程，所以这里就不赘述了。
参考文档
HandBrake/HandBrake: HandBrake’s main development repository
地址：https://github.com/HandBrake/HandBrake
HandBrake: Open Source Video Transcoder
地址：https://handbrake.fr/
jlesage/docker-handbrake: Docker container for HandBrake
地址：https://github.com/jlesage/docker-handbrake
版权归原作者 杨浦老苏 所有， 如有侵权，请联系我们删除。