# @derhuerst/ffprobe-static 中文文档

规范地址：https://npmcn.com/package/%40derhuerst/ffprobe-static/

版本：5\.3\.0
npm 元数据更新时间：2025-11-14T21:35:10.578Z
中文译文更新时间：2026-11-12T00:33:01.303Z
软件包许可：GPL-3\.0-or-later

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40derhuerst/ffprobe-static
原文对照：https://npmcn.com/package/%40derhuerst/ffprobe-static/?lang=original
项目主页：https://github.com/eugeneware/ffmpeg-static#readme
源码仓库：https://github.com/eugeneware/ffmpeg-static

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：48 kB，7 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=16
- 运行依赖：4 个
- 首次发布：2025-11-14T21:35:09.960Z
- 最新版本发布：2025-11-14T21:35:10.266Z
- 近 30 天下载量：125778（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：1（近 12 个月 1 个）

## 中文简介

macOS、Linux 和 Windows 的 ffprobe 二进制

## 安装

```sh
npm install @derhuerst/ffprobe-static
```

也可以使用：`pnpm add @derhuerst/ffprobe-static`、`yarn add @derhuerst/ffprobe-static`、`bun add @derhuerst/ffprobe-static`

## README

# 假静态

静态 **ffprobe(来自 [ffmpeg 数据](https://ffmpeg.org/) project)用于macOS,Linux,Windows的二进制.**

支持macOS(64位和arm64),Linux(32和64位,armhf,arm64),Windows(32和64位). [目前使用的ffmpeg版本是 `6.1.1`。 。 。 .](https://github.com/eugeneware/ffprobe-static/releases/tag/b6.1.1)

[![npm version](https://img.shields.io/npm/v/ffprobe-static.svg)](https://www.npmjs.com/package/ffprobe-static) ![minimum Node.js version](https://img.shields.io/node/v/ffprobe-static.svg)

_说明:_ 该版本 `ffprobe-static` 如下 [交换器](http://semver.org/)当发布新版本时, **没错 _没有_ 考虑打破 `ffprobe` 本身**,但只有JS接口(见下文). 譬如说, `ffprobe-static@4.5.0` 可能下载 ffprobe `5.0`防止 `ffprobe-static` 升级逆向兼容的 ffprobe 版本, [使用严格的版本范围](https://docs.npmjs.com/files/package.json#dependencies) 用于或使用 [锁定文件](https://docs.npmjs.com/files/package-lock.json)。 。 。 .

## 安装

```bash
$ npm install @derhuerst/ffprobe-static
```

_说明:_ 在安装期间,它将下载适当的 `ffprobe` 从二进制 [`b6.1.1` GitHub 发布](https://github.com/eugeneware/ffprobe-static/releases/tag/b6.1.1). 使用和分配二进制 `ffprobe` 由各自的执照管辖.

### 自定义二进制 URL

默认情况下 `ffprobe` 二进制将会从 `https://github.com/eugeneware/ffprobe-static/releases/download`要自定义,例如,在使用镜像时,设置 `FFPROBE_BINARIES_URL` 环境变量.

```shell
export FFPROBE_BINARIES_URL=https://cdn.npmmirror.com/binaries/ffprobe-static
npm install @derhuerst/ffprobe-static
```

### 电子和其他跨平台包装工具

因为 `ffprobe-static` 将下载OS/平台特有的二进制,您需要清除 `node_modules` 在重新包装您的应用程序之前 _用于不同的操作系统/平台_ (单位:千美元)[更多信息,请参见第35页](https://github.com/eugeneware/ffprobe-static/issues/35#issuecomment-630225392)) (中文(简体) ).

## 示例使用

返回本地文件系统中静态链接 ffprobe 二进制的路径 .

```js
const pathToFfprobe = require('ffprobe-static');
console.log(pathToFfprobe)
// /Users/j/playground/node_modules/ffprobe-static/ffprobe
```

检查 [示例脚本](https://npmcn.com/package/%40derhuerst/ffprobe-static/example.js) 更彻底的例子.

## 二进制的来源

下载的二进制 `ffprobe-static` 这些地点:

-   [Windows x64 构建](https://www.gyan.dev/ffmpeg/builds/)
-   [Windows x86 构建](https://github.com/sudo-nautilus/FFmpeg-Builds-Win32/)
-   [Linux x64/x86/ARM/ARM64大楼](https://johnvansickle.com/ffmpeg/)
-   马科斯 [x64 (英特尔)](https://evermeet.cx/pub/ffmpeg/) 打开 [ARM64 (平面硅)](https://osxexperts.net/) 正在建设

## 显示您的支持

这个npm软件包包括由以下个人所生产的静态连接二进制. 请考虑支持并捐赠给多年来一直提供质量二进制建筑的人:

-   **Linux 构建**数字 : [约翰·范斯凯勒](https://www.johnvansickle.com/ffmpeg/)
-   **macOS 构建**数字 : [赫尔穆特·特萨雷克](https://evermeet.cx/ffmpeg/#donations)

## 常见问题

### @derhuerst/ffprobe-static 是什么？

macOS、Linux 和 Windows 的 ffprobe 二进制

### 如何安装 @derhuerst/ffprobe-static？

在项目目录运行 npm install @derhuerst/ffprobe-static，或使用 pnpm add / yarn add / bun add。

### @derhuerst/ffprobe-static 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @derhuerst/ffprobe-static 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @derhuerst/ffprobe-static 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=16。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @derhuerst/ffprobe-static 可以商用吗？

@derhuerst/ffprobe-static 使用 GPL-3\.0-or-later 许可。强 Copyleft：分发包含该代码的软件时，整个作品需以 GPL-3\.0 兼容许可开源，并附带专利与反锁定条款。仅内部使用不触发此义务。以上为概括，不构成法律意见，请以许可原文为准。

### @derhuerst/ffprobe-static 的下载量有多少？

根据 npm 官方下载统计，@derhuerst/ffprobe-static 在 2026/10/12 – 2026/11/10 这 30 天内被下载 125,778 次，日均约 4,193 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @derhuerst/ffprobe-static 还在维护吗？

最新版本 5\.3\.0 发布于 2025/11/15（11 个月前）；至今共发布 1 个版本，其中过去 12 个月发布了 1 个；首次发布于 2025/11/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。