一个用于在虚拟桌面下跑chrome的docker镜像

制作了一个用于跑chrome的docker镜像xvfb-chrome,主要是为了支持能够通过xvfb或者wayland,给chrome提供一个虚拟的桌面环境。

这个镜像主要支持:

  • 将chrome --remote-debugging-port映射到docker的host,可以在host直接访问。
  • 支持使用非root用户运行chrome(无需--no-sandbox运行chrome)。
  • 支持使用虚拟桌面运行chrome,支持xvfb和wayland。
  • 减少open /sys/devices/system/cpu/cpu0/cpufreq/scaling_cur_freq: No such file or directory (2)错误的发生。
  • 支持将字体目录映射到容器中。

这个容器可以通过如下方式获取(tag即为chrome的版本号)

复制代码
# 获取最新版本
docker pull socrateslee/xvfb-chrome:latest
# 获取某个具体版本,支持版本件https://hub.docker.com/r/socrateslee/xvfb-chrome/tags
docker pull socrateslee/xvfb-chrome:125.0.6422.141-1

主要的使用方法如下

通过一些例子来介绍一下容器的使用方法:

  • 以headless 方式启动chrome

    sudo docker run --rm -it
    -v $(pwd):/workdir --workdir /workdir
    --cap-add=SYS_ADMIN
    socrateslee/xvfb-chrome:latest
    --headless <URL>

  • 以xvfb方式启动,指定 --remote-debugging-port(方便selenium/chromedp/playwright等连接):

    sudo docker run --rm -it
    -v $(pwd):/workdir --workdir /workdir
    --cap-add=SYS_ADMIN
    -p 9222:9222
    socrateslee/xvfb-chrome:latest
    --xvfb-run --remote-debugging-port=9222

  • 通过wayland方式启动:

    sudo docker run --rm -it
    -v $(pwd):/workdir --workdir /workdir
    --cap-add=SYS_ADMIN
    -p 9222:9222
    socrateslee/xvfb-chrome:latest
    --wayland --remote-debugging-port=9222 --disable-gpu

  • 指定字体目录(可以先把*.ttf字体下载到<YOUR_FONTS_DIR>这个目录中)

    sudo docker run --rm -it
    -v <YOUR_FONTS_DIR>:/home/chrome/.fonts
    -v $(pwd):/workdir --workdir /workdir
    --cap-add=SYS_ADMIN
    -p 9222:9222
    socrateslee/xvfb-chrome:latest
    --headless=new --print-to-pdf <URL>

其他注意事项

一些版本的chrome,或者是跑在一些特殊环境中,通过虚拟桌面启动的chrome可能遇到如下的错误,此时chrome会hang住,无法建立有效的websocket连接,只能重启重启解决

复制代码
[0707/070947.640825:ERROR:file_io_posix.cc(145)] open /sys/devices/system/cpu/cpu0/cpufreq/scaling_cur_freq: No such file or directory (2)
[0707/070947.640877:ERROR:file_io_posix.cc(145)] open /sys/devices/system/cpu/cpu0/cpufreq/scaling_max_freq: No such file or directory (2)

启动容器时,指定 --wayland 参数,增加 --disable-gpu 参数,有时可以显著的减少这个问题的发生(但是无法避免)。

相关推荐
IT_陈寒4 分钟前
SpringBoot配置加载顺序把我坑惨了
前端·人工智能·后端
kyriewen6 分钟前
Next.js部署:从本地跑得欢,到线上飞得稳
前端·react.js·next.js
Moment11 分钟前
面试官:给 llm 传递上下文,有哪几个身份 role ❓❓❓
前端·后端·面试
跨境数据猎手20 分钟前
跨境独立站系统技术拆解(附带源码)
服务器·前端·php
豹哥学前端31 分钟前
用猜数字游戏,一口气掌握 JavaScript 核心知识点(附完整代码)
前端·javascript
忆往wu前1 小时前
从0到1一步步拆解搭建,梳理一个 Vue3 简易图书后台全开发流程
前端·javascript·vue.js
木斯佳1 小时前
前端八股文面经大全:字节抖音前端三面(2026-04-27)·面经深度解析
前端·面试·笔试·八股·面经
光影少年1 小时前
大屏页面,一次多个请求,请求加密导致 点击 全局时间选择器 时出现卡顿咋解决(面板收起会延迟1~2秒)
前端·javascript·vue.js·学习·前端框架·echarts·reactjs
Mr.mjw2 小时前
vue中封装一个环形进度条组件,根据外部盒子大小自适应变化
前端·javascript·vue.js
无心使然2 小时前
Openlayers调用ArcGis影像服务之一动态地图、地图切片(/exportImage)
前端·javascript·数据可视化