overclockedllama/docker-chromium

Chromium Docker容器

这是一个Chromium的Docker容器。

应用程序的图形界面（GUI）可通过现代Web浏览器（客户端无需安装或配置）或任何VNC客户端访问。

---

特别感谢@jlesage。此镜像基于https://github.com/jlesage/docker-firefox%E6%9E%84%E5%BB%BA%E3%80%82

---

!Chromium

---

目录

• Chromium Docker容器
  • 目录
  • 快速启动
  • 用法
    • 环境变量
    • 数据卷
    • 端口
    • 修改运行中容器的参数
  • Docker Compose文件
  • Docker镜像更新
    • 群晖（Synology）
    • unRAID
  • 用户/组ID
  • 访问图形界面
  • 安全性
    • SSVNC
    • 证书
    • VNC密码
  • 反向代理
    • 基于主机名的路由
    • 基于URL路径的路由
  • Shell访问
  • 增加共享内存大小
  • 声音支持
  • 通过环境变量设置Chromium偏好设置
  • 故障排除
    • 崩溃
  • 支持或联系

快速启动

注意：本快速启动中提供的Docker命令仅作为示例，参数应根据您的需求进行调整。

使用以下命令启动Chromium Docker容器：

docker run -d \
    --name=chromium \
    -p 5800:5800 \
    -v /docker/appdata/chromium:/config:rw \
    --shm-size 2g \
    overclockedllama/docker-chromium

其中：

• /docker/appdata/chromium：应用程序存储配置、日志和任何需要持久化的文件的位置。

通过浏览器访问http://您的主机IP:5800即可打开Chromium图形界面。

用法

docker run [-d] \
    --name=chromium \
    [-e <变量名>=<值>]... \
    [-v <主机目录>:<容器目录>[:权限]]... \
    [-p <主机端口>:<容器端口>]... \
    --shm-size <值> \
    overclockedllama/docker-chromium

环境变量

要自定义容器的某些属性，可以通过-e参数传递以下环境变量（每个变量一个-e）。该参数的值格式为<变量名>=<值>。

数据卷

下表描述了容器使用的数据卷。映射通过-v参数设置。每个映射的格式为<主机目录>:<容器目录>[:权限]。

端口

以下是容器使用的端口列表。可通过-p参数将它们映射到主机（每个端口映射一个-p）。每个映射的格式为<主机端口>:<容器端口>。容器内部的端口号无法更改，但您可以自由使用主机上的任何端口。

修改运行中容器的参数

如前所述，环境变量、卷映射和端口映射是在创建容器时指定的。

以下步骤描述了添加、删除或更新现有容器参数的方法。基本思路是销毁并重新创建容器：

1. 停止容器（如果正在运行）：

docker stop chromium

2. 删除容器：

docker rm chromium

3. 使用docker run命令创建/启动容器，根据需要调整参数。

注意：由于所有应用程序数据都保存在/config容器文件夹下，销毁并重新创建容器不会有问题：不会丢失任何数据，应用程序将恢复到相同状态（只要/config文件夹的映射保持不变）。

Docker Compose文件

以下是可与Docker Compose一起使用的docker-compose.yml文件示例。

请根据您的需求进行调整。注意示例中仅包含必要的网络端口。

yaml
version: '3'
services:
  chromium:
    image: overclockedllama/docker-chromium
    build: .
    ports:
      - "5800:5800"
    volumes:
      - "/docker/appdata/chromium:/config:rw"

Docker镜像更新

如果运行容器的系统没有提供简便的Docker镜像更新方法，可以按照以下步骤操作：

1. 获取最新镜像：

docker pull overclockedllama/docker-chromium

2. 停止容器：

docker stop chromium

3. 删除容器：

docker rm chromium

4. 使用docker run命令启动容器。

群晖（Synology）

对于群晖NAS用户，可以使用以下步骤更新容器镜像：

1. 打开Docker应用。
2. 点击左侧面板中的注册表。
3. 在搜索栏中，输入容器名称（overclockedllama/docker-chromium）。
4. 选择镜像，点击下载，然后选择latest标签。
5. 等待下载完成。完成后会出现通知。
6. 点击左侧面板中的容器。
7. 选择您的Chromium容器。
8. 点击操作->停止停止容器。
9. 点击操作->清除清除容器。这将删除容器但保留其配置。
10. 点击操作->启动再次启动容器。注意：容器在重新创建过程中可能会暂时从列表中消失。

unRAID

对于unRAID，可以通过以下步骤更新容器镜像：

1. 选择Docker选项卡。
2. 点击页面底部的检查更新按钮。
3. 点击需要更新的容器的update ready链接。

用户/组ID

使用数据卷（-v标志）时，主机和容器之间可能会出现权限问题。例如，容器内的用户可能在主机上不存在。这可能会阻止主机正确访问共享卷上的文件和文件夹。

为避免任何问题，您可以指定应用程序应运行的用户。

这是通过USER_ID和GROUP_ID环境变量将用户ID和组ID传递给容器来实现的。

要找到要使用的正确ID，请在主机上使用拥有主机上数据卷的用户执行以下命令：

id <用户名>

输出如下所示：

uid=1000(myuser) gid=1000(myuser) groups=1000(myuser),4(adm),24(cdrom),27(sudo),46(plugdev),113(lpadmin)

uid（用户ID）和gid（组ID）的值就是您应该提供给容器的值。

访问图形界面

假设容器的端口映射到主机的相同端口，则可以通过以下方式访问应用程序的图形界面：

• Web浏览器：

http://<主机IP地址>:5800

• 任何VNC客户端：

<主机IP地址>:5900

安全性

默认情况下，访问应用程序的GUI是通过未加密的连接（HTTP或VNC）进行的。

可以通过SECURE_CONNECTION环境变量启用安全连接。有关如何设置环境变量的更多详细信息，请参见环境变量部分。

启用后，通过浏览器访问应用程序的GUI时将通过HTTPS连接进行。所有HTTP访问将自动重定向到HTTPS。

使用VNC客户端时，VNC连接通过SSL进行。请注意，很少有VNC客户端支持此方法。SSVNC是其中之一。

SSVNC

SSVNC是一个为VNC连接添加加密安全性的VNC查看器。

虽然SSVNC的Linux版本运行良好，但Windows版本存在一些问题。在撰写本文时，最新版本1.0.30无法正常工作，连接失败并显示以下错误：

ReadExact: Socket error while reading

但是，为了您的方便，这里提供了一个非官方的工作版本：

https://github.com/jlesage/docker-baseimage-gui/raw/master/tools/ssvnc_windows_only-1.0.30-r1.zip

与官方软件包的唯一区别是捆绑的stunnel版本已升级到5.49，从而修复了连接问题。

证书

以下是容器所需的证书文件。默认情况下，当它们缺失时，将生成并使用自签名证书。所有文件均为PEM编码的x509证书。

注意：为防止浏览器或VNC客户端出现任何证书有效性警告/错误，请确保提供您自己的有效证书。

注意：证书文件会被监控，当检测到更改时，相关守护进程会自动重启。

VNC密码

要限制对应用程序的访问，可以指定密码。这可以通过两种方法完成：

• 使用VNC_PASSWORD环境变量。
• 在/config卷的根目录创建一个.vncpass_clear文件。该文件应包含明文密码。容器启动期间，文件内容将被混淆并移动到.vncpass。

VNC密码提供的安全级别取决于两件事：

• 通信通道的类型（加密/未加密）。
• 主机访问的安全性。

使用VNC密码时，强烈建议启用安全连接，以防止密码在未加密通道上明文传输。

注意：密码限制为8个字符。此限制来自远程帧缓冲协议RFC（参见7.2.2部分）。超过限制的任何字符都将被忽略。

反向代理

以下部分包含需要添加到NGINX配置中以反向代理到此容器的配置。

反向代理服务器可以基于主机名或URL路径路由HTTP请求。

基于主机名的路由

在此场景中，每个主机名路由到不同的应用程序/容器。

例如，假设反向代理服务器与该容器运行在同一台机器上。服务器会将所有发送到chromium.domain.tld的HTTP请求代理到127.0.0.1:5800的容器。

以下是要添加到NGINX配置中的相关配置元素：

map $http_upgrade $connection_upgrade {
	default upgrade;
	''      close;
}

upstream docker-chromium {
	# 如果反向代理服务器与Docker容器不在同一台机器上，请在此处使用Docker主机的IP。
	# 确保根据容器的5800端口在主机上的映射方式调整端口。
	server 127.0.0.1:5800;
}

server {
	[...]

	server_name chromium.domain.tld;

	location / {
	        proxy_pass http://docker-chromium;
	}

	location /websockify {
		proxy_pass http://docker-chromium;
		proxy_http_version 1.1;
		proxy_set_header Upgrade $http_upgrade;
		proxy_set_header Connection $connection_upgrade;
		proxy_read_timeout 86400;
	}
}

基于URL路径的路由

在此场景中，主机名相同，但使用不同的URL路径路由到不同的应用程序/容器。

例如，假设反向代理服务器与该容器运行在同一台机器上。服务器会将所有server.domain.tld/chromium的HTTP请求代理到127.0.0.1:5800的容器。

以下是要添加到NGINX配置中的相关配置元素：

map $http_upgrade $connection_upgrade {
	default upgrade;