bonigarcia/novnc

noVNC Docker镜像

镜像概述和主要用途

基于Alpine的独立noVNC客户端（可在https://hub.docker.com/r/bonigarcia/novnc获取）。该镜像允许通过环境变量自动连接VNC服务器、传递VNC密码以及设置仅查看模式，提供便捷的VNC远程访问能力。

核心功能和特性

• 独立运行：无需额外依赖，可直接部署使用
• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 环境变量配置：支持通过环境变量灵活配置，包括自动连接、密码认证和查看模式设置

使用场景和适用范围

适用于需要通过Web浏览器访问VNC服务器的场景，例如：

• 远程控制Docker容器中的图形界面应用（如Selenium浏览器实例）
• 对运行在服务器或容器中的VNC服务进行便捷访问和管理

使用方法和配置说明

部署示例

以下示例结合Selenium的Chrome Docker镜像（由https://github.com/SeleniumHQ/docker-selenium创建和维护，该镜像内置VNC服务器）演示使用流程：

1. 启动VNC服务器容器

bash
docker run --rm -p 4444:4444 -p 5900:5900 --net grid --name selenium --shm-size="2g" selenium/standalone-chrome:latest

参数说明：

• --rm：容器退出后自动删除
• -p 4444:4444：映射Selenium服务端口
• -p 5900:5900：映射VNC服务器端口
• --net grid：加入名为grid的网络（需提前创建或使用现有网络）
• --name selenium：指定容器名称为selenium
• --shm-size="2g"：设置共享内存大小（避免Chrome运行异常）

2. 启动noVNC容器

bash
docker run --rm --name novnc -p 6080:6080 --net grid -e AUTOCONNECT=true -e VNC_PASSWORD=secret -e VNC_SERVER=172.17.0.1:5900 bonigarcia/novnc:1.3.0

参数说明：

• --rm：容器退出后自动删除
• --name novnc：指定容器名称为novnc
• -p 6080:6080：映射noVNC的Web访问端口
• --net grid：加入与VNC服务器相同的网络（确保网络互通）
• -e：设置环境变量（具体说明见下文）

3. 访问noVNC服务

在浏览器中访问：http://localhost:6080/，即可通过Web界面连接到VNC服务器。

环境变量说明

关于

bonigarcia/novnc（Copyright © 2021-2025）是一个开源项目，由Boni García创建并维护，基于Apache 2.0 License许可。