You need to enable JavaScript to run this app. Docker容器内用Xvfb运行Puppeteer有头模式时X显示突然失效如何解决
优惠活动
大模型
产品
解决方案
定价
更多

Docker容器内用Xvfb运行Puppeteer有头模式时X显示突然失效如何解决

Docker容器内Puppeteer有头模式运行Xvfb异常问题

在Docker容器中运行Xvfb,可使Puppeteer网络爬虫以有头模式运行,目前已配置的文件与运行报错如下:

现有配置

Dockerfile

FROM node:15.11.0

RUN mkdir /code
WORKDIR /code
ADD . /code/

RUN apt-get update 
RUN apt-get install -y xvfb
RUN curl -LO https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
RUN apt-get install -y ./google-chrome-stable_current_amd64.deb
RUN rm google-chrome-stable_current_amd64.deb 

RUN npm install 

COPY init.sh /usr/local/bin/

RUN chmod u+x /usr/local/bin/init.sh

ENTRYPOINT ["init.sh"]

启动脚本init.sh

#!/bin/bash

xvfb-run node src/routines/infojobs/migrate-candidates.js

Puppeteer浏览器初始化代码

const browser = await puppeteer.launch({
    headless: false,
    slowMo: 50,
    args: ['--no-sandbox', '--no-first-run', '--disable-gpu'],
    path: '/usr/bin/google-chrome'
})

运行表现与报错

项目启动前数分钟可正常运行,之后异常中止,表现为Xvfb显示服务突然停止工作,核心报错信息:

/code/node_modules/puppeteer/lib/cjs/puppeteer/node/BrowserRunner.js:193
            reject(new Error([
                   ^

Error: Failed to launch the browser process!
Fontconfig warning: "/etc/fonts/fonts.conf", line 100: unknown element "blank"
[1802:1802:0322/141535.901385:ERROR:browser_main_loop.cc(1386)] Unable to open X display.

    at onClose (/code/node_modules/puppeteer/lib/cjs/puppeteer/node/BrowserRunner.js:193:20)
    at ChildProcess.<anonymous> (/code/node_modules/puppeteer/lib/cjs/puppeteer/node/BrowserRunner.js:184:79)
    at ChildProcess.emit (node:events:390:22)
    at Process.ChildProcess._handle.onexit (node:internal/child_process:290:12)
make: *** [Makefile:11: run] Error 1

根因说明

使用xvfb-run直接包裹Node进程的运行方式存在固有缺陷:

  • xvfb-run会为当前进程临时创建Xvfb实例,默认在主进程退出时自动清理服务;
  • 运行过程中如果出现内存不足、子进程异常退出等情况,会触发xvfb-run提前终止Xvfb服务,后续Puppeteer尝试启动浏览器实例时,就会因找不到可用X显示抛出报错。

修复方案

  • 调整init.sh启动逻辑,放弃xvfb-run的临时服务管理模式,改为后台常驻启动Xvfb,指定固定显示端口,待服务初始化完成后再启动Node进程,示例代码:
#!/bin/bash
# 后台启动Xvfb,使用固定显示号:99,配置1280x1024分辨率与24位色深
Xvfb :99 -screen 1280x1024x24 -nolisten tcp &
# 预留服务初始化时间
sleep 2
# 指定DISPLAY环境变量供Chrome读取
export DISPLAY=:99
# 启动业务进程
node src/routines/infojobs/migrate-candidates.js
  • 优化Puppeteer启动参数,补充--disable-dev-shm-usage配置,避免容器内/dev/shm共享内存空间不足导致Chrome崩溃,连带引发Xvfb服务异常退出。
  • 容器运行时根据业务量级分配足够的内存资源,避免因OOM(内存不足)机制触发系统回收Xvfb进程。

内容的提问来源于stack exchange,提问作者botechat

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 18:36:09