统信uos系统中需手动安装ffmpeg以支持硬件加速或定制编解码器，方法包括：一、apt在线安装（基础版）；二、预编译二进制包离线安装（适配glibc≥2.29）；三、源码编译安装（支持nvenc/vaapi等）；四、javacv间接部署（适配springboot）。
如果您在统信UOS系统中无法直接调用ffmpeg命令，或需要特定版本支持硬件加速、定制编解码器等功能，则需手动安装FFmpeg。以下是针对统信UOS平台的多种FFmpeg安装方法：
一、通过APT包管理器在线安装
适用于基础使用场景，无需源码编译，安装快捷且依赖自动解决。该方式默认安装的是UOS官方仓库提供的稳定版本，但可能不包含最新特性或私有编码器（如libx264、libvpx等）。
1、打开终端，更新软件包索引：
sudo apt update
2、执行安装命令：
sudo apt install ffmpeg
3、验证是否成功安装：
ffmpeg -version
若输出包含版本号及编译配置信息，说明安装完成。注意：此方式安装的ffmpeg通常不启用非自由编解码器，如需H.264/H.265硬解或AAC编码，需选用后续方法。
二、使用预编译二进制包离线安装
适用于无网络环境或需快速部署指定版本（如ffmpeg-6.1.1）的场景。该方式跳过编译过程，直接部署已构建好的可执行文件与动态库，兼容性取决于目标UOS系统的glibc版本（需≥2.29）。
1、从btbn/ffmpeg-builds下载对应架构（amd64/arm64）的full_build版本tar.xz包
2、解压至临时目录：
tar -xf ffmpeg-*-full_build.tar.xz
3、进入解压后目录的bin子目录，复制二进制文件到系统路径：
sudo cp ffmpeg ffprobe ffplay /usr/local/bin/
4、赋予执行权限（如未自动设置）：
sudo chmod +x /usr/local/bin/ffmpeg /usr/local/bin/ffprobe /usr/local/bin/ffplay
5、验证运行：
/usr/local/bin/ffmpeg -version
关键提示：若执行时提示“cannot open shared object file”，需检查系统glibc版本（ldd --version），并确认所选二进制包与UOS内核架构（uname -m）严格匹配。
三、从源码编译安装（含硬件支持）
适用于需启用NVENC、VAAPI、QSV等硬件加速，或集成fdk-aac、x264、x265等第三方编解码器的进阶场景。该方式对系统依赖要求高，需提前安装开发工具链与底层库。
1、安装基础编译依赖：
sudo apt install build-essential yasm meson ninja-build pkg-config libtool autoconf automake cmake
2、安装编解码器依赖（以x264、fdk-aac为例）：
sudo apt install libx264-dev libfdk-aac-dev libvpx-dev libass-dev libfreetype6-dev libmp3lame-dev
3、下载FFmpeg源码（以6.1.1为例）：
wget https://ffmpeg.org/releases/ffmpeg-6.1.1.tar.gz
tar -zxvf ffmpeg-6.1.1.tar.gz
cd ffmpeg-6.1.1
4、配置编译选项（启用共享库、硬件加速及常用编码器）：
./configure \
--prefix=/usr/local/ffmpeg \
--enable-shared \
--enable-gpl \
--enable-libx264 \
--enable-libfdk-aac \
--enable-libvpx \
--enable-vaapi \
--enable-libass
5、执行编译与安装：
make -j$(nproc)
sudo make install
6、配置动态链接库路径：
echo '/usr/local/ffmpeg/lib' | sudo tee /etc/ld.so.conf.d/ffmpeg.conf
sudo ldconfig
7、添加环境变量（可选，便于全局调用）：
echo 'export PATH="/usr/local/ffmpeg/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
重要提醒：若configure阶段报错“yasm not found”，需先源码编译安装yasm-1.3.0；若需NVIDIA GPU加速，必须确保已安装对应版本的nvidia-driver与cuda-toolkit，并启用--enable-nvenc。
四、通过JavaCV生态间接部署（适配SpringBoot项目）
适用于统信UOS上运行基于Java的多媒体处理服务（如视频分析、实时转码），避免直接操作原生ffmpeg二进制，由javacv自动加载适配UOS平台的ffmpeg动态库。
1、确认JDK版本为OpenJDK 11或更高版本：
java -version
2、在Maven项目的pom.xml中声明统一版本的bytedeco依赖：
3、构建项目时，Maven将自动下载适配UOS x86_64平台的ffmpeg native库（含.so文件）
4、在Java代码中调用FFmpegFrameGrabber或FFmpegFrameRecorder，无需额外配置路径
注意事项：javacv所带ffmpeg版本必须与系统glibc版本兼容（如glibc 2.28仅支持ffmpeg ≤5.1.2），且所有bytedeco子模块（javacpp、opencv、ffmpeg）版本号后缀必须完全一致（均为1.5.8）。
