热门搜索:
linuxserver/handbrake
linuxserver/handbrake是基于开源视频转换工具HandBrake的Docker镜像，用于将视频从几乎任何格式转换为现代、广泛支持的编解码器，提供便捷的容器化部署方案。
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
linuxserver/handbrake 镜像文档
镜像概述和主要用途
HandBrake是由志愿者开发的开源视频转换工具，支持将视频从几乎任何格式转换为现代、广泛支持的编解码器。linuxserver/handbrake镜像提供了HandBrake的容器化部署方案，简化了安装配置流程，适合需要便捷进行视频格式转换的用户。
核心功能和特性
- 开源工具：基于HandBrake开源项目，免费使用且持续更新
- 多格式支持：兼容几乎所有输入视频格式，可转换为现代编解码器
- 容器化部署：通过Docker容器运行，环境隔离，配置迁移便捷
- 灵活配置：支持自定义用户ID、组ID、时区等参数，适应不同使用环境
使用场景和适用范围
- 个人用户：需要转换视频格式以适配手机、平板、智能电视等设备
- 开发者/管理员：在服务器或工作站部署视频转换服务，处理批量视频文件
- 内容创作者：将原始视频素材转换为适合在线分享或存储的格式
使用方法和配置说明
应用访问
部署后可通过以下地址访问应用：
https://yourhost:3001/（将yourhost替换为实际主机IP或域名）
Docker运行示例
bashdocker 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 | 容器重启策略，除非手动停止，否则容器退出时自动重启 |
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 handbrake 镜像标签
docker pull docker.xuanyuan.run/linuxserver/handbrake:<标签>
DockerHub 原生拉取命令
docker pull linuxserver/handbrake:<标签>
更多 handbrake 镜像推荐
jlesage/handbrake
jlesage
这是一个用于HandBrake的Docker容器，其中HandBrake是一款开源视频转码工具，支持将DVD、蓝光及各类视频文件转换为MP4、MKV等主流格式，而Docker容器通过环境隔离特性确保转码环境稳定一致，无需复杂配置即可快速部署运行，适用于个人媒体处理、家庭服务器及企业级视频转码场景，帮助用户高效完成视频格式转换与压缩任务。
221 次收藏1000万+ 次下载
9 天前更新
coppit/handbrake
coppit
提供HandBrake的交互式UI（Web/RDP访问）和非交互式自动视频编码功能，支持监控目录自动转码文件，可灵活配置转码参数。
12 次收藏50万+ 次下载
7 年前更新
tianon/handbrake
tianon
HandBrake视频转码工具的Docker镜像，从官方PPA (ppa:stebbins/handbrake-releases)安装，提供命令行界面，用于高效处理各类视频格式的转码任务。
1万+ 次下载
26 天前更新
sparklyballs/handbrake
sparklyballs
暂无描述
3 次收藏10万+ 次下载
9 年前更新
gz1903/handbrake
gz1903
HandBrake汉化版是一款视频格式转换工具，支持将几乎任何视频格式转换为现代广泛支持的编解码器，提供Web GUI界面，可通过Docker便捷部署，适用于个人或家庭视频转换需求。
63 次收藏1万+ 次下载
10 个月前更新
rcarmo/handbrake
rcarmo
暂无描述
10万+ 次下载
4 年前更新
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"