ondh/novnc-proxy

noVNC Proxy Docker 镜像文档

镜像概述

noVNC Proxy 是一个轻量级的代理服务镜像，主要用于将传统的 VNC (Virtual Network Computing) 协议转换为 WebSocket 协议。通过该镜像，用户无需在本地安装任何 VNC 客户端，即可直接通过现代 Web 浏览器访问和控制远程 VNC 桌面服务。

核心功能和特性

• 协议转换：无缝将 VNC 协议（RFB）转换为 WebSocket 协议，适配 Web 浏览器的网络通信标准。
• 免客户端访问：终端用户只需一个支持 HTML5 的 Web 浏览器即可连接 VNC 服务器。
• 轻量高效：镜像体积小，资源占用低，启动迅速，非常适合容器化部署。
• 易于集成：通过简单的环境变量配置即可指向后端的 VNC 服务。

使用场景和适用范围

• 云桌面与远程办公：为远程用户提供基于浏览器的桌面访问能力。
• 容器化 GUI 应用：在 Docker 容器中运行带有图形界面的应用时，通过 noVNC 暴露 Web 访问接口。
• 远程服务器管理：在无法直接安装客户端的受限网络环境中，通过 Web 界面管理远程服务器的图形化控制台。

环境变量配置

该镜像通过环境变量来配置后端的 VNC 服务地址。

部署与使用示例

1. 使用 Docker Run 部署

假设您的 VNC 服务器运行在 192.168.1.100 的 5900 端口，可以使用以下命令启动 noVNC 代理：

bash
docker run -d \
  --name novnc-proxy \
  -p 8080:8080 \
  -e SERVER="192.168.1.100:5900" \
  novnc/novnc:latest

注：启动后，您可以通过浏览器访问 http://<宿主机IP>:8080/vnc.html 来连接 VNC 桌面。

2. 使用 Docker Compose 部署

如果您使用 Docker Compose 进行编排，可以参考以下 docker-compose.yml 配置：

yaml
version: '3.8'

services:
  novnc:
    image: novnc/novnc:latest
    container_name: novnc-proxy
    ports:
      - "8080:8080"
    environment:
      - SERVER=192.168.1.100:5900
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

注意事项

• 确保 noVNC 代理容器能够通过网络访问 SERVER 环境变量中指定的 VNC 服务器 IP 和端口。
• 如果 VNC 服务器和 noVNC 代理运行在同一个 Docker 网络中，SERVER 变量可以直接使用 VNC 容器的名称作为主机名（例如 vnc-server:5900）。
• 生产环境中建议结合 Nginx 等反向代理工具，为 noVNC 配置 HTTPS 和身份验证，以保障数据传输安全。