bpmonline/chrome-vnc

无头VNC会话Docker容器镜像

镜像概述和主要用途

该Docker镜像提供包含"headless" VNC会话的容器环境，允许用户通过VNC协议或Web浏览器访问远程桌面。主要用于需要图形化界面的应用测试、自动化操作、远程访问等场景，无需本地安装桌面环境即可获得完整的图形化操作体验。

核心功能和特性

• 支持VNC协议连接（默认端口5901）
• 提供noVNC HTML5客户端支持Web访问（默认端口6901）
• 可自定义VNC密码、屏幕分辨率和颜色深度
• 支持用户身份自定义，可指定容器内用户和组ID
• 提供交互式bash终端访问

使用场景和适用范围

• 应用程序图形界面测试
• 自动化脚本运行（需要图形化环境）
• 远程桌面访问
• 开发环境共享
• 浏览器自动化操作（基于Chrome）

使用方法和配置说明

基本使用

打印帮助页面

bash
docker run bpmonline/chrome-vnc --help

启动容器（默认配置）

映射VNC协议端口（5901）和Web访问端口（6901）：

bash
docker run -d -p 5901:5901 -p 6901:6901 bpmonline/chrome-vnc

自定义用户和组

指定容器内用户ID和组ID，避免权限问题：

bash
docker run -d -p 5901:5901 -p 6901:6901 --user $(id -u):$(id -g) bpmonline/chrome-vnc

交互式终端访问

以交互模式进入容器bash终端：

bash
docker run -it -p 5901:5901 -p 6901:6901 bpmonline/chrome-vnc bash

连接与控制

容器启动后，可通过以下方式连接：

• VNC viewer连接：localhost:5901，默认密码：vncpassword
• noVNC HTML5完整客户端：http://localhost:6901/vnc.html%EF%BC%8C%E9%BB%98%E8%AE%A4%E5%AF%86%E7%A0%81%EF%BC%9A%60vncpassword%60
• noVNC HTML5轻量客户端：http://localhost:6901/?password=vncpassword

自定义配置

覆盖VNC环境变量

可在docker run时通过环境变量自定义桌面环境，支持以下变量：

• VNC_COL_DEPTH：颜色深度，默认值：24
• VNC_RESOLUTION：屏幕分辨率，默认值：1280x1024
• VNC_PW：VNC访问密码，默认值：my-pw

示例1：修改VNC密码

bash
docker run -it -p 5901:5901 -p 6901:6901 -e VNC_PW=my-new-password bpmonline/chrome-vnc

示例2：修改屏幕分辨率

bash
docker run -it -p 5901:5901 -p 6901:6901 -e VNC_RESOLUTION=1920x1080 bpmonline/chrome-vnc