rdvde/chromium

Chromium Docker镜像文档

镜像概述

本镜像提供了在Docker容器中运行Chromium浏览器的环境，通过容器化方式实现浏览环境的隔离与便携部署。支持持久化浏览器配置、共享本地下载目录、集成系统字体及本地显示输出，适用于需要临时或隔离浏览环境的场景。

核心功能与特性

• 持久化配置：通过挂载卷保存Chromium用户配置，实现浏览器设置、扩展和书签的持久化
• 本地资源整合：支持共享本地下载目录、系统字体，提供与主机一致的浏览体验
• 资源控制：可配置CPU、内存资源限制，避免过度占用主机资源
• 安全隔离：通过容器化隔离浏览环境，降低***网站对主机系统的风险
• 音频支持：挂载音频设备，实现浏览器音频输出
• X11显示集成：支持连接主机X11服务，实现图形界面显示

使用场景

• 需要临时使用Chromium浏览器且不想影响本地配置的场景
• 需隔离不同浏览环境（如工作/个人用途分离）的场景
• 开发或测试环境中需要标准化Chromium运行环境的场景
• 对主机安全性要求较高，希望通过容器隔离浏览活动的场景

使用方法

基本运行命令

bash
docker run -it --rm \
  --net host \
  --cpuset-cpus 0 \
  -c 512 -m 2096m \
  -e PGID=1000 -e PUID=1000 \
  -v $HOME/tools/chromium:/home/chromium/.config/chromium \
  -v $HOME/Downloads:/home/chromium/Downloads \
  -v /usr/share/fonts:/usr/share/fonts:ro \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  -e DISPLAY=unix$DISPLAY \
  --device /dev/snd \
  -v /dev/shm:/dev/shm \
  --name chromium \
  rdvde/chromium

参数说明

故障排除

若基本命令运行失败，需添加seccomp安全配置：

1. 下载chrome安全配置文件：

bash
wget https://raw.githubusercontent.com/jfrazelle/dotfiles/master/etc/docker/seccomp/chrome.json -O ~/chrome.json

2. 在运行命令中添加安全配置参数：

bash
docker run -it --rm \
  --net host \
  --cpuset-cpus 0 \
  -c 512 -m 2096m \
  -e PGID=1000 -e PUID=1000 \
  -v $HOME/tools/chromium:/home/chromium/.config/chromium \
  -v $HOME/Downloads:/home/chromium/Downloads \
  -v /usr/share/fonts:/usr/share/fonts:ro \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  -e DISPLAY=unix$DISPLAY \
  --device /dev/snd \
  -v /dev/shm:/dev/shm \
  --security-opt seccomp=$HOME/chrome.json \
  --name chromium \
  rdvde/chromium