踩坑指南：如何在你的网站上顺利使用ffmpeg.wasm-唐霜

ffmpeg.wasm这个项目可以帮助我【版权所有，侵权必究】转载请注明出处：www.tangshuang.net们在浏览器内使用ffmpeg进行视频处理【未经授权禁止转载】原创内容，盗版必究。，是一个非常棒的项目。然而，要真正在浏览未经授权，禁止复制转载。【版权所有，侵权必究】器里面跑起来，却需要花费非常多的精力去走转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】好第一步。本文详细聊一聊。

转载请注明出处：www.tangshua【原创内容，转载请注明出处】【转载请注明来源】ng.net本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。

必要文件有哪些？

当你打算使用它时，并不代表你可以立即使用未经授权，禁止复制转载。原创内容，盗版必究。它。网上的大部分教程都无法直接启动。甚至未经授权，禁止复制转载。【作者：唐霜】，它的官方教程都没有一篇能让你快速跑起来原创内容，盗版必究。【转载请注明来源】的文档。这是因为它不像其他库一样，可以被未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。直接加载，要在前端加载和使用ffmpeg本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。.wasm，需要多个步骤多个文件。我们先【版权所有】唐霜 www.tangshuang.net【本文首发于唐霜的博客】来看看，必要的文件有哪些：

【原创内容，转载请注明出处】原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】

@ffmpeg/ffmpeg ̵原创内容，盗版必究。【本文受版权保护】1; 加载和调用库，用以被包含在你的实际【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。业务代码中，作为调用ffmpeg.was【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.netm的入口

著作权归作者所有，禁止商业用途转载。

本文版权归作者所有，未经授权不得转载。

原创内容，盗版必究。

@ffmpeg/util –本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】工具库，用以辅助上面的主库进行加载

本文作者：唐霜，转载请注明出处。

【本文受版权保护】

@ffmpeg/core –【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。 ffmpeg.wasm的运行文件，不被原创内容，盗版必究。转载请注明出处：www.tangshuang.net包含在你的实际业务代码中，需要被远程加载

【作者：唐霜】

你需要使用yarn/npm先安装上面这些【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。包，以下载代码。但是@ffmpeg/co【原创内容，转载请注明出处】【原创不易，请尊重版权】re这个包里面的代码可能需要被拷贝出来放【版权所有】唐霜 www.tangshuang.net【作者：唐霜】在一个独立文件夹内，另外@ffmpeg/未经授权，禁止复制转载。【转载请注明来源】ffmpeg中的worker.js也是需著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。要拷贝出来备用。是否需要拷贝，需要取决于本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。你编译工具是否支持从node_modul本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。es目录下引用js作为url，同时，你还【本文首发于唐霜的博客】【版权所有，侵权必究】必须考虑另外一个问题，即你是不是通过CD本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。N使用业务js文件。CND问题下面会讲。

【原创内容，转载请注明出处】【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。

每一个包下载之后，你进入每一个包的dis本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】t文件夹，可以看到esm和umd两个分包未经授权，禁止复制转载。【原创不易，请尊重版权】，虽然看上去只是模块差别，但是在使用上，【本文受版权保护】【版权所有，侵权必究】天差地别。默认在webpack、vite本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。等环境中，直接import时，走的是es【本文受版权保护】【原创不易，请尊重版权】m，记住这一点很重要。

【本文受版权保护】本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshua本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。ng.net

当你选择其中一种模式之后，后续所准备的文【版权所有】唐霜 www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】件，也必须选择这种模式。例如选择esm模未经授权，禁止复制转载。【版权所有】唐霜 www.tangshuang.net式后，后续其他包也要选择这种模式。但是，【原创不易，请尊重版权】【关注微信公众号：wwwtangshuangnet】在ffmpeg.wasm的官方网站中，已著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.net经标注出弃用CDN，实际上也就弃用了um【转载请注明来源】【访问 www.tangshuang.net 获取更多精彩内容】d。我在看它的dist时，也发现了umd【原创不易，请尊重版权】【版权所有，侵权必究】下没有worker.js文件。因此，我们转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】实际上只能选择esm。

接下来，我们看看实际上到底是哪些文件在起【原创内容，转载请注明出处】未经授权，禁止复制转载。作用：

@ffmpeg/ffmpeg/dist/【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。esm/classes.js 提供FFm【原创内容，转载请注明出处】【原创内容，转载请注明出处】peg类，包含了加载和调用方法

【未经授权禁止转载】

@ffmpeg/ffmpeg/dist/【本文首发于唐霜的博客】【本文首发于唐霜的博客】esm/worker.js 提供了wor【原创不易，请尊重版权】【作者：唐霜】ker线程中的代码，在调用ffmpeg.未经授权，禁止复制转载。【本文首发于唐霜的博客】load时，该文件作为classWork【关注微信公众号：wwwtangshuangnet】【作者：唐霜】erURL传入

【原创不易，请尊重版权】

【作者：唐霜】

转载请注明出处：www.tangshua转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。ng.net

@ffmpeg/core/dist/es【作者：唐霜】【版权所有】唐霜 www.tangshuang.netm/ffmpeg-core.js 提供了【未经授权禁止转载】【转载请注明来源】用于加载wasm和暴露接口的代码

【原创不易，请尊重版权】

原创内容，盗版必究。

@ffmpeg/core/dist/es【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。m/ffmpeg-core.wasm 提【原创不易，请尊重版权】原创内容，盗版必究。供了wasm文件

著作权归作者所有，禁止商业用途转载。

【本文首发于唐霜的博客】

著作权归作者所有，禁止商业用途转载。

另外，你可能还需要util文件来使用辅助本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】功能，特别是fetchFile函数，基本【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。上一定会用到。因此，我们可以将文件也拷贝本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】出来，重命名为util.js

【关注微信公众号：wwwtangshua【原创内容，转载请注明出处】原创内容，盗版必究。ngnet】【作者：唐霜】

@ffmpeg/util/dist/es【转载请注明来源】本文版权归作者所有，未经授权不得转载。m/index.js

【未经授权禁止转载】

著作权归作者所有，禁止商业用途转载。

本文作者：唐霜，转载请注明出处。

如何快速部署？

我们将@ffmpeg文件夹直接从node【版权所有，侵权必究】【访问 www.tangshuang.net 获取更多精彩内容】_modules拷贝出来，重命名为一个名【未经授权禁止转载】原创内容，盗版必究。字叫做ffmpeg.wasm的文件夹，你【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处：www.tangshuang.net可以只保留dist/esm目录，把其他目【本文首发于唐霜的博客】【原创不易，请尊重版权】录全部剔除掉，甚至删除掉全部.d.ts和【作者：唐霜】本文作者：唐霜，转载请注明出处。.map文件，这样可以节省空间。最后将f【版权所有】唐霜 www.tangshuang.net【未经授权禁止转载】fmpeg.wasm这个文件夹放到你网站转载请注明出处：www.tangshuang.net原创内容，盗版必究。的根路径下，vite可以放在public著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net目录下，或者通过vite的vite-pl本文作者：唐霜，转载请注明出处。原创内容，盗版必究。ugin-static-copy插件，让【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。vite自动拷贝ffmpeg.wasm这【版权所有，侵权必究】本文版权归作者所有，未经授权不得转载。个目录，webpack下也有类似的拷贝插转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net件。

【转载请注明来源】著作权归作者所有，禁止商业用途转载。

本文版权归作者所有，未经授权不得转载。【本文受版权保护】未经授权，禁止复制转载。

执行代码

import { FFmpeg } from '@ffmpeg/ffmpeg';
import { fetchFile } from '@ffmpeg/util';

async transcodeToMp4(file: File): Promise<ArrayBuffer> {
    const ffmpeg = new FFmpeg();

    // 加载上面部署好的必要文件，很重要，如果没有上面的处理，这里你都不知道要填什么
    await ffmpeg.load({
        coreURL: '/ffmpeg.wasm/core/dist/esm/ffmpeg-core.js',
        wasmURL: '/ffmpeg.wasm/core/dist/esm/ffmpeg-core.wasm',
        classWorkerURL: '/ffmpeg.wasm/ffmpeg/dist/esm/worker.js',
    });

    await ffmpeg.writeFile(file.name, await fetchFile(file));
    await ffmpeg.exec(['-i', file.name, '-c', 'copy', 'output.mp4']);
    const data = await ffmpeg.readFile('output.mp4');

    await ffmpeg.deleteFile('output.mp4');
    await ffmpeg.deleteFile(inputFileName);

    // @ts-ignore
    return data.buffer;
}

这段代码实现了最简单的调用ffmpeg.【本文首发于唐霜的博客】【本文受版权保护】wasm来将视频转化为mp4文件的过程。著作权归作者所有，禁止商业用途转载。【转载请注明来源】不过实际上，我们在真实的环境中，不会如此【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。简单的写代码，我们会考虑复用ffmpeg转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net实例，考虑只需要加载一次这些必要文件等等原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。，这里只是为了方便演示，使得代码非常清晰【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】，才这么给了一个函数（虽然它也是正确的代【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】码）。

本文作者：唐霜，转载请注明出处。【未经授权禁止转载】【原创不易，请尊重版权】

部署在CDN上

这里会遇到两个问题，一个是脚本加载跨域，原创内容，盗版必究。原创内容，盗版必究。另一个是webworker实例化时不允许原创内容，盗版必究。【原创内容，转载请注明出处】传入非当前被访问页面origin之外的.【作者：唐霜】【未经授权禁止转载】js文件路径。这两个问题都可以解决。

本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。

具体修改后的代码如下：

本文作者：唐霜，转载请注明出处。【本文受版权保护】本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】

import { FFmpeg } from '@ffmpeg/ffmpeg';
import { fetchFile, toBlobURL } from '@ffmpeg/util';

async transcodeToMp4(file: File): Promise<ArrayBuffer> {
    const ffmpeg = new FFmpeg();

    // 加载上面部署好的必要文件
    await ffmpeg.load({
        coreURL: await toBlobURL(new URL('/ffmpeg.wasm/core/dist/esm/ffmpeg-core.js', import.meta.url), 'application/javascript'),
        wasmURL: await toBlobURL(new URL('/ffmpeg.wasm/core/dist/esm/ffmpeg-core.wasm', import.meta.url), 'application/wasm'),
        classWorkerURL: await toBlobURL(new URL('/ffmpeg.wasm/ffmpeg/dist/esm/worker.js', import.meta.url), 'application/javascript'),
    });

    await ffmpeg.writeFile(file.name, await fetchFile(file));
    await ffmpeg.exec(['-i', file.name, '-c', 'copy', 'output.mp4']);
    const data = await ffmpeg.readFile('output.mp4');

    await ffmpeg.deleteFile('output.mp4');
    await ffmpeg.deleteFile(inputFileName);

    // @ts-ignore
    return data.buffer;
}

通过上面这个修改，它会把这些脚本下载下来【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】后，用blob:地址来挂载脚本，而web著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。worker支持在同域名下的blob:脚【作者：唐霜】【转载请注明来源】本作为worker脚本，这就解决了web【本文受版权保护】【作者：唐霜】worker实例化问题。

【作者：唐霜】原创内容，盗版必究。原创内容，盗版必究。原创内容，盗版必究。

需要注意的是，上面这段业务代码的最终bu【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。ild，必须安装我前面说的方法，和必要文【转载请注明来源】【访问 www.tangshuang.net 获取更多精彩内容】件们部署在一起，且都放在根目录下，否则你原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】又不知道文件路径该怎么填写了。

启用多线程

【未经授权禁止转载】本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。

上面我们已经完全跑起来一个ffmpeg.【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。wasm的实例了，但是，官方提供了多线程转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net（启动多个worker）来加速处理的能力【转载请注明来源】本文作者：唐霜，转载请注明出处。，下面就介绍如何使用多线程。

【访问 www.tangshuang.n【转载请注明来源】【原创内容，转载请注明出处】et 获取更多精彩内容】【本文首发于唐霜的博客】【本文受版权保护】著作权归作者所有，禁止商业用途转载。

我们需要新安装一个包@ffmpeg/co【版权所有】唐霜 www.tangshuang.net未经授权，禁止复制转载。re-mt，mt就是multiple t【作者：唐霜】【版权所有】唐霜 www.tangshuang.nethread的缩写。按照上面必要文件一节的【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。方法进行部署。接下来，直接进入到执行代码【版权所有，侵权必究】【转载请注明来源】处：

著作权归作者所有，禁止商业用途转载。【本文受版权保护】

import { FFmpeg } from '@ffmpeg/ffmpeg';
import { fetchFile } from '@ffmpeg/util';

async transcodeToMp4(file: File): Promise<ArrayBuffer> {
    const ffmpeg = new FFmpeg();

    await ffmpeg.load({
        coreURL: '/ffmpeg.wasm/core-mt/dist/esm/ffmpeg-core.js',
        wasmURL: '/ffmpeg.wasm/core-mt/dist/esm/ffmpeg-core.wasm',
        workerURL: '/ffmpeg.wasm/core-mt/dist/esm/ffmpeg-core.worker.js',
        classWorkerURL: '/ffmpeg.wasm/ffmpeg/dist/esm/worker.js',
    });

    await ffmpeg.writeFile(file.name, await fetchFile(file));
    await ffmpeg.exec(['-i', file.name, '-c', 'copy', 'output.mp4']);
    const data = await ffmpeg.readFile('output.mp4');

    await ffmpeg.deleteFile('output.mp4');
    await ffmpeg.deleteFile(inputFileName);

    // @ts-ignore
    return data.buffer;
}

然而这还没有完，由于涉及到多线程的问题，【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】所以自然也涉及到“内存共享”问题，cor【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】e-mt会使用到SharedArrayB【未经授权禁止转载】【关注微信公众号：wwwtangshuangnet】uffer来在多线程之间共享内存，然而，【原创不易，请尊重版权】原创内容，盗版必究。要开启对SharedArrayBuffe【原创内容，转载请注明出处】【作者：唐霜】r的支持，则成本比较大。首先，你需要在你【原创内容，转载请注明出处】【本文受版权保护】的主站点（也就是提供视频转换的站点）域名【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。，开启如下两个headers：

'Cross-Origin-Opener-Policy': 'same-origin'
'Cross-Origin-Embedder-Policy': 'require-corp'

然而，如果你的团队无法自己控制服务器的话原创内容，盗版必究。【作者：唐霜】，就比较麻烦，因为devops团队很难为【原创不易，请尊重版权】【关注微信公众号：wwwtangshuangnet】你开独立的配置。而且开启之后，会让你的网原创内容，盗版必究。【未经授权禁止转载】站元气大伤。你的网站加载第三方站点的资源【未经授权禁止转载】转载请注明出处：www.tangshuang.net（例如CDN上的文件、第三方服务商、统计【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。代码等等），都必须要求第三方的文件服务h著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】eaders中（除了开启CORS之外）包原创内容，盗版必究。本文作者：唐霜，转载请注明出处。含如下：

【原创不易，请尊重版权】【转载请注明来源】【作者：唐霜】著作权归作者所有，禁止商业用途转载。

'Cross-Origin-Resource-Policy': 'cross-origin'

你自己的CND服务还可能有机会去设置这个【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。头，如果是第三方服务商，例如统一登录代码本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net、网站统计，则几乎必然受到影响。（如果你【版权所有】唐霜 www.tangshuang.net【关注微信公众号：wwwtangshuangnet】是把代码放在CDN上，不要忘记了使用to【本文首发于唐霜的博客】【原创内容，转载请注明出处】BlobURL来转换。）我的网站也因此导【原创不易，请尊重版权】【作者：唐霜】致我的google登录受到影响，不得不放【未经授权禁止转载】原创内容，盗版必究。弃多线程模式。

【本文首发于唐霜的博客】未经授权，禁止复制转载。

通过iframe来提供多线程服务

既然开启多线程能力对主站点的影响巨大，那本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】么，可不可以通过开一个子站点，在这个子站未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。点中实现上述多线程的配置呢？我们开一个子未经授权，禁止复制转载。【原创不易，请尊重版权】站点，在保证子站点和主站点可以自由通信的著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.net处理之后，我们按照上面的方法在子站点开启【版权所有】唐霜 www.tangshuang.net【本文受版权保护】对SharedArrayBuffer的支原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。持，然后在子站点下提供一个html，在该原创内容，盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】html内按照上述逻辑，提供多线程处理视本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。频的能力。在主站点中通过iframe来加本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】载子站点的这个html，再利用postM【未经授权禁止转载】【原创内容，转载请注明出处】essage实现两者之间的通信。当主站点原创内容，盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】有视频处理请求的时候，将请求发送给ifr【本文受版权保护】本文作者：唐霜，转载请注明出处。ame内的代码完成，完成后再把结果通过p未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。ostMessage返回给主站点。这样就【转载请注明来源】转载请注明出处：www.tangshuang.net可以利用多线程能力了。不过，iframe本文版权归作者所有，未经授权不得转载。【本文受版权保护】本身其实也限制多多，你需要一个一个解决。

未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。

写在最后

在我们的网站需要用到视频处理的能力的时候转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】，我们可以利用ffmpeg.wasm来直【原创内容，转载请注明出处】【本文受版权保护】接在浏览器内进行处理。然而，这个项目虽好【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.net，但在一些很基础的使用上存在坑，没有去趟【原创内容，转载请注明出处】【转载请注明来源】过，还是会比较痛苦。本文总结了我遇到了几【本文受版权保护】著作权归作者所有，禁止商业用途转载。个点，如果你也遇到了，欢迎在下面评论区留本文作者：唐霜，转载请注明出处。【版权所有，侵权必究】言，我会继续补充。

【关注微信公众号：wwwtangshua【原创不易，请尊重版权】【原创不易，请尊重版权】ngnet】【关注微信公众号：wwwtangshua著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.netngnet】

【本文受版权保护】原创内容，盗版必究。原创内容，盗版必究。未经授权，禁止复制转载。【版权所有，侵权必究】著作权归作者所有，禁止商业用途转载。【转载请注明来源】未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。【原创内容，转载请注明出处】【转载请注明来源】【未经授权禁止转载】【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】【转载请注明来源】转载请注明出处：www.tangshuang.net【作者：唐霜】著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】未经授权，禁止复制转载。【本文首发于唐霜的博客】【未经授权禁止转载】

2025-08-31 2501 ffmpeg, 视频处理

唐霜

踩坑指南：如何在你的网站上顺利使用ffmpeg.wasm

必要文件有哪些？

如何快速部署？

执行代码

部署在CDN上

启用多线程

通过iframe来提供多线程服务

写在最后

为价值买单，打赏一杯咖啡

声明

关于

生态