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

ffmpeg.wasm这个项目可以帮助我著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。们在浏览器内使用ffmpeg进行视频处理【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。，是一个非常棒的项目。然而，要真正在浏览原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。器里面跑起来，却需要花费非常多的精力去走本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。好第一步。本文详细聊一聊。

必要文件有哪些？

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

本文版权归作者所有，未经授权不得转载。【作者：唐霜】【作者：唐霜】【原创不易，请尊重版权】

@ffmpeg/ffmpeg ̵【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】1; 加载和调用库，用以被包含在你的实际原创内容，盗版必究。本文作者：唐霜，转载请注明出处。业务代码中，作为调用ffmpeg.was【版权所有】唐霜 www.tangshuang.net【原创内容，转载请注明出处】m的入口

【原创内容，转载请注明出处】

【本文受版权保护】

【作者：唐霜】

@ffmpeg/util –转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。工具库，用以辅助上面的主库进行加载

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

【本文受版权保护】

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

@ffmpeg/core –【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。 ffmpeg.wasm的运行文件，不被转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。包含在你的实际业务代码中，需要被远程加载

【访问 www.tangshuang.net 获取更多精彩内容】

【未经授权禁止转载】

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

未经授权，禁止复制转载。【未经授权禁止转载】未经授权，禁止复制转载。

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

转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。

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

接下来，我们看看实际上到底是哪些文件在起未经授权，禁止复制转载。【作者：唐霜】作用：

转载请注明出处：www.tangshuang.net【作者：唐霜】【原创不易，请尊重版权】

@ffmpeg/ffmpeg/dist/本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。esm/classes.js 提供FFm转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】peg类，包含了加载和调用方法

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

原创内容，盗版必究。

【未经授权禁止转载】

@ffmpeg/ffmpeg/dist/著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】esm/worker.js 提供了wor未经授权，禁止复制转载。【转载请注明来源】ker线程中的代码，在调用ffmpeg.【未经授权禁止转载】【关注微信公众号：wwwtangshuangnet】load时，该文件作为classWork【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。erURL传入

【作者：唐霜】

@ffmpeg/core/dist/es本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshuang.netm/ffmpeg-core.js 提供了【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net用于加载wasm和暴露接口的代码

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

未经授权，禁止复制转载。

【作者：唐霜】

@ffmpeg/core/dist/es未经授权，禁止复制转载。【作者：唐霜】m/ffmpeg-core.wasm 提【转载请注明来源】转载请注明出处：www.tangshuang.net供了wasm文件

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

【关注微信公众号：wwwtangshuangnet】

@ffmpeg/util/dist/es本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshuang.netm/index.js

【未经授权禁止转载】

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

【原创内容，转载请注明出处】

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

如何快速部署？

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

当你把文件夹上传后，你可以通过类似 /f【本文首发于唐霜的博客】【关注微信公众号：wwwtangshuangnet】fmpeg.wasm/ffmpeg/di本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】st/esm/classes.js 的路【本文受版权保护】【本文受版权保护】径访问到这些文件。

注意，这里的做法是标准做法，到目前为止，【转载请注明来源】【本文首发于唐霜的博客】你不要想着其他方式，你的目的是先跑起来。

【本文受版权保护】【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】

执行代码

接下来，你就可以在你自己的代码中开始使用转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】ffmpeg.wasm了。

【转载请注明来源】【访问 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原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】实例，考虑只需要加载一次这些必要文件等等【版权所有】唐霜 www.tangshuang.net【转载请注明来源】，这里只是为了方便演示，使得代码非常清晰【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.net，才这么给了一个函数（虽然它也是正确的代【转载请注明来源】【关注微信公众号：wwwtangshuangnet】码）。

部署在CDN上

很多项目部署方案不是前端团队自己出的，j未经授权，禁止复制转载。未经授权，禁止复制转载。s代码必须部署在CDN上。这就遇到跨域的著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】问题了。

【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】

【本文受版权保护】【原创不易，请尊重版权】

首先，你需要在CDN后台，调整跨域策略，【原创内容，转载请注明出处】原创内容，盗版必究。让你的网站可以通过CORS访问到这些脚本【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。。其次，你需要使用util中的toBlo本文作者：唐霜，转载请注明出处。【转载请注明来源】bURL来解决webworker的问题。

著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。

具体修改后的代码如下：

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;
}

通过上面这个修改，它会把这些脚本下载下来【原创内容，转载请注明出处】【原创内容，转载请注明出处】后，用blob:地址来挂载脚本，而web【关注微信公众号：wwwtangshuangnet】【转载请注明来源】worker支持在同域名下的blob:脚未经授权，禁止复制转载。【原创不易，请尊重版权】本作为worker脚本，这就解决了web未经授权，禁止复制转载。未经授权，禁止复制转载。worker实例化问题。

需要注意的是，上面这段业务代码的最终bu本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。ild，必须安装我前面说的方法，和必要文【未经授权禁止转载】【原创不易，请尊重版权】件们部署在一起，且都放在根目录下，否则你【作者：唐霜】【原创内容，转载请注明出处】又不知道文件路径该怎么填写了。

启用多线程

本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。【本文首发于唐霜的博客】【未经授权禁止转载】

【本文首发于唐霜的博客】【作者：唐霜】【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】

我们需要新安装一个包@ffmpeg/co【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.netre-mt，mt就是multiple t原创内容，盗版必究。本文作者：唐霜，转载请注明出处。hread的缩写。按照上面必要文件一节的本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】方法进行部署。接下来，直接进入到执行代码本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。处：

未经授权，禁止复制转载。未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。【关注微信公众号：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.nete-mt会使用到SharedArrayB本文作者：唐霜，转载请注明出处。【本文受版权保护】uffer来在多线程之间共享内存，然而，【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net要开启对SharedArrayBuffe【未经授权禁止转载】本文作者：唐霜，转载请注明出处。r的支持，则成本比较大。首先，你需要在你【关注微信公众号：wwwtangshuangnet】【版权所有，侵权必究】的主站点（也就是提供视频转换的站点）域名【转载请注明来源】【转载请注明来源】，开启如下两个headers：

【本文受版权保护】【作者：唐霜】【关注微信公众号：wwwtangshuangnet】

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

这才能让SharedArrayBuffe原创内容，盗版必究。转载请注明出处：www.tangshuang.netr在当前域名下工作。

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

原创内容，盗版必究。转载请注明出处：www.tangshuang.net原创内容，盗版必究。【原创内容，转载请注明出处】

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

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

本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。

通过iframe来提供多线程服务

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

写在最后

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

【未经授权禁止转载】【原创不易，请尊重版权】原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处：www.tangshuang.net原创内容，盗版必究。未经授权，禁止复制转载。【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。【转载请注明来源】【本文受版权保护】【原创不易，请尊重版权】【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。【作者：唐霜】【原创内容，转载请注明出处】【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。【转载请注明来源】【原创内容，转载请注明出处】【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】本文作者：唐霜，转载请注明出处。原创内容，盗版必究。【版权所有】唐霜 www.tangshuang.net【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。未经授权，禁止复制转载。【转载请注明来源】【关注微信公众号：wwwtangshuangnet】

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

唐霜

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

必要文件有哪些？

如何快速部署？

执行代码

部署在CDN上

启用多线程

通过iframe来提供多线程服务

写在最后

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

声明

关于

生态