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

相关推荐
大怪v7 小时前
AI抢饭?前端佬:我要验牌!
前端·人工智能·程序员
新酱爱学习7 小时前
字节外包一年,我的技术成长之路
前端·程序员·年终总结
小兵张健7 小时前
开源 playwright-pool 会话池来了
前端·javascript·github
IT_陈寒10 小时前
Python开发者必知的5大性能陷阱:90%的人都踩过的坑!
前端·人工智能·后端
Sheffield11 小时前
Docker的跨主机服务与其对应的优缺点
linux·网络协议·docker
codingWhat11 小时前
介绍一个手势识别库——AlloyFinger
前端·javascript·vue.js
代码老中医11 小时前
2026年CSS彻底疯了:这6个新特性让我删掉了三分之一JS代码
前端
不会敲代码111 小时前
Zustand:轻量级状态管理,从入门到实践
前端·typescript
踩着两条虫11 小时前
VTJ.PRO 双向代码转换原理揭秘
前端·vue.js·人工智能
扉川川11 小时前
OpenClaw 架构解析:一个生产级 AI Agent 是如何设计的
前端·人工智能