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

相关推荐
崔庆才丨静觅8 小时前
hCaptcha 验证码图像识别 API 对接教程
前端
passerby60618 小时前
完成前端时间处理的另一块版图
前端·github·web components
掘了9 小时前
「2025 年终总结」在所有失去的人中,我最怀念我自己
前端·后端·年终总结
崔庆才丨静觅9 小时前
实用免费的 Short URL 短链接 API 对接说明
前端
崔庆才丨静觅9 小时前
5分钟快速搭建 AI 平台并用它赚钱!
前端
崔庆才丨静觅9 小时前
比官方便宜一半以上!Midjourney API 申请及使用
前端
Moment9 小时前
富文本编辑器在 AI 时代为什么这么受欢迎
前端·javascript·后端
金刚猿10 小时前
01_虚拟机中间件部署_root 用户安装 docker 容器,配置非root用户权限
docker·中间件·容器
崔庆才丨静觅10 小时前
刷屏全网的“nano-banana”API接入指南!0.1元/张量产高清创意图,开发者必藏
前端
剪刀石头布啊10 小时前
jwt介绍
前端