一个用于在虚拟桌面下跑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 参数,有时可以显著的减少这个问题的发生(但是无法避免)。

相关推荐
Moshow郑锴3 分钟前
从 “瞎埋点” 到 “精准分析”:WebTagging 设计 + 页面埋点指南(附避坑清单)
前端
非凡ghost14 分钟前
PixPin截图工具(支持截长图截动图) 中文绿色版
前端·javascript·后端
૮・ﻌ・22 分钟前
Vue2(一):创建实例、插值表达式、Vue响应式特性、Vue指令、指令修饰符、计算属性
前端·javascript·vue.js
半生过往1 小时前
2025 前端动效实战指南:Vue Bits & React Bits 深度拆解(功能 / 复用 / 高频问题处理)
前端·vue.js·react.js
程序员包打听1 小时前
Vitest 4.0 重磅发布:Browser Mode 正式稳定,前端测试进入新纪元
前端
BumBle1 小时前
UniApp 多页面编译优化:编译时间从10分钟到1分钟
前端
星链引擎1 小时前
大语言模型的技术突破与稳定 API 生态的构建
前端
还是大剑师兰特1 小时前
TypeScript 面试题及详细答案 100题 (71-80)-- 模块与命名空间
前端·javascript·typescript
BumBle1 小时前
使用 SortableJS 实现vue3 + Element Plus 表格拖拽排序
前端·vue.js·element
玉宇夕落1 小时前
HTML5 音乐敲击乐静态界面
前端