
通过 FFmpeg 的 -progress 参数,可将转码过程中的关键指标(如帧数、码率、耗时、完成状态)以 key=value 格式实时输出到文件、TCP 或 HTTP 端点,便于程序自动解析与状态判断。
通过 ffmpeg 的 `-progress` 参数,可将转码过程中的关键指标(如帧数、码率、耗时、完成状态)以 `key=value` 格式实时输出到文件、tcp 或 http 端点,便于程序自动解析与状态判断。
在 Go 等编程语言中调用 FFmpeg 进行视频转码时,若仅依赖标准输出(CombinedOutput())解析成功与否,会面临两大问题:一是日志内容高度冗余且格式不固定(含版本信息、编解码器细节、统计摘要等),难以稳定提取关键状态;二是 FFmpeg 的退出码(exit code)虽能反映最终成败,但无法提供中间进度或失败原因(如输入损坏、磁盘满、权限不足等)。此时,-progress 参数是官方推荐的机器可读输出方案。
-progress 支持多种目标地址:
-
filename:写入本地文件(如-progress /tmp/ffmpeg.progress) -
tcp://host:port:发送至 TCP 服务端(需自行监听解析) -
http://host:port/path:POST 到 HTTP 接口(需服务端支持)
每秒推送一组 key=value 键值对,最后一行恒为 progress=end(成功结束)或 progress=abort(异常中断),这是判断任务是否完成的最可靠信号。
✅ Go 示例:结合 -progress 与退出码双重校验
package main
import (
"bufio"
"fmt"
"os/exec"
"strings"
"time"
)
func ffmpegConvert(source, dest string) error {
// 创建临时进度文件
progressFile := "/tmp/ffmpeg-progress-" + fmt.Sprintf("%d", time.Now().UnixNano())
defer func() { _ = os.Remove(progressFile) }()
cmd := exec.Command("ffmpeg",
"-y", // 覆盖输出,避免交互提示
"-i", source,
"-vcodec", "libx264",
"-acodec", "aac",
"-strict", "-2",
"-progress", progressFile,
dest,
)
// 捕获 stderr(FFmpeg 主要日志在此)用于调试,但不用于状态判断
output, err := cmd.CombinedOutput()
if err != nil {
return fmt.Errorf("ffmpeg command failed with exit code %d: %s", cmd.ProcessState.ExitCode(), string(output))
}
// 解析进度文件,确认是否正常结束
f, err := os.Open(progressFile)
if err != nil {
return fmt.Errorf("failed to open progress file: %w", err)
}
defer f.Close()
scanner := bufio.NewScanner(f)
var lastProgress string
for scanner.Scan() {
line := strings.TrimSpace(scanner.Text())
if strings.HasPrefix(line, "progress=") {
lastProgress = line
}
}
if lastProgress != "progress=end" {
return fmt.Errorf("ffmpeg did not complete successfully; last progress: %s", lastProgress)
}
return nil
}⚠️ 注意事项:
- 始终添加
-y参数,避免因输出文件已存在导致 FFmpeg 阻塞等待用户输入; -
-progress输出频率默认为每秒一次,可通过-progress url -report组合启用更详细的报告模式(生成.ffmpegrc文件),但通常progress=end已足够判断结果; - 不要仅依赖输出文件是否存在——如磁盘空间不足时,FFmpeg 可能创建空文件后退出失败,而
progress=abort会明确标识异常; - 若需实时流式解析(如 Web 后端推送进度条),建议使用
tcp://或http://方式配合 goroutine 异步监听,避免阻塞主流程。
综上,-progress 是 FFmpeg 官方提供的轻量、稳定、标准化的机器可读接口,配合退出码校验,即可构建高鲁棒性的自动化媒体处理流水线。

















