gz1903/handbrake

HandBrake汉化版

镜像概述和主要用途

HandBrake汉化版是基于HandBrake的Docker镜像，用于将视频从几乎任何格式转换为现代、广泛支持的编解码器。该镜像提供Web GUI界面，可通过浏览器访问操作，支持配置持久化、文件自动转换等功能，适合需要便捷视频格式转换的个人或家庭用户。

核心功能和特性

• 视频格式转换：支持几乎所有输入视频格式，转换为MP4、MKV等主流格式
• Web GUI访问：通过浏览器访问图形界面，无需本地安装客户端
• 持久化配置：配置、状态、日志等文件持久化存储，确保设置不丢失
• 自动转换：监控指定目录（watch），自动转换新增视频文件
• 多目录映射：支持配置目录、存储目录、输入目录、输出目录独立映射
• 本地化支持：默认中文界面，支持设置时区和语言环境

使用场景和适用范围

• 个人用户视频格式转换（如将老旧视频转换为现代设备支持的格式）
• 家庭媒体库整理（统一视频格式，节省存储空间）
• 需要便捷部署和管理的视频转换任务
• 无本地安装权限或偏好容器化部署的环境

使用方法和配置说明

Docker Run 部署

使用以下命令启动HandBrake容器：

shell
docker run -d \
    --name=handbrake \
    -p 5800:5800 \
    -v /docker/appdata/handbrake:/config:rw \
    -v /home/user:/storage:ro \
    -v /home/user/HandBrake/watch:/watch:rw \
    -v /home/user/HandBrake/output:/output:rw \
    gz1903/handbrake

Docker Compose 部署

创建docker-compose.yml文件：

yaml
services:
  handbrake:
    image: gz1903/handbrake:latest
    container_name: handbrake
    restart: unless-stopped
    ports:
     - 5800:5800
    volumes:
     - ./config:/config          # 配置文件存储目录
     - ./output:/output          # 转换后视频输出目录
     - ./storage:/storage:ro     # 源视频文件存储目录（只读）
     - ./watch:/watch            # 自动监控转换目录
    environment:
     - LANG=zh_CN.UTF-8          # 设置中文语言环境
     - TZ=Asia/Shanghai          # 设置时区为上海
    devices:
     - /dev/dri:/dev/dri         # 硬件加速支持（可选）

目录说明

• /config：存储应用配置、状态、日志等持久化文件
• /storage：映射主机中的源视频文件目录（只读），容器内通过/storage访问
• /watch：监控目录，放入该目录的视频文件将自动转换
• /output：转换完成的视频文件输出目录

访问方式

启动容器后，通过浏览器访问 http://你的主机IP:5800 即可打开HandBrake汉化版Web界面。

注意事项

• 示例命令中的路径需根据实际需求调整，确保主机目录存在且权限正确
• 硬件加速（/dev/dri）为可选配置，需主机支持并正确映射设备
• 首次使用建议先配置输出格式、质量等参数，以获得最佳转换效果

完整文档可参考 https://github.com/jlesage/docker-handbrake