如何在Puppeteer中使用已有的Firefox配置文件？

前置准备 #

首先找到你本地的 Firefox 配置文件路径，不同系统默认路径如下：

• Windows：%APPDATA%\Mozilla\Firefox\Profiles\随机字符串.default-release
• macOS：~/Library/Application Support/Firefox/Profiles/随机字符串.default-release
• Linux：~/.mozilla/firefox/随机字符串.default-release

你也可以打开 Firefox 地址栏输入about:profiles，找到正在使用的配置对应的「根目录」路径直接复制即可。

代码实现 #

确保你已经安装了支持 Firefox 的 Puppeteer 依赖：

npm install puppeteer

核心调用代码示例：

const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch({
    // 指定启动 Firefox 而非默认的 Chrome
    product: 'firefox',
    // 替换为你前面复制的配置文件绝对路径
    userDataDir: '/替换为你自己的配置文件路径/xxxx.default-release',
    // 测试阶段建议关闭无头模式，确认配置加载正常后可改为 'new' 使用无头模式
    headless: false
  });

  const page = await browser.newPage();
  // 可跳转 about:profiles 验证是否成功加载目标配置
  await page.goto('about:profiles');

  // 此处写入你的业务逻辑代码

  // 用完后关闭浏览器
  // await browser.close();
})();

注意事项 #

• 确保没有其他 Firefox 进程正在使用你要调用的配置文件，文件锁会导致加载失败
• 如果原配置文件设置了主密码，需要先删除主密码，否则启动时会弹出密码输入框阻塞执行
• 不要在启动参数中添加--proxy-server、--incognito等会覆盖原有配置的参数，避免你预设的代理、Cookie、扩展被覆盖
• 如果扩展加载异常，先把headless设为false测试，确认扩展在可视化模式下正常后再切换为'new'无头模式

内容的提问来源于stack exchange，提问作者Vadim Guslistov