masterofzen/av1an

Av1an Docker镜像文档

镜像概述

Av1an Docker镜像是一个跨平台视频编码框架的容器化实现，旨在简化AV1、HEVC、H264、VP9、VP8等视频格式的编码流程。该镜像集成了多种主流编码器（AOM、RAV1E、SVT-AV1、x265、x264等），支持通过场景分割实现并行编码，提供目标质量控制、编码恢复等高级功能，适用于需要高效视频转码的场景。

核心功能与特性

• 多编码器支持：兼容AOM、RAV1E、SVT-AV1、SVT-VP9、VPX、x265、x264等多种编码器
• 场景分割并行编码：通过场景检测将视频分割为片段并行处理，提升编码效率
• 目标质量模式：基于VMAF指标实现目标质量控制，支持自定义质量范围和探测参数
• 编码恢复：支持中断后恢复编码，避免进度丢失
• 灵活配置：可自定义视频参数、音频参数、分块方式、临时文件路径等
• 容器化部署：通过Docker实现跨平台一致运行环境，简化依赖管理

使用场景

• 视频网站内容转码（如AV1格式适配）
• 批量视频质量优化与格式转换
• 高分辨率视频高效编码处理
• 需要严格控制输出质量的专业视频处理
• 多平台环境下的一致性编码任务

Docker使用方法

基本运行命令

Linux系统

bash
docker run --privileged -v "$(pwd):/videos" --user $(id -u):$(id -g) -it --rm masterofzen/av1an:latest -i 输入文件.mkv [选项]

Windows系统

powershell
docker run --privileged -v "${PWD}:/videos" -it --rm masterofzen/av1an:latest -i 输入文件.mkv [选项]

构建本地镜像

bash
docker build -t "av1an" .

指定自定义目录

bash
docker run --privileged -v "/自定义目录路径":/videos --user $(id -u):$(id -g) -it --rm masterofzen/av1an:latest -i 输入文件.mkv [选项]

注意：Linux系统需添加--user $(id -u):$(id -g)参数避免权限问题，确保用户对挂载目录有读写权限。

主要配置参数

基础参数

• -i, --input：输入文件路径（支持Vapoursynth脚本(.py,.vpy)）
• -o, --output-file：输出文件路径（默认：输入文件名_编码器.mkv，始终为.mkv格式）
• -e, --encoder：选择编码器（默认：aom；可选：aom, rav1e, vpx, svt-av1, x264, x265）
• -v, --video-params：编码器参数（需用单/双引号包裹，如："--cpu-used=3 --cq-level=30"）
• -p, --passes：编码 passes 数量（默认值：AOMENC:2, rav1e:1, SVT-AV1:1, VPX:2, x265:1, x264:1）
• -w, --workers：覆盖工作进程数量
• -r, --resume：恢复中断的编码任务
• --keep：编码完成后保留临时文件夹
• -q, --quiet：不显示终端进度条
• -l, --logging：日志文件路径（默认在临时文件夹）
• --temp：临时文件夹路径（默认：.hash）
• -c, --concat：片段拼接方式（默认：ffmpeg；可选：ffmpeg, mkvmerge, ivf）
• --webm：输出webm格式（需确保音视频源兼容）

FFmpeg相关参数

• -a, --audio-params：FFmpeg音频参数（默认：复制源音频；如：'-c:a libopus -b:a 192k'）
• -f, --ffmpeg：FFmpeg视频选项（应用于每个编码片段；如：" -vf scale=320:240 "）
• --pix-format：自定义像素/位格式（默认：yuv420p10le）

片段分割参数

• --split-method：场景分割方法（默认：av-scenedetect；可选：av-scenedetect, none）
• -m, --chunk-method：分块方式（默认自动选择；可选：segment, select, ffms2, lsmash, hybrid）
• -s, --scenes：场景保存/读取文件路径
• -x, --extra-split：超过指定大小的片段将被分割（默认：240）
• --min-scene-len：最小片段帧数

目标质量参数

• --target-quality：目标质量值（基于VMAF算法）
• --target-quality-method：质量控制算法（可选：per_shot）
• --min-q, --max-q：最小/最大量化值限制（默认使用编码器范围）
• --vmaf：编码后计算VMAF并生成图表
• --vmaf-path：自定义libvmaf模型路径（需同时提供.pkl和.pkl.model文件）
• --vmaf-res：VMAF计算分辨率（默认：1920x1080）
• --probes：质量探测次数（默认：4）
• --probe-slow：使用指定视频参数进行VMAF探测
• --vmaf-filter：VMAF计算使用的滤镜（filter_complex格式）
• --probing-rate：VMAF探测采样率（每N帧采样，默认：4）
• --vmaf-threads：VMAF计算线程限制

Docker镜像标签说明

使用示例

默认参数编码

bash
docker run --privileged -v "$(pwd):/videos" --user $(id -u):$(id -g) -it --rm masterofzen/av1an:latest -i input.mkv

自定义参数编码

bash
docker run --privileged -v "$(pwd):/videos" --user $(id -u):$(id -g) -it --rm masterofzen/av1an:latest \
  -i input.mkv \
  -e svt-av1 \
  -v " --cpu-used=3 --end-usage=q --cq-level=30 --threads=8 " \
  -w 10 \
  --target-quality 95 \
  -a "-c:a libopus -ac 2 -b:a 192k" \
  -log encode.log \
  -o output.mkv