Minimal Chromium with KasmVNC/noVNC, CDP, and Clipboard sync
8.9K
轻量、安全加固且深度调优的 Dockerized Chromium 远程节点容器方案,专为 AI Agent、自动化测试(Playwright / Puppeteer)以及分布式 CDP 集群 打造。
提供 noVNC 版 (chromium_novnc) 与 KasmVNC 流媒体版 (chromium_kasmvnc) 双引擎,统一复用 common/edge_node_client.py 接入 chromium_sync 主控网关。
dumb-init + gosu -> UID/GID 1000):
dumb-init 拉起 entrypoint.sh 完成 /data 权限自愈,并将宿主机 /certs 中宝塔/Certbot 的 0600 root 私钥安全复制合成到容器内 /etc/ssl/app/(绝不修改宿主机 /certs 属主与权限)。exec gosu 彻底替换进程,随后 Xvnc、openbox、novnc_proxy、edge_node_client.py 与 Chromium 全部以非特权用户(noVNC 为 appuser:1000,KasmVNC 为 kasm-user:1000)运行,无任何常驻 root 进程。py-builder / builder 阶段隔离构建 /opt/venv(节点端轻量代理 edge_node_client.py 仅依赖 httpx + websockets,剔除节点未使用的 wimotek-edge-agent 与 pip 缓存);tzdata 并仅提取 /etc/localtime 与 /etc/timezone 两个时区文件进入运行层,免除整包 /usr/share/zoneinfo 体积;tini、curl、wget、procps、net-tools 等冗余工具,并清理 apt 缓存、/var/log、/usr/share/doc、/usr/share/man 与 noVNC 测试文档,压缩镜像体积与攻击面。dumb-init (PID 1) 信号转发与 Python 原生 HEALTHCHECK:
ENTRYPOINT ["/usr/bin/dumb-init", "--", "/entrypoint.sh"] 自动回收 Chromium 崩溃产生的僵尸进程并转发 SIGTERM/SIGINT;curl,容器每 30 秒通过内置 Python 校验 http://127.0.0.1:9222/json/version(CDP)与 VNC 端口可用性(6080 / 6901)。9443) 对称选路(协议对齐 Hub 端 wimotek-edge-agent >= 1.0.17):
9222 严格仅监听容器内部 127.0.0.1:9222(绝不直接暴露到公网);默认不启动 socat 转发,仅在显式设置 CDP_FORWARD_PORT(或 ENABLE_CDP_FORWARD=true)时才启用 socat 将指定端口(默认 9223)转发至 127.0.0.1:9222;X-Edge-Auth 密钥鉴权 WSS 服务端(默认 EDGE_WSS_PORT=9443),启动后上报公网 IPv4 / IPv6 与 9443 端口给 Hub (POST /api/nodes/detect-mode),由 Hub 调用 wimotek-edge-agent 执行并发 TCP 三次握手(完全兼容 Oracle / 云主机的 1:1 NAT 内网网卡);public_wss(Hub 主动入站 wss://<节点IP>:9443/ws),不可达则自动关闭入站监听并回落为 reverse(节点出站连 wss://<Hub>/api/nodes/reverse-tunnel)。ExtendedClipboard UTF-8 中文传输),内置 clipboard-sync.js 自动桥接浏览器 navigator.clipboard(HTTPS 下窗口聚焦、点击画布或 Ctrl+V / macOS Cmd+V 自动将本地剪贴板推送到远程;远程 Ctrl+C 复制自动回写本地剪贴板),后端配合 vncconfig -nowin + autocutsel 及 -SendPrimary=0 防止鼠标划选误覆盖本地剪贴板;data_loss_prevention.clipboard 配置(禁用 primary_clipboard_enabled 防误触)+ autocutsel 同步;若处于纯 HTTP 非安全上下文,可通过底部工具栏「剪贴板助手」或 noVNC 侧边栏手动同步。Wimotek-Dark) + tint2 快捷工具栏 + fcitx5 拼音输入法:
tint2):默认位于底部(可通过右键菜单或 PANEL_POSITION=top 切换至顶部);左侧一键快捷按钮(新建 Chromium 窗口、无痕窗口、UTF-8 终端、剪贴板助手、安全重启 Chromium),中部实时任务栏,右侧托盘与时钟;fcitx5 + fcitx5-pinyin(KasmVNC 版默认内置,noVNC 版默认不安装以保持极简,可通过 --build-arg ENABLE_IME=true 开启),开启后按 Ctrl+Space 或点击托盘图标切换中文拼音/英文输入;② Openbox 菜单语言切换:右键桌面菜单支持一键在中/英文之间切换(或通过 OPENBOX_LANG=en 指定);Wimotek-Dark 为深色窗口标题栏与右键菜单主题;支持 Win+← / Win+→ 左右半屏分屏、Win+D 显示桌面、Alt+F11 全屏、Ctrl+Alt+T 终端、Ctrl+Alt+N 新窗口与 Alt+左/右键拖拽 移动缩放。| 特性维度 | noVNC 极简版 (chromium_novnc) | KasmVNC 流媒体版 (chromium_kasmvnc) |
|---|---|---|
| 底层渲染引擎 | TigerVNC Standalone (Xvnc) | KasmVNC Server v1.3.3 |
| Web 访问端口 | HTTP: 6080 / HTTPS: 6443 | HTTPS: 6901 |
| 加密 WSS 服务端口 | 双栈鉴权 WSS 9443(内部桥接 127.0.0.1:9222) | 双栈鉴权 WSS 9443(内部桥接 127.0.0.1:9222) |
| Init 守护进程 | dumb-init (PID 1) | dumb-init (PID 1) |
| 安全运行模型 | Root-Init-Drop (gosu appuser, UID 1000) | Root-Init-Drop (gosu kasm-user, UID 1000) |
| VNC 登录账号 | VNC 密码认证 (VNC_PASSWORD) | VNC_USER (默认 kasm-user) + VNC_PASSWORD |
chromium_novnc 与 chromium_kasmvnc 构建前(如 GitHub Actions 流水线)需将共用 common/edge_node_client.py 与定制桌面配置 common/desktop/ 复制到对应引擎目录后直接执行本地构建:
# 构建 noVNC 节点镜像
cp common/edge_node_client.py chromium_novnc/edge_node_client.py
rm -rf chromium_novnc/desktop && cp -r common/desktop chromium_novnc/desktop
docker build -t wimotek/chromium:novnc ./chromium_novnc
# 构建 KasmVNC 节点镜像 (支持 amd64 / arm64)
cp common/edge_node_client.py chromium_kasmvnc/edge_node_client.py
rm -rf chromium_kasmvnc/desktop && cp -r common/desktop chromium_kasmvnc/desktop
docker build -t wimotek/chromium:kasmvnc ./chromium_kasmvnc
如需自定义构建 UID/GID 或开启/关闭中文拼音输入法(ENABLE_IME 在 chromium_novnc 默认为 false、在 chromium_kasmvnc 默认为 true):
# 例:为 noVNC 版启用内置 fcitx5 中文拼音输入法
docker build --build-arg ENABLE_IME=true \
-t wimotek/chromium:novnc ./chromium_novnc
# 例:自定义宿主机 UID/GID
docker build --build-arg PUID=$(id -u) --build-arg PGID=$(id -g) \
-t wimotek/chromium:novnc ./chromium_novnc
默认启动容器时,阶段 1 会自动:
/data 目录修正为 1000:1000,解决宿主机事先用 root 创建目录导致 Chromium 无法写入 SingletonLock 的问题;/certs(包括宝塔面板 /www/server/panel/vhost/cert/<域名> 或 Certbot /etc/letsencrypt/live/<域名> 下权限为 0600 root:root 的私钥),复制到容器内部 /etc/ssl/app 并设为 600 归属 UID 1000,不会对宿主机 /certs 执行任何写或 chown 操作;exec gosu 彻底降权至 UID 1000 启动服务。因此标准 Linux 宿主机通常只需挂载专属子目录即可(切勿直接将共享父目录 /home/docker 整目录映射给 /data,否则自愈阶段 chown -R 会改写同级其他项目文件属主):
# 推荐:为每个节点分配独立子目录
-v /home/docker/chromium_novnc:/data \
-v /www/server/panel/vhost/cert/yourdomain.com:/certs:ro
- 宿主机
/home/docker父目录权限要求:标准 Docker 绑定挂载子目录(/home/docker/chromium_novnc:/data)时,/home/docker本身保持常见755(或711/750)即可,只要宿主机子目录所在文件系统支持chown(本地 ext4/xfs 均支持,NFS 需开启no_root_squash),容器阶段 1 会自动将/data自愈为1000:1000(rwx)。- 若宿主机目录已存放大量历史数据,建议提前手动授权以加快首次启动:
chown -R 1000:1000 /home/docker/chromium_novnc && chmod -R 750 /home/docker/chromium_novnc。
--user 1000:1000 / Rootless / SELinux / 磁盘满排查--user 1000:1000 跳过阶段 1 时:需提前在宿主机执行 chown -R 1000:1000 /home/docker/chromium_novnc;若同时需要读取 0600 root 证书,需在宿主机使用 setfacl -m u:1000:r ... 或导出 1000:1000 属主副本后再挂载,否则将自动回退至自签证书。:Z(如 -v /home/docker/chromium_novnc:/data:Z -v /path/to/certs:/certs:ro,Z)。docker unshare chown -R 1000:1000 /home/docker/chromium_novnc。No space left on device / Fontconfig error / Chromium 无限重启:此报错是宿主机磁盘或 inode 耗尽(df -h / df -i),或未配置 --shm-size="2gb" 导致 /dev/shm(默认 64MB)写满。清理磁盘(docker system prune -af / 清理旧容器与日志)后,容器入口已内置 /dev/shm < 512MB 自动兜底 --disable-dev-shm-usage。docker run -d \
--name chromium-novnc \
-p 6080:6080 \
-p 6443:6443 \
-p 9443:9443 \
-e VNC_PASSWORD="MySecurePassword123" \
-e RESOLUTION=1920x1080 \
-e HUB_URL="https://hub.yourdomain.com:8443" \
-e JOIN_TOKEN="hub_join_xxxxxxxxxxxxxxxxxxxx" \
-v /home/docker/chromium_novnc:/data \
-v /www/server/panel/vhost/cert/yourdomain.com:/certs:ro \
--shm-size="2gb" \
--restart unless-stopped \
wimotek/chromium:novnc \
https://www.google.com
docker run -d \
--name chromium-kasm \
-p 6901:6901 \
-p 9443:9443 \
-e VNC_PASSWORD="MySecurePassword123" \
-e RESOLUTION=1920x1080 \
-e HUB_URL="https://hub.yourdomain.com:8443" \
-e JOIN_TOKEN="hub_join_xxxxxxxxxxxxxxxxxxxx" \
-v /home/docker/chromium_kasmvnc:/data \
-v /www/server/panel/vhost/cert/yourdomain.com:/certs:ro \
--shm-size="2gb" \
--restart unless-stopped \
wimotek/chromium:kasmvnc \
https://www.google.com
| 变量 | 默认值 | 说明 |
|---|---|---|
RESOLUTION | 1920x1080 | 桌面与 Chromium 视口分辨率 |
VNC_PASSWORD | (空) | VNC 访问密码(留空则免密) |
VNC_USER | kasm-user | KasmVNC 登录用户名 |
CHROME_ARGS | (空) | 追加到 Chromium 的额外命令行 Flag |
HUB_URL | (空) | chromium_sync Hub 地址,配置后自动激活 edge_node_client.py |
JOIN_TOKEN | (空) | 集群入网通行码(留空走 Hub TOFU 待审流程) |
REVERSE_TUNNEL | (auto) | 留空自动对 WSS 9443 端口 TCP 探测;true 强制反向隧道;false 强制公网 WSS 直连 |
PUBLIC_IPV4 / PUBLIC_IPV6 | 自动嗅探 | 手动指定节点上报给 Hub 探测的公网 IPv4 / IPv6 |
EDGE_WSS_PORT | 9443 | 节点容器内部监听的双栈鉴权加密 WSS 服务端口 |
EDGE_WSS_EXTERNAL_PORT | EDGE_WSS_PORT | 宿主机映射到公网的 WSS 端口(如 -p 19443:9443 时填 19443;兼容旧变量 DIRECT_PORT) |
CDP_FORWARD_PORT | (空,不启用) | 可选 socat 明文 CDP 转发端口;仅设置后才启动 socat 转发到 127.0.0.1:9222(填 true 默认使用 9223,或填自定义端口号;也支持 ENABLE_CDP_FORWARD=true) |
OPENBOX_LANG | zh | Openbox 桌面右键菜单默认语言(zh 中文 / en 英文,支持右键一键切换) |
PANEL_POSITION | bottom | tint2 快捷工具栏默认停靠位置(bottom 底部 / top 顶部,支持右键一键切换) |
TZ | Asia/Shanghai | 构建期 --build-arg TZ=... 与运行时默认时区(分阶段仅提取 /etc/localtime 与 /etc/timezone) |
Content type
Image
Digest
sha256:a8429b5a7…
Size
393.8 MB
Last updated
about 12 hours ago
docker pull wimotek/chromium