宝塔面板FFmpeg视频处理配置教程：从安装到实战

很多站长在宝塔面板上搭建网站后，会遇到需要处理视频的场景：上传的MP4太大、格式不兼容、或者需要生成缩略图。
这时候FFmpeg就是必装的工具。
但新手往往卡在配置上——装了却用不了，或者根本不知道怎么装。
本文从零开始，带你把宝塔面板FFmpeg视频处理配置搞定，每一步都有截图级别的说明（用文字描述路径），让你直接落地。

安装前确认两个关键条件

在动手之前，先确认你的宝塔面板已经正常安装且版本不低于7.0。
另外，如果你用的是Nginx环境，记得检查是否开启了exec函数（部分PHP函数默认禁用）。
怎么查？
登录宝塔后台 -> 左侧「软件商店」 -> 找到你正在使用的PHP版本（例如PHP 7.4）-> 点击「设置」-> 切到「禁用函数」标签页，搜索exec、shell_exec，如果出现在禁用列表里，双击移除即可。
这一步不做好，后面用PHP调用FFmpeg会直接报错。

通过软件商店一键安装FFmpeg

宝塔面板把FFmpeg打包成了插件，安装非常简单：

1. 登录宝塔面板后台，点击左侧菜单「软件商店」。
2. 在搜索框输入FFmpeg，回车。你会看到「FFmpeg」应用（图标是一个胶片卷）。
3. 点击「安装」，版本选最新稳定版，安装目录保持默认 /usr/local/ffmpeg。点击确定开始安装。

整个过程大概2-3分钟，安装完成后，在软件商店已安装列表里就能看到它。
你也可以通过SSH执行ffmpeg -version验证是否装好。
如果提示command not found，说明环境变量没生效，稍等一分钟或重启面板再试。

配置PHP扩展以调用FFmpeg

光装好FFmpeg还不够，要让你的网站程序（比如WordPress、Laravel）能够调用它，需要配置PHP的putenv或proc_open等函数。
但最简单的办法是直接在PHP中指定FFmpeg的完整路径。
以PHP脚本为例：

$ffmpegPath = '/usr/local/ffmpeg/bin/ffmpeg';
$output = shell_exec($ffmpegPath . ' -version');
echo $output;

如果你使用第三方库（如PHP-FFmpeg），一般会自动检测路径，但如果检测不到，就手动设置二进制文件路径为上述地址。
另外，宝塔面板默认PHP用户是www，需要确保/usr/local/ffmpeg目录的权限让www用户可读可执行。
打开SSH执行：

chown -R www:www /usr/local/ffmpeg
chmod -R 755 /usr/local/ffmpeg

这样PHP脚本就能成功调用FFmpeg了。

常用视频处理命令实战

安装配置完成后，我们可以直接在SSH终端里运行命令。
以下三个场景最常用：

• 压缩视频体积：ffmpeg -i input.mp4 -vf scale=1280:720 -b:v 1M -c:a aac -b:a 128k output.mp4。将视频缩放到720p，视频码率1M，音频码率128k，体积能缩小50%以上。
• 转成GIF：ffmpeg -i input.mp4 -vf fps=10,scale=320:-1 output.gif。取每秒10帧，宽度320像素。
• 提取音频：ffmpeg -i input.mp4 -vn -acodec mp3 output.mp3。

注意：所有输入输出文件路径必须正确。
如果文件在网站根目录，记得写绝对路径，比如/www/wwwroot/yourdomain.com/uploads/video.mp4。

常见问题与避坑提示

问题1：执行命令后报“Permission denied”
原因：文件或目录权限不够。检查视频文件所属用户是否为www，并且有读取权限。可以用ls -l查看。
问题2：PHP调用exec返回空或false
解决：先检查PHP禁用函数里是否放行了exec和shell_exec（按上文步骤操作）。另外尝试在PHP中把错误信息显示出来：

error_reporting(E_ALL);
ini_set('display_errors', 1);

问题3：FFmpeg处理大视频时超时
默认PHP执行时间有限，建议在脚本开头加set_time_limit(0);并调整nginx的proxy_read_timeout。
问题4：转码后视频没有声音
可能是输入文件音频编码不被支持，或者输出参数缺了音频编码器。可以先用ffmpeg -i input.mp4查看音频流，再指定合适的编码。

最后提醒：以上所有命令请先在SSH中跑通，再集成到网站代码里。
每次修改配置后记得重启PHP服务（在宝塔面板「软件商店」对应PHP设置里点「重启」）。
如果你按照本文步骤走下来，宝塔面板FFmpeg视频处理配置已经能正常工作了。
遇到其他报错，优先看错误日志路径：/www/wwwroot/你的站点/runtime/log 或PHP错误日志，多半是路径或权限问题。