安装与配置

概述

本章介绍如何在不同操作系统上安装 FFmpeg，包括预编译二进制包和从源码编译两种方式，以及如何配置硬件加速和第三方库。

各平台安装方法

Linux

Ubuntu/Debian

# 更新包索引
sudo apt update

# 安装 FFmpeg（来自官方仓库）
sudo apt install ffmpeg

# 验证安装
ffmpeg -version

# 查看编译配置
ffmpeg -buildconf

使用 PPA 安装最新版本：

# 添加 PPA 仓库
sudo add-apt-repository ppa:ubuntuhandbook1/ffmpeg6

# 更新包索引
sudo apt update

# 升级 FFmpeg
sudo apt upgrade ffmpeg

CentOS/RHEL/Fedora

# CentOS/RHEL（需要 EPEL 仓库）
sudo yum install epel-release
sudo yum install ffmpeg

# Fedora
sudo dnf install ffmpeg

使用 RPM Fusion 仓库：

# 安装 RPM Fusion 仓库
sudo dnf install https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm
sudo dnf install https://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-$(rpm -E %fedora).noarch.rpm

# 安装 FFmpeg
sudo dnf install ffmpeg ffmpeg-devel

Arch Linux

# 安装 FFmpeg
sudo pacman -S ffmpeg

# 安装完整版本（包含所有编解码器）
sudo pacman -S ffmpeg-full

从源码编译（通用 Linux）

# 安装依赖
sudo apt install -y \
    autoconf \
    automake \
    build-essential \
    cmake \
    git \
    libass-dev \
    libfreetype6-dev \
    libgnutls28-dev \
    libmp3lame-dev \
    libopus-dev \
    libsdl2-dev \
    libtool \
    libva-dev \
    libvdpau-dev \
    libvorbis-dev \
    libxcb1-dev \
    libxcb-shm0-dev \
    libxcb-xfixes0-dev \
    meson \
    ninja-build \
    pkg-config \
    texinfo \
    wget \
    yasm \
    zlib1g-dev

# 创建工作目录
mkdir -p ~/ffmpeg_sources ~/ffmpeg_build ~/bin

# 安装 NASM（汇编器）
cd ~/ffmpeg_sources
wget https://www.nasm.us/pub/nasm/releasebuilds/2.15.05/nasm-2.15.05.tar.bz2
tar xjvf nasm-2.15.05.tar.bz2
cd nasm-2.15.05
./configure --prefix="$HOME/ffmpeg_build" --bindir="$HOME/bin"
make -j$(nproc)
make install

# 安装 YASM
cd ~/ffmpeg_sources
wget -O yasm-1.3.0.tar.gz https://www.tortall.net/projects/yasm/releases/yasm-1.3.0.tar.gz
tar xzvf yasm-1.3.0.tar.gz
cd yasm-1.3.0
./configure --prefix="$HOME/ffmpeg_build" --bindir="$HOME/bin"
make -j$(nproc)
make install

# 安装 libx264
cd ~/ffmpeg_sources
git -C x264 pull 2>/dev/null || git clone --depth 1 https://code.videolan.org/videolan/x264.git
cd x264
PATH="$HOME/bin:$PATH" ./configure --prefix="$HOME/ffmpeg_build" --bindir="$HOME/bin" --enable-static --enable-pic
PATH="$HOME/bin:$PATH" make -j$(nproc)
make install

# 安装 libx265
cd ~/ffmpeg_sources
git -C x265_git pull 2>/dev/null || git clone https://bitbucket.org/multicoreware/x265_git.git
cd x265_git/build/linux
PATH="$HOME/bin:$PATH" cmake -G Ninja -DCMAKE_INSTALL_PREFIX="$HOME/ffmpeg_build" -DENABLE_SHARED=off ../../source
ninja
ninja install

# 安装 libvpx
cd ~/ffmpeg_sources
git -C libvpx pull 2>/dev/null || git clone --depth 1 https://chromium.googlesource.com/webm/libvpx.git
cd libvpx
PATH="$HOME/bin:$PATH" ./configure --prefix="$HOME/ffmpeg_build" --disable-examples --disable-unit-tests --enable-vp9-highbitdepth --as=yasm
PATH="$HOME/bin:$PATH" make -j$(nproc)
make install

# 安装 libfdk-aac
cd ~/ffmpeg_sources
git -C fdk-aac pull 2>/dev/null || git clone --depth 1 https://github.com/mstorsjo/fdk-aac
cd fdk-aac
autoreconf -fiv
./configure --prefix="$HOME/ffmpeg_build" --disable-shared
make -j$(nproc)
make install

# 安装 libmp3lame
cd ~/ffmpeg_sources
wget -O lame-3.100.tar.gz https://downloads.sourceforge.net/project/lame/lame/3.100/lame-3.100.tar.gz
tar xzvf lame-3.100.tar.gz
cd lame-3.100
PATH="$HOME/bin:$PATH" ./configure --prefix="$HOME/ffmpeg_build" --bindir="$HOME/bin" --disable-shared --enable-nasm
PATH="$HOME/bin:$PATH" make -j$(nproc)
make install

# 安装 libopus
cd ~/ffmpeg_sources
git -C opus pull 2>/dev/null || git clone --depth 1 https://github.com/xiph/opus.git
cd opus
./autogen.sh
./configure --prefix="$HOME/ffmpeg_build" --disable-shared
make -j$(nproc)
make install

# 安装 libaom（AV1）
cd ~/ffmpeg_sources
git -C aom pull 2>/dev/null || git clone --depth 1 https://aomedia.googlesource.com/aom
mkdir -p aom_build
cd aom_build
PATH="$HOME/bin:$PATH" cmake -G Ninja -DCMAKE_INSTALL_PREFIX="$HOME/ffmpeg_build" -DENABLE_SHARED=off -DENABLE_NASM=on -DENABLE_TESTS=off -DENABLE_EXAMPLES=off ../aom
ninja
ninja install

# 安装 FFmpeg
cd ~/ffmpeg_sources
git -C ffmpeg pull 2>/dev/null || git clone https://git.ffmpeg.org/ffmpeg.git
cd ffmpeg
PATH="$HOME/bin:$PATH" PKG_CONFIG_PATH="$HOME/ffmpeg_build/lib/pkgconfig" ./configure \
    --prefix="$HOME/ffmpeg_build" \
    --pkg-config-flags="--static" \
    --extra-cflags="-I$HOME/ffmpeg_build/include" \
    --extra-ldflags="-L$HOME/ffmpeg_build/lib" \
    --extra-libs="-lpthread -lm" \
    --ld="g++" \
    --bindir="$HOME/bin" \
    --enable-gpl \
    --enable-gnutls \
    --enable-libaom \
    --enable-libass \
    --enable-libfdk-aac \
    --enable-libfreetype \
    --enable-libmp3lame \
    --enable-libopus \
    --enable-libvorbis \
    --enable-libvpx \
    --enable-libx264 \
    --enable-libx265 \
    --enable-nonfree
PATH="$HOME/bin:$PATH" make -j$(nproc)
make install
hash -r

macOS

使用 Homebrew

# 安装 Homebrew（如果未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 FFmpeg（基础版本）
brew install ffmpeg

# 安装完整版本（包含所有编解码器）
brew install ffmpeg --with-fdk-aac --with-ffplay --with-freetype --with-libass --with-libvorbis --with-libvpx --with-opus --with-x264 --with-x265

# 验证安装
ffmpeg -version

使用 MacPorts

# 安装 MacPorts（如果未安装）
# 从 https://www.macports.org/install.php 下载安装

# 安装 FFmpeg
sudo port install ffmpeg

# 安装完整版本
sudo port install ffmpeg +nonfree

从源码编译（macOS）

# 安装 Xcode 命令行工具
xcode-select --install

# 安装依赖
brew install automake cmake git libtool nasm pkg-config sdl2 wget yasm

# 后续步骤与 Linux 源码编译类似

Windows

使用预编译二进制包

下载 FFmpeg：
- 访问 https://ffmpeg.org/download.html
- 选择 Windows 版本
- 下载 gyan.dev 或 BtbN 的构建版本

安装步骤：

# 解压下载的文件
# 将 bin 目录添加到系统 PATH
# 以管理员身份运行 PowerShell
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\ffmpeg\bin", "Machine")

# 重新打开命令提示符，验证安装
ffmpeg -version

使用 Chocolatey

# 安装 Chocolatey（如果未安装）
# 以管理员身份运行 PowerShell
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

# 安装 FFmpeg
choco install ffmpeg

使用 Scoop

# 安装 Scoop（如果未安装）
# 以普通用户身份运行 PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex

# 添加仓库
scoop bucket add main

# 安装 FFmpeg
scoop install ffmpeg

使用 winget

# 安装 FFmpeg
winget install ffmpeg

# 验证安装
ffmpeg -version

编译选项详解

通用选项

选项	说明	默认值
`--prefix=<path>`	安装路径	`/usr/local`
`--bindir=<path>`	可执行文件路径	`<prefix>/bin`
`--libdir=<path>`	库文件路径	`<prefix>/lib`
`--incdir=<path>`	头文件路径	`<prefix>/include`
`--enable-shared`	构建动态库	否
`--enable-static`	构建静态库	是
`--enable-pic`	生成位置无关代码	否
`--enable-debug`	启用调试信息	否
`--enable-optimizations`	启用优化	是
`--enable-stripping`	去除符号表	是

许可选项

选项	说明
`--enable-gpl`	启用 GPL 许可
`--enable-nonfree`	启用非自由许可
`--enable-version3`	启用 (L)GPLv3

编解码器选项

选项	说明	依赖
`--enable-libx264`	H.264 编码器	libx264
`--enable-libx265`	H.265/HEVC 编码器	libx265
`--enable-libvpx`	VP8/VP9 编解码器	libvpx
`--enable-libaom`	AV1 编解码器	libaom
`--enable-libfdk-aac`	AAC 编码器	libfdk-aac
`--enable-libmp3lame`	MP3 编码器	libmp3lame
`--enable-libopus`	Opus 编解码器	libopus
`--enable-libvorbis`	Vorbis 编码器	libvorbis
`--enable-libtheora`	Theora 编码器	libtheora

硬件加速选项

选项	说明	平台
`--enable-vaapi`	VAAPI 加速	Linux
`--enable-vdpau`	VDPAU 加速	Linux
`--enable-nvenc`	NVIDIA 编码加速	跨平台
`--enable-nvdec`	NVIDIA 解码加速	跨平台
`--enable-cuda`	CUDA 支持	跨平台
`--enable-qsv`	Intel QSV 加速	跨平台
`--enable-videotoolbox`	VideoToolbox 加速	macOS
`--enable-rkmpp`	Rockchip MPP 加速	Linux

滤镜选项

选项	说明	依赖
`--enable-libass`	ASS/SSA 字幕渲染	libass
`--enable-libfreetype`	字体渲染	FreeType
`--enable-libfontconfig`	字体配置	Fontconfig
`--enable-libfribidi`	双向文本	FriBidi
`--enable-libharfbuzz`	文本整形	HarfBuzz

网络协议选项

选项	说明	依赖
`--enable-gnutls`	GnuTLS 支持	GnuTLS
`--enable-openssl`	OpenSSL 支持	OpenSSL
`--enable-librtmp`	RTMP 支持	librtmp
`--enable-libssh`	SSH 支持	libssh

其他选项

选项	说明	依赖
`--enable-libzimg`	图像缩放	zimg
`--enable-libdav1d`	AV1 解码器	dav1d
`--enable-libsvtav1`	SVT-AV1 编码器	SVT-AV1
`--enable-libwebp`	WebP 支持	libwebp

硬件加速配置

NVIDIA GPU

安装 NVIDIA 驱动

# Ubuntu
sudo apt install nvidia-driver-535

# 验证安装
nvidia-smi

安装 NVIDIA Codec Headers

# 克隆 NVIDIA Codec Headers
git clone https://git.videolan.org/git/ffmpeg/nv-codec-headers.git
cd nv-codec-headers

# 安装
make install PREFIX="$HOME/ffmpeg_build"

编译 FFmpeg 支持 NVIDIA

./configure \
    --prefix="$HOME/ffmpeg_build" \
    --enable-gpl \
    --enable-nonfree \
    --enable-cuda-nvcc \
    --enable-libnpp \
    --enable-cuvid \
    --enable-nvenc \
    --enable-nvdec \
    --extra-cflags="-I/usr/local/cuda/include" \
    --extra-ldflags="-L/usr/local/cuda/lib64"

Intel QSV

安装 Intel Media SDK

# Ubuntu
sudo apt install intel-media-va-driver vainfo

# 安装 Intel Media SDK
sudo apt install libmfx1 libmfx-tools libmfx-dev

编译 FFmpeg 支持 QSV

./configure \
    --prefix="$HOME/ffmpeg_build" \
    --enable-gpl \
    --enable-nonfree \
    --enable-libmfx

AMD VAAPI

安装 VAAPI 驱动

# Ubuntu
sudo apt install mesa-va-drivers vainfo

# 验证安装
vainfo

编译 FFmpeg 支持 VAAPI

./configure \
    --prefix="$HOME/ffmpeg_build" \
    --enable-gpl \
    --enable-vaapi

Apple VideoToolbox

检查 VideoToolbox 支持

# macOS 已内置 VideoToolbox
# 验证支持
ffmpeg -hwaccels

编译 FFmpeg 支持 VideoToolbox

./configure \
    --prefix="$HOME/ffmpeg_build" \
    --enable-gpl \
    --enable-videotoolbox

第三方库集成

视频编解码器

libx264（H.264）

# 安装依赖
sudo apt install libx264-dev

# 编译 FFmpeg
./configure --enable-libx264

测试命令：

# 使用 libx264 编码
ffmpeg -i input.mp4 -c:v libx264 -preset medium -crf 23 output.mp4

# 查看支持的参数
ffmpeg -h encoder=libx264

libx265（H.265/HEVC）

# 安装依赖
sudo apt install libx265-dev

# 编译 FFmpeg
./configure --enable-libx265

测试命令：

# 使用 libx265 编码
ffmpeg -i input.mp4 -c:v libx265 -preset medium -crf 28 output.mp4

# 查看支持的参数
ffmpeg -h encoder=libx265

libvpx（VP8/VP9）

# 安装依赖
sudo apt install libvpx-dev

# 编译 FFmpeg
./configure --enable-libvpx

测试命令：

# VP8 编码
ffmpeg -i input.mp4 -c:v libvpx -b:v 2M output.webm

# VP9 编码
ffmpeg -i input.mp4 -c:v libvpx-vp9 -crf 30 -b:v 0 output.webm

libaom（AV1）

# 安装依赖（需要从源码编译）
git clone --depth 1 https://aomedia.googlesource.com/aom
cd aom
mkdir build && cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr/local ..
make -j$(nproc)
sudo make install

# 编译 FFmpeg
./configure --enable-libaom

测试命令：

# AV1 编码（较慢，适合测试）
ffmpeg -i input.mp4 -c:v libaom-av1 -crf 30 -b:v 0 output.mkv

音频编解码器

libfdk-aac（AAC）

# 安装依赖
sudo apt install libfdk-aac-dev

# 编译 FFmpeg（需要 --enable-nonfree）
./configure --enable-libfdk-aac --enable-nonfree

测试命令：

# AAC 编码
ffmpeg -i input.wav -c:a libfdk-aac -b:a 192k output.m4a

libmp3lame（MP3）

# 安装依赖
sudo apt install libmp3lame-dev

# 编译 FFmpeg
./configure --enable-libmp3lame

测试命令：

# MP3 编码
ffmpeg -i input.wav -c:a libmp3lame -q:a 2 output.mp3

libopus（Opus）

# 安装依赖
sudo apt install libopus-dev

# 编译 FFmpeg
./configure --enable-libopus

测试命令：

# Opus 编码
ffmpeg -i input.wav -c:a libopus -b:a 128k output.opus

字幕和字体

libass（ASS/SSA 字幕）

# 安装依赖
sudo apt install libass-dev

# 编译 FFmpeg
./configure --enable-libass

FreeType（字体渲染）

# 安装依赖
sudo apt install libfreetype6-dev

# 编译 FFmpeg
./configure --enable-libfreetype

其他库

libzimg（高质量图像缩放）

# 从源码编译
git clone https://github.com/sekrit-twc/zimg.git
cd zimg
./autogen.sh
./configure
make -j$(nproc)
sudo make install

# 编译 FFmpeg
./configure --enable-libzimg

libdav1d（快速 AV1 解码器）

# 安装依赖
sudo apt install libdav1d-dev

# 编译 FFmpeg
./configure --enable-libdav1d

配置验证

验证安装

# 查看版本
ffmpeg -version

# 查看编译配置
ffmpeg -buildconf

# 查看支持的编解码器
ffmpeg -codecs

# 查看支持的格式
ffmpeg -formats

# 查看支持的滤镜
ffmpeg -filters

# 查看硬件加速器
ffmpeg -hwaccels

测试编解码器

# 测试 H.264 编码
ffmpeg -f lavfi -i testsrc=duration=5:size=640x480:rate=30 -c:v libx264 -y test_h264.mp4

# 测试 H.265 编码
ffmpeg -f lavfi -i testsrc=duration=5:size=640x480:rate=30 -c:v libx265 -y test_h265.mp4

# 测试 VP9 编码
ffmpeg -f lavfi -i testsrc=duration=5:size=640x480:rate=30 -c:v libvpx-vp9 -y test_vp9.webm

# 测试音频编码
ffmpeg -f lavfi -i sine=frequency=1000:duration=5 -c:a libmp3lame -y test_mp3.mp3

版本管理

多版本共存

# 使用不同安装路径
# FFmpeg 5.x
./configure --prefix=/opt/ffmpeg5

# FFmpeg 6.x
./configure --prefix=/opt/ffmpeg6

# 使用 update-alternatives 管理
sudo update-alternatives --install /usr/bin/ffmpeg ffmpeg /opt/ffmpeg5/bin/ffmpeg 50
sudo update-alternatives --install /usr/bin/ffmpeg ffmpeg /opt/ffmpeg6/bin/ffmpeg 60

# 切换版本
sudo update-alternatives --config ffmpeg

版本查看脚本

#!/bin/bash
# ffmpeg_version_info.sh

echo "=== FFmpeg 版本信息 ==="
ffmpeg -version | head -1

echo -e "\n=== 编译配置 ==="
ffmpeg -buildconf 2>&1 | head -20

echo -e "\n=== 支持的编解码器数量 ==="
echo "视频编码器: $(ffmpeg -encoders 2>/dev/null | grep '^ V' | wc -l)"
echo "视频解码器: $(ffmpeg -decoders 2>/dev/null | grep '^ V' | wc -l)"
echo "音频编码器: $(ffmpeg -encoders 2>/dev/null | grep '^ A' | wc -l)"
echo "音频解码器: $(ffmpeg -decoders 2>/dev/null | grep '^ A' | wc -l)"

echo -e "\n=== 支持的格式数量 ==="
echo "容器格式: $(ffmpeg -formats 2>/dev/null | grep '^ D' | wc -l)"

echo -e "\n=== 硬件加速器 ==="
ffmpeg -hwaccels 2>/dev/null | tail -n +2

常见问题

问题 1：找不到编解码器

错误信息：

Unknown encoder 'libx264'

解决方案：

# 检查是否安装了 libx264
dpkg -l | grep libx264

# 如果未安装
sudo apt install libx264-dev

# 重新编译 FFmpeg
./configure --enable-libx264

问题 2：权限不足

错误信息：

Permission denied

解决方案：

# 使用 sudo
sudo make install

# 或者安装到用户目录
./configure --prefix=$HOME/ffmpeg_build

问题 3：依赖库版本不匹配

错误信息：

libx264.so.164: cannot open shared object file

解决方案：

# 更新库缓存
sudo ldconfig

# 或者静态编译
./configure --enable-static --disable-shared

问题 4：硬件加速不工作

错误信息：

No device available for decoder

解决方案：

# 检查硬件加速支持
ffmpeg -hwaccels

# 检查设备权限
ls -la /dev/dri/

# 添加用户到 video 组
sudo usermod -aG video $USER

注意事项

版权问题：使用非自由编解码器（如 libfdk-aac）需要 --enable-nonfree
专利问题：H.264、H.265 等编解码器可能涉及专利，商业使用需谨慎
性能考虑：编译时启用优化选项（--enable-optimizations）可提高性能
兼容性：不同平台的硬件加速支持程度不同，需查阅文档
更新维护：定期更新 FFmpeg 以获取安全补丁和新特性

业务场景

场景 1：视频处理服务器

需求： 搭建高性能视频处理服务器

配置建议：

# 编译选项
./configure \
    --enable-gpl \
    --enable-nonfree \
    --enable-libx264 \
    --enable-libx265 \
    --enable-nvenc \
    --enable-nvdec \
    --enable-cuda \
    --enable-optimizations \
    --enable-stripping

场景 2：流媒体服务器

需求： 搭建流媒体转码服务器

配置建议：

# 编译选项
./configure \
    --enable-gpl \
    --enable-nonfree \
    --enable-libx264 \
    --enable-libfdk-aac \
    --enable-libopus \
    --enable-openssl \
    --enable-librtmp

场景 3：桌面多媒体应用

需求： 开发桌面多媒体播放器

配置建议：

# 编译选项
./configure \
    --enable-gpl \
    --enable-sdl2 \
    --enable-libass \
    --enable-libfreetype \
    --enable-libmp3lame \
    --enable-libopus

扩展阅读

总结

本章介绍了 FFmpeg 在各平台的安装方法、编译选项、硬件加速配置和第三方库集成。通过本章的学习，您应该能够：

在不同操作系统上安装 FFmpeg
理解并配置编译选项
配置硬件加速支持
集成第三方编解码器库

在下一章中，我们将学习 FFmpeg 的基本语法和使用方法。

强曰为道

安装与配置

安装与配置

概述

各平台安装方法

Linux

Ubuntu/Debian

CentOS/RHEL/Fedora

Arch Linux

从源码编译（通用 Linux）

macOS

使用 Homebrew

使用 MacPorts

从源码编译（macOS）

Windows

使用预编译二进制包

使用 Chocolatey

使用 Scoop

使用 winget

编译选项详解

通用选项

许可选项

编解码器选项

硬件加速选项

滤镜选项

网络协议选项

其他选项

硬件加速配置

NVIDIA GPU

安装 NVIDIA 驱动

安装 NVIDIA Codec Headers

编译 FFmpeg 支持 NVIDIA

Intel QSV

安装 Intel Media SDK

编译 FFmpeg 支持 QSV

AMD VAAPI

安装 VAAPI 驱动

编译 FFmpeg 支持 VAAPI

Apple VideoToolbox

检查 VideoToolbox 支持

编译 FFmpeg 支持 VideoToolbox

第三方库集成

视频编解码器

libx264（H.264）

libx265（H.265/HEVC）

libvpx（VP8/VP9）

libaom（AV1）

音频编解码器

libfdk-aac（AAC）

libmp3lame（MP3）

libopus（Opus）

字幕和字体

libass（ASS/SSA 字幕）

FreeType（字体渲染）

其他库

libzimg（高质量图像缩放）

libdav1d（快速 AV1 解码器）

配置验证

验证安装

测试编解码器

版本管理

多版本共存

版本查看脚本

常见问题

问题 1：找不到编解码器

问题 2：权限不足

问题 3：依赖库版本不匹配

问题 4：硬件加速不工作

注意事项

业务场景

场景 1：视频处理服务器

场景 2：流媒体服务器

场景 3：桌面多媒体应用

扩展阅读

总结