一个用于在虚拟桌面下跑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

  • 以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

其他注意事项

一些版本的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 参数,有时可以显著的减少这个问题的发生(但是无法避免)。

相关推荐
北城笑笑几秒前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
程序员韩星25 分钟前
OpenAI 兼容接口返回 404,先查请求地址,再查模型名
前端·人工智能·http
Patrick_Wilson26 分钟前
构建通过了,为什么有些浏览器还会白屏?
前端·javascript·浏览器
其实防守也摸鱼1 小时前
用 Claude Code 重构遗留系统:从评估到落地的完整指南
前端·网络·人工智能·chrome·安全·重构
七仔啊1 小时前
CNC计算机数控加工模拟器
前端
张一凡932 小时前
你的 AGENTS.md,真的管到模型写代码了吗?
前端·后端·agent
Brookty2 小时前
CSS基础知识(一):选择器、优先级、层叠与继承、边框属性及盒模型
前端·css
颜进强2 小时前
微信小微AI-灰度与命中排查|代码全对、版本已发,为什么同事就是问不中?
前端·ai编程·全栈
verohh2 小时前
从代码组织到功能抽象:AI 时代的前端工程架构设计
前端
颜进强2 小时前
微信小微AI-评测|文档质量直接被判 0 分:小微团队评测那些没人告诉你的硬指标
前端·ai编程·全栈