linuxserver/handbrake

linuxserver/handbrake是基于开源视频转换工具HandBrake的Docker镜像，用于将视频从几乎任何格式转换为现代、广泛支持的编解码器，提供便捷的容器化部署方案。

0 次下载activelinuxserver

linuxserver/handbrake 镜像文档

镜像概述和主要用途

HandBrake是由志愿者开发的开源视频转换工具，支持将视频从几乎任何格式转换为现代、广泛支持的编解码器。linuxserver/handbrake镜像提供了HandBrake的容器化部署方案，简化了安装配置流程，适合需要便捷进行视频格式转换的用户。

核心功能和特性

开源工具：基于HandBrake开源项目，免费使用且持续更新
多格式支持：兼容几乎所有输入视频格式，可转换为现代编解码器
容器化部署：通过Docker容器运行，环境隔离，配置迁移便捷
灵活配置：支持自定义用户ID、组ID、时区等参数，适应不同使用环境

使用场景和适用范围

个人用户：需要转换视频格式以适配手机、平板、智能电视等设备
开发者/管理员：在服务器或工作站部署视频转换服务，处理批量视频文件
内容创作者：将原始视频素材转换为适合在线分享或存储的格式

使用方法和配置说明

应用访问

部署后可通过以下地址访问应用：
[***]（将yourhost替换为实际主机IP或域名）

Docker运行示例

bash
docker run -d \
  --name=handbrake \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 3000:3000 \
  -p 3001:3001 \
  -v /path/to/config:/config \
  --shm-size="1gb" \
  --restart unless-stopped \
  lscr.io/linuxserver/handbrake:latest

配置参数说明

参数	说明
`-e PUID=1000`	运行容器的用户ID，建议设为当前用户ID（可通过`id -u`命令查看）以避免权限问题
`-e PGID=1000`	运行容器的组ID，与PUID对应（可通过`id -g`命令查看当前用户组ID）
`-e TZ=Etc/UTC`	容器时区设置，格式为`区域/城市`，如`Asia/Shanghai`表示中国标准时间
`-p 3000:3000`	端口映射，容器内部3000端口映射到主机3000端口
`-p 3001:3001`	Web访问端口映射，容器内部3001端口映射到主机3001端口
`-v /path/to/config:/config`	配置文件存储目录，需将`/path/to/config`替换为本地实际路径
`--shm-size="1gb"`	设置共享内存大小，推荐1GB以保证视频处理性能
`--restart unless-stopped`	容器重启策略，除非手动停止，否则容器退出时自动重启