FFmpeg 安装教程
FFmpeg 安装完成后，可用于本项目的音乐转码 与整轨音乐分割功能，是项目运行的关键工具之一。以下是详细的安装步骤：
二、下载 FFmpeg
FFmpeg 官方未提供图形化安装包，需通过第三方可靠渠道下载对应架构的压缩包：
- 打开浏览器，访问下载地址：https://johnvansickle.com/ffmpeg/（该网站提供稳定的 Linux/macOS 版本，Windows 版本可参考文末补充说明）；
- 进入页面后，在右侧「Download FFmpeg」区域 ，根据自己计算机的「架构」选择对应版本（主流架构为
amd64或arm64，如何查看架构见下文）； - 点击对应版本的压缩包链接（通常为
ffmpeg-git-xxx-amd64-static.tar.xz格式），开始下载。
三、如何查看计算机架构？
不同操作系统查看架构的方法不同，具体步骤如下：
| 操作系统 | 查看方法 |
|---|---|
| Windows | 方法1（通过系统设置）： 1. 打开「开始菜单」→ 点击「设置」（齿轮图标）； 2. 选择「系统」→ 点击左侧「关于」； 3. 在「设备规格」下找到「系统类型」，显示「64位操作系统，x64 基于处理器」即 amd64 架构，显示「ARM 基于处理器」即 arm64 架构。 方法2（通过命令）： 1. 打开「命令提示符/PowerShell」； 2. 输入 wmic os get osarchitecture 回车，输出「64位」+ 后续提示可判断（x64 对应 amd64，ARM64 对应 arm64）； 或输入 systeminfo 回车，查找「系统类型」字段，含义同上。 |
| macOS | 1. 点击屏幕左上角「苹果图标」→ 选择「关于本机」； 2. 在弹出窗口中查看「处理器」信息： - 显示「Apple M1/M2/M3」等，为 arm64 架构； - 显示「Intel Core i5/i7」等，为 amd64（x86_64）架构。 |
| Linux | 1. 打开「终端」； 2. 输入命令 uname -m 并回车； - 输出 x86_64，对应 amd64 架构； - 输出 aarch64，对应 arm64 架构。 |
四、解压缩 FFmpeg 压缩包
- 找到下载完成的压缩包（通常在「下载」文件夹中，格式为
.tar.xz或.zip）； - 右键点击压缩包，选择「解压到当前文件夹」（或用终端命令解压：
tar -xvf 压缩包文件名.tar.xz）； - 解压后会生成一个文件夹，打开文件夹，找到名为
ffmpeg的可执行文件（无后缀名，是核心文件，仅需保留此文件即可，其他文件可忽略）。
五、将 FFmpeg 移动到项目指定目录
为确保项目能正常调用 FFmpeg，需将核心文件移动到项目挂载的目录中（项目部署时已预设挂载路径 /aap/data，对应本地计算机的实际路径需根据你的部署情况确认）：
-
首先确认本地计算机的项目数据目录，例如你的实际路径为
/volume/music_tag_web/data； -
在该目录下新建
bin文件夹 （若已存在则跳过）：终端命令：
mkdir -p /volume/music_tag_web/data/bin（-p表示若上级目录不存在，会自动创建）； -
将解压得到的
ffmpeg文件，移动到bin文件夹中，最终路径为：/volume/music_tag_web/data/bin/ffmpeg（可通过终端命令移动：mv 解压后的ffmpeg路径 /volume/music_tag_web/data/bin/）。
六、赋予 FFmpeg 执行权限
Linux/macOS 系统中，新移动的文件默认可能没有执行权限，需通过命令开启：
-
打开终端，进入
bin目录：cd /volume/music_tag_web/data/bin/； -
输入授权命令并回车：
chmod +x ffmpeg（该命令表示给ffmpeg文件添加「可执行」权限）。
七、验证安装成功
完成上述步骤后，再次验证 FFmpeg 是否可用：
- 在终端中输入命令：
/volume/music_tag_web/data/bin/ffmpeg -version； - 若终端显示 FFmpeg 的版本信息，说明安装成功，项目可正常调用该工具；
- 后续在项目中配置 FFmpeg 路径时，直接填写
/volume/music_tag_web/data/bin/ffmpeg即可。