跳至主要內容

Linux 下 FFprobe 命令基础使用指南：音视频信息分析利器

佳哥很忙2022/6/9文章FFprobe音视频分析命令行工具大约 9 分钟

概述

FFprobe 是 FFmpeg 工具集的核心组件之一，专注于音视频媒体信息提取与分析。它能深度解析音视频文件或网络流的底层数据，包括容器格式（如 MP4、MKV）、音视频流参数（编码格式、分辨率、比特率）、帧信息（帧率、帧类型）、元数据（标题、时长）等，输出格式可直接被开发脚本解析或人工阅读。

与图形化分析工具（如 MediaInfo）相比，FFprobe 的优势在于：

  1. 命令行灵活控制：可按需筛选特定信息（如仅提取视频流编码、仅查看帧类型），避免冗余输出；
  2. 可编程集成：支持 JSON、XML 等结构化输出格式，便于嵌入自动化脚本（如批量校验视频参数、排查格式异常文件）；
  3. 原生适配 FFmpeg 生态：与 FFmpeg、FFplay 共享核心库，支持所有 FFmpeg 兼容的音视频格式与协议。

无论是音视频开发调试（如验证编码是否正确）、运维质检（如批量检查视频分辨率），还是日常格式确认，FFprobe 都是 Linux 环境下的高效工具。本文将系统梳理 FFprobe 的基础命令与核心用法，帮你快速掌握媒体信息分析技巧。

一、FFprobe 基础：信息查询与环境验证

在使用 FFprobe 分析媒体前，先掌握 “查看帮助”“验证版本” 等基础命令，确保工具环境符合需求。

1. 查看帮助信息

获取 FFprobe 所有支持的参数说明，新手可重点关注 “信息显示选项”“输出格式控制” 相关内容：

ffprobe -h  # 显示基础帮助：包含核心参数、信息筛选选项（推荐入门）
ffprobe -h long  # 显示详细帮助：包含高级参数（如输出格式配置、流筛选规则）

2. 查看版本与编译配置

确认 FFprobe 版本及编译时启用的功能（如是否支持某容器格式、编码解析）：

ffprobe -version    # 查看版本、编译日期、依赖库（如 libavformat 版本）
ffprobe -buildconf  # 查看编译配置：启用的容器格式、编解码器、协议等（排查功能缺失问题）

3. 隐藏启动 Banner（精简输出）

FFprobe 启动时默认显示版本、编译信息等 “Banner”，若需清理输出（如脚本解析时避免干扰），可隐藏 Banner：

ffprobe -hide_banner input.mp4  # 分析文件时不显示 Banner，仅保留媒体信息

二、FFprobe 核心命令：提取关键媒体信息

FFprobe 的命令格式为 ffprobe [options] [input_url]，其中 input_url 可是本地文件（如 test.mp4）、网络流（如 rtmp://xxx/live/stream）或设备（如摄像头 /dev/video0）。以下按 “容器信息”“流信息”“帧信息” 等核心场景，整理常用命令。

1. 查看容器格式信息（-show_format）

提取音视频文件的容器层级信息，包括文件大小、时长、格式类型（如 MP4、FLV）、元数据（标题、作者）等，适合快速确认文件整体属性：

# 基础用法：显示容器格式信息（含默认输出）
ffprobe -show_format input.mp4

# 优化输出：隐藏 Banner + 仅显示格式信息（避免冗余）
ffprobe -hide_banner -show_format input.mp4

# 结构化输出：以 JSON 格式输出（便于脚本解析）
ffprobe -hide_banner -show_format -print_format json input.mp4

输出关键信息说明：

  • format_name：容器格式（如 mov,mp4,m4a,3gp,3g2,mj2）；
  • duration：文件时长（单位：秒，含小数精度）；
  • size：文件大小（单位：字节）；
  • bit_rate：总比特率（单位：比特 / 秒，反映文件整体码率）；
  • tags：元数据（如 title 标题、artist 作者、creation_time 创建时间）。

2. 查看音视频流信息（-show_streams）

提取文件中每一条流的详细参数（视频流、音频流、字幕流），包括编码格式、分辨率、采样率等，是最常用的分析场景（如确认视频是否为 H.264 编码、音频是否为 AAC）：

# 基础用法：显示所有流信息（视频、音频、字幕）
ffprobe -hide_banner -show_streams input.mp4

# 筛选指定流：仅显示视频流（-select_streams v）
ffprobe -hide_banner -select_streams v -show_streams input.mp4

# 筛选指定流：仅显示音频流（-select_streams a）
ffprobe -hide_banner -select_streams a -show_streams input.mp4

# 结构化输出：以 XML 格式输出音频流信息（便于批量处理）
ffprobe -hide_banner -select_streams a -show_streams -print_format xml input.mp4

输出关键信息说明（视频流）：

  • codec_name：视频编码格式（如 h264、hevc）；
  • width/height：视频分辨率（如 1920×1080）；
  • r_frame_rate：帧率（如 25/1 表示 25 FPS）；
  • bit_rate：视频流比特率（单位：比特 / 秒）；
  • pix_fmt：像素格式（如 yuv420p，影响画质与兼容性）。

输出关键信息说明（音频流）：

  • codec_name：音频编码格式（如 aac、mp3）；
  • sample_rate：采样率（如 44100 表示 44.1 kHz）；
  • channels：声道数（如 2 表示立体声、1 表示单声道）；
  • bit_rate：音频流比特率（单位：比特 / 秒）。

3. 查看媒体包信息（-show_packets）

提取音视频包（Packet）的底层数据，包括包类型（视频包 / 音频包）、时间戳（PTS/DTS）、包大小、所属流索引等，适合深入分析流的封装结构（如排查包丢失、时间戳异常）：

# 基础用法：显示所有包信息
ffprobe -hide_banner -show_packets input.mp4

# 筛选指定流的包：仅显示视频流的包（-select_streams v）
ffprobe -hide_banner -select_streams v -show_packets input.mp4

# 简化输出：仅显示包的时间戳与大小（通过 -show_entries 筛选字段）
ffprobe -hide_banner -show_packets -show_entries packet=pts,dts,size input.mp4

输出关键信息说明：

  • stream_index：包所属流的索引（对应 -show_streams 中的 index）；
  • pts/dts：显示时间戳 / 解码时间戳（单位：毫秒，反映音视频同步关系）；
  • size：包大小（单位：字节，反映码率波动）；
  • flags：包标记（如 K 表示关键帧包、A 表示音频包）。

4. 查看帧与字幕信息（-show_frames）

提取音视频帧（Frame）的详细数据，包括帧类型（I 帧 / P 帧 / B 帧）、帧大小、播放时间、所属流等，同时支持显示字幕帧内容，适合分析画质压缩（如关键帧间隔）、字幕同步问题：

# 基础用法：显示所有帧信息（视频帧、音频帧、字幕帧）
ffprobe -hide_banner -show_frames input.mp4

# 筛选指定流的帧：仅显示视频帧
ffprobe -hide_banner -select_streams v -show_frames input.mp4

# 筛选关键帧：仅显示视频流的 I 帧（通过 -show_entries 与 -filter:v 组合）
ffprobe -hide_banner -select_streams v -show_frames -show_entries frame=pict_type,pts -filter:v "eq(pict_type\,I)" input.mp4

# 查看字幕帧：显示字幕内容与时间戳
ffprobe -hide_banner -select_streams s -show_frames input.mp4

输出关键信息说明（视频帧）：

  • pict_type：帧类型（I 关键帧、P 预测帧、B 双向预测帧）；
  • pts：帧显示时间戳（单位：毫秒，决定帧的播放顺序）；
  • pkt_size：帧大小（单位：字节，影响码率）；
  • width/height：帧分辨率（与视频流分辨率一致）。

5. 查看程序与流关联信息（-show_programs）

提取多节目（Program）封装文件的节目与流关联关系，适合分析多频道视频（如包含多个节目流的 TS 文件），明确每个节目包含的视频流、音频流、字幕流：

# 基础用法：显示所有节目及关联的流信息
ffprobe -hide_banner -show_programs input.ts

# 结构化输出：以 JSON 格式输出（便于脚本解析节目与流的映射关系）
ffprobe -hide_banner -show_programs -print_format json input.ts

输出关键信息说明：

  • program_id：节目 ID（唯一标识）；
  • streams：节目包含的流列表（每个流对应 -show_streams 中的 index）；
  • tags：节目元数据（如 service_name 节目名称、service_provider 服务商）。

6. 查看章节信息（-show_chapters）

提取文件中章节（Chapter）的时间范围与元数据，适合分析带章节标记的视频（如电影的 “片头”“正片”“片尾” 分段），明确每个章节的起始 / 结束时间：

# 基础用法：显示所有章节信息
ffprobe -hide_banner -show_chapters input.mp4

# 结构化输出：以 XML 格式输出（便于批量提取章节时间）
ffprobe -hide_banner -show_chapters -print_format xml input.mp4

输出关键信息说明：

  • id：章节 ID（唯一标识）；
  • start_time/end_time：章节起始 / 结束时间（单位：秒）；
  • tags：章节元数据（如 title 章节标题，如 “Chapter 1: Opening”）。

三、实用技巧：筛选与结构化输出

FFprobe 支持通过参数精准筛选信息、控制输出格式，避免冗余数据干扰，以下是高频实用技巧：

1. 筛选指定字段（-show_entries）

通过 -show_entries 仅输出需要的字段，减少输出量（如仅查看视频流的编码与分辨率）：

# 示例1：仅查看视频流的编码格式（codec_name）与分辨率（width/height）
ffprobe -hide_banner -select_streams v -show_streams -show_entries stream=codec_name,width,height input.mp4

# 示例2：仅查看容器的时长（duration）与总比特率（bit_rate）
ffprobe -hide_banner -show_format -show_entries format=duration,bit_rate input.mp4

2. 结构化输出（-print_format）

支持 JSON、XML、CSV 等格式输出，便于脚本解析（如用 Python 批量处理）：

# JSON 格式输出（最常用，便于脚本解析）
ffprobe -hide_banner -show_streams -print_format json input.mp4 > streams_info.json

# XML 格式输出（适合需按标签解析的场景）
ffprobe -hide_banner -show_format -print_format xml input.mp4 > format_info.xml

# 紧凑 JSON 格式（去除换行，适合传输）
ffprobe -hide_banner -show_streams -print_format json=compact=1 input.mp4

3. 静默模式（-v quiet）

仅输出指定的信息（如 -show_streams），不显示日志（适合脚本中避免干扰）：

# 静默模式 + 仅显示视频流信息 + JSON 输出（无任何多余日志）
ffprobe -v quiet -hide_banner -select_streams v -show_streams -print_format json input.mp4

四、常见使用场景示例

结合实际需求，整理几个 FFprobe 高频使用场景，可直接参考复用：

场景 1：批量检查视频分辨率是否符合要求（如 1080P）

# 编写脚本：遍历目录下所有 MP4 文件，检查视频流是否为 1920×1080
for file in *.mp4; do
  echo "检查文件：$file"
  ffprobe -v quiet -hide_banner -select_streams v -show_streams -show_entries stream=width,height -print_format json "$file" | jq '.streams[] | select(.width == 1920 and .height == 1080) | .width, .height'
  if [ $? -ne 0 ]; then
    echo "$file 分辨率不符合 1080P 要求"
  fi
done

场景 2：提取网络流的编码格式与比特率（如 RTMP 直播流）

# 分析 RTMP 流，提取视频编码、音频编码、总比特率
ffprobe -v quiet -hide_banner -show_format -show_streams -select_streams v:a -show_entries stream=codec_name,format=bit_rate -print_format json rtmp://live.hkstv.hk.lxdns.com/live/hks

场景 3：查看视频关键帧间隔（分析 I 帧分布）

# 提取视频流的 I 帧时间戳，计算关键帧间隔
ffprobe -v quiet -hide_banner -select_streams v -show_frames -show_entries frame=pts,pict_type -filter:v "eq(pict_type\,I)" -print_format csv=p=0 input.mp4

总结

FFprobe 作为 FFmpeg 生态的 “信息分析中枢”，其核心价值在于精准、灵活地提取音视频底层数据。无论是日常格式确认（如 “这个视频是什么编码？”），还是开发运维的自动化需求（如 “批量校验 1000 个视频的分辨率”），FFprobe 都能通过命令行参数快速实现。

新手入门时，建议先掌握 -show_format（容器信息）和 -show_streams（流信息）两个核心命令，再逐步探索 -show_frames（帧分析）、结构化输出等高级用法。若需进一步深入，可参考 FFmpeg 官方文档，结合实际场景练习参数组合，才能真正发挥其高效分析能力。