宝塔面板中“ffmpeg”并非插件，而是调用系统包管理器安装的命令行工具；推荐使用btbn官方静态编译版并配置绝对路径调用，同时需解除php禁用函数、修复权限及selinux限制。
宝塔面板里没有“FFmpeg插件”这个东西
宝塔官方应用商店里标着“FFmpeg”的所谓“插件”，实际只是个一键安装脚本，它不提供图形化配置界面，也不集成到宝塔的网站/SSL/防火墙等任何模块中。它干的事就一件：apt install ffmpeg 或 yum install ffmpeg —— 本质是帮你执行系统级包安装。如果你看到“安装成功但 ffmpeg -version 报 command not found”，大概率是 PATH 没刷进宝塔运行环境，或者装的是阉割版（比如 CentOS Stream 8 自带的 ffmpeg 实际叫 ffmpeg4）。
手动安装前先确认系统源和架构是否匹配
宝塔支持的主流系统中，FFmpeg 的可用性差异极大：
- Ubuntu 20.04/22.04：默认源带基础版，但缺
libx264、libx265、libvpx，转码会直接报Unknown encoder 'libx264' - CentOS 7：EPEL 源里的
ffmpeg已废弃，必须换epel-release+rpmfusion-free-release才能装全功能版 - CentOS 8 / Rocky 8+：默认无 FFmpeg，
dnf install ffmpeg装出来是ffmpeg-4.4，但二进制名是ffmpeg4，PHPexec()调用时得写全路径或加软链 - ARM64（如树莓派、国产云服务器）：几乎不可能用系统源装全功能版，必须编译或改用
ffmpeg-static二进制
执行前先跑这行确认当前环境：cat /etc/os-release | grep -E "(NAME|VERSION)" && uname -m
推荐方案：用官方静态编译版（绕过系统依赖）
比折腾源更稳的方式，是直接下载 BtbN 维护的 ffmpeg-release-amd64-static.tar.xz（或对应架构版本），解压后扔进固定路径，再让 PHP 和 Shell 都能调到它。这是视频站上线前最常踩坑的环节。
- 下载地址：
wget https://github.com/BtbN/FFmpeg-Builds/releases/download/latest/ffmpeg-master-latest-linux64-gpl.tar.xz - 解压并软链：
tar -xf ffmpeg-master-latest-linux64-gpl.tar.xz && sudo ln -sf $(pwd)/ffmpeg-master-latest-linux64-gpl/bin/ffmpeg /usr/local/bin/ffmpeg - 验证：
ffmpeg -version应输出 build date 和 gpl license；ffmpeg -encoders | grep x264必须有结果 - PHP 中调用时，别依赖
PATH，显式写绝对路径：exec('/usr/local/bin/ffmpeg -i input.mp4 -c:v libx264 output.mp4 2>&1', $out)
宝塔下 PHP 执行失败的三个真实原因
即使 ffmpeg 命令在 SSH 里能跑，PHP 还是返回空或超时，常见卡点如下：
- 宝塔 PHP 运行用户（如
www）没权限读输入文件或写输出目录 —— 检查ls -l输出，确保www对路径有r和w权限 - PHP
disable_functions列表里禁了exec、shell_exec、system—— 进宝塔「PHP 设置 → 禁用函数」里删掉它们（注意安全边界） - SELinux 启用状态（尤其 CentOS/RHEL）会拦截 PHP 子进程调用外部二进制 —— 临时关：
sudo setenforce 0；永久关需改/etc/selinux/config，但生产环境建议配策略而非关闭
转码类业务真正难的不是装 FFmpeg，而是让 Web 进程在受限环境下稳定唤起它并收束资源 —— 很多“安装成功”只是骗过了命令行，没过 PHP 这关。
