martinwong248/ffmpeg-compressor

镜像概述

本Docker镜像专注于视频压缩与格式转换，专为智能手表场景优化。通过内置的视频处理工具和预设参数，简化视频适配智能手表的流程，帮助用户快速将普通视频转换为适合手表存储和播放的小体积、低功耗格式，无需手动配置复杂的视频编码参数。

核心功能和特性

• 智能压缩算法：采用高效视频压缩技术，在保证基本画质的前提下显著减小文件体积，适配智能手表有限存储空间
• 多格式支持：兼容主流输入格式（MP4、AVI、MKV、MOV等），输出为智能手表兼容的H.264/AVC编码MP4格式
• 参数自适应：内置针对主流智能手表（Apple Watch、Samsung Galaxy Watch、华为Watch等）的优化参数模板，自动调整分辨率（如320x240、480x360）、帧率（15-30fps）和比特率
• 灵活配置：支持通过命令行参数或环境变量自定义压缩质量、分辨率、帧率等关键参数，满足个性化需求
• 轻量级部署：基于Alpine Linux构建，镜像体积小，资源占用低，可快速启动和运行

使用场景和适用范围

• 个人智能手表用户：需在手表上存储和播放教学视频、健身指导、短视频等内容的普通用户
• 内容创作者：为智能手表平台制作适配视频内容的自媒体或开发者
• 企业培训场景：需向员工智能手表推送培训视频的企业内部培训系统集成
• 运动场景：为跑步、骑行等运动时通过手表观看视频（如导航提示、运动指导）的用户提供适配工具

使用方法和配置说明

基础使用流程

1. 准备待压缩视频文件，存放于本地目录（如/home/user/videos/input）
2. 创建输出目录（如/home/user/videos/output）用于存放压缩后的视频
3. 通过docker run命令启动容器，挂载输入/输出目录并指定处理参数

核心参数说明

Docker Run命令示例

单文件压缩（基础示例）

bash
docker run -v /home/user/videos/input:/input -v /home/user/videos/output:/output docker.xuanyuan.run/video-compress-watch:latest \
  --input /input/original_video.mp4 \
  --output /output/watch_video.mp4 \
  --quality medium \
  --resolution 480x360 \
  --fps 24

批量处理目录下所有视频

bash
docker run -v /home/user/videos/input:/input -v /home/user/videos/output:/output docker.xuanyuan.run/video-compress-watch:latest \
  --batch /input \
  --output-dir /output \
  --quality low \
  --resolution 320x240

环境变量配置

通过环境变量预设默认参数，减少命令行输入：

• DEFAULT_QUALITY：默认压缩质量（low/medium/high）
• DEFAULT_RESOLUTION：默认分辨率（如320x240）
• DEFAULT_FPS：默认帧率（如15）

示例：使用环境变量预设参数

bash
docker run -e DEFAULT_QUALITY=high -e DEFAULT_RESOLUTION=480x360 \
  -v /home/user/videos/input:/input -v /home/user/videos/output:/output \
  docker.xuanyuan.run/video-compress-watch:latest \
  --input /input/training_video.avi \
  --output /output/watch_training.mp4

输出文件说明

压缩后的视频文件默认命名规则：

• 单文件处理：保持原文件名，添加_watch后缀（如original_video.mp4→original_video_watch.mp4）
• 批量处理：保持原文件名，直接输出至--output-dir指定目录

输出文件特性：

• 编码格式：H.264/AVC
• 音频编码：AAC（低比特率，适配手表扬声器）
• 文件体积：通常为原文件的10%-30%（取决于原视频参数和压缩质量）