You need to enable JavaScript to run this app. ffmpeg捕获xvfb-run下Puppeteer虚拟屏推RTMP仅得部分画面该如何解决
优惠活动
大模型
产品
解决方案
定价
更多

ffmpeg捕获xvfb-run下Puppeteer虚拟屏推RTMP仅得部分画面该如何解决

虚拟X11屏捕获不全的核心原因与修复方案

常见触发问题的硬伤点

  • 虚拟屏分辨率配置超出Xvfb的帧缓冲上限:你当前配置的1024x8000x24单屏纵向8000像素,远超Xvfb默认mmap映射的显存阈值,实际启动后Xvfb根本没分配对应尺寸的帧缓冲,根窗口实际可用区域远小于命令行声明的数值,自然只能抓到部分内容。业务场景没必要堆超高单屏分辨率,真需要长内容展示可以靠滚动加载拼接,单屏设成1920x1080这类常规尺寸即可,从根源避免帧缓冲分配失败。
  • x11grab捕获范围未显式指定:-f x11grab如果不传-video_size和坐标偏移参数,会自动读取X服务端内置的默认可视区域(通常是左上角固定尺寸块),哪怕虚拟屏实际分辨率更高,它也只会抓默认块的内容。你之前命令里加的-s 384x216更是直接把捕获输出硬缩成极小尺寸,完全没法覆盖全屏。
  • 显示号配置冲突:你同时给xvfb-run传了-n 99固定号和-a自动选空闲号参数,实际如果:99被占用,xvfb-run会自动切到别的空闲显示号(比如:100),但你后续ffmpeg仍在硬抓:99,抓到的是旧残留虚拟屏的内容,根本不是运行Puppeteer的那个屏幕。
  • 无窗口管理器导致窗口不铺满:纯Xvfb环境没有内置窗口管理器,Chrome的kiosk模式无法识别根窗口边界,只会默认开个小尺寸悬浮窗,哪怕虚拟屏配置再大,抓到的也只是这个小窗口的范围。
  • Puppeteer脚本存在逻辑bug:代码里直接用未初始化的this.browser对象,实际启动时会直接抛错,Puppeteer根本没正常加载页面,自然没法生成可捕获的完整画面。

可直接落地的修复步骤

  1. 替换xvfb-run的启动逻辑,先单独固定启动Xvfb服务,避免自动切号的问题:
    执行命令启动固定显示号的虚拟屏,分辨率匹配实际业务需求:
    Xvfb :99 -screen 0 1920x1080x24 -ac -nolisten tcp -dpi 96 +extension RANDR &
  2. 在虚拟屏环境启动轻量窗口管理器,保证kiosk模式能铺满全屏:
    openbox &
  3. 修正Puppeteer脚本的逻辑错误,对齐窗口尺寸与虚拟屏匹配:
    核心修正部分如下:
    let browser;
    let initPuppeteer = async () => {
      const launchArgs = [
        '--window-size=1920,1080',
        '--disable-web-security',
        '--disable-features=IsolateOrigins',
        '--disable-site-isolation-trials',
        '--app',
        '--kiosk',
        '--no-sandbox',
      ]
      browser = await puppeteer.launch({
        headless: false, 
        ignoreDefaultArgs: ["--enable-automation"], 
        args: launchArgs,
        defaultViewport: null // 强制页面尺寸跟随实际窗口大小
      });
      const page = await browser.newPage();
      await page.goto("https://google.com");
    }
    initPuppeteer()
    
  4. 调整ffmpeg捕获参数,显式指定捕获范围避免自动取块:
    先不要直接推流,先抓单帧本地验证捕获范围是否正确:
    ffmpeg -f x11grab -video_size 1920x1080 -i :99+0.0 -frames:v 1 screen_check.png
    打开生成的screen_check.png,确认是完整的全屏画面后,再补全推流、音频相关的参数。x11grab的坐标偏移格式为:显示号+x偏移.y偏移,必须跟在显示号后面才会生效。

额外避坑提示

  • 单虚拟屏分辨率不要超过2560x1440,按每像素4字节计算,超过这个尺寸很容易触发Xvfb的内存映射失败,导致实际屏幕尺寸缩水。
  • 早期调试阶段尽量先把捕获内容存成本地文件/图片验证,确认捕获范围正确后再接入RTMP推流、播放的链路,能快速排除是捕获端还是推流播放端的问题。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.25 22:15:07