dewgenenny/docker-headless-vnc-container

无头VNC会话的Docker容器镜像

本仓库包含一系列无头VNC环境的Docker镜像，支持多种操作系统和桌面会话。

镜像概述

该镜像集合提供基于CentOS7或Ubuntu的无头VNC环境，预装轻量级桌面环境（Xfce4/IceWM）、VNC服务器、noVNC HTML5客户端、主流浏览器及SSH客户端，可通过VNC协议或Web页面实现远程桌面访问。

核心功能

• 桌面环境：支持Xfce4（功能完整）和IceWM（轻量高效）两种选择
• VNC服务：默认端口5901，支持密码验证与权限控制
• Web访问：通过noVNC（默认端口6901）实现HTML5浏览器直接访问
• 工具集成：预装Firefox/Chromium浏览器及SSH客户端，满足基础操作需求

使用场景

• 远程桌面测试与调试
• 自动化脚本运行环境
• 跨平台桌面应用访问
• 容器化桌面环境部署

配置说明与部署示例

基础部署

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

bash
docker run -d -p 5901:5901 -p 6901:6901 consol/centos-xfce-vnc

自定义用户运行

使用主机用户ID/组ID避免权限问题：

bash
docker run -d -p 5901:5901 -p 6901:6901 --user $(id -u):$(id -g) consol/centos-xfce-vnc

交互式操作

进入容器bash环境进行手动配置：

bash
docker run -it -p 5901:5901 -p 6901:6901 consol/centos-xfce-vnc bash

环境变量配置

• 修改VNC密码：

  bash
  docker run -it -p 5901:5901 -p 6901:6901 -e VNC_PW=your_custom_pw consol/centos-xfce-vnc
  

• 调整分辨率：

  bash
  docker run -it -p 5901:5901 -p 6901:6901 -e VNC_RESOLUTION=1920x1080 consol/centos-xfce-vnc
  

• 仅查看模式（禁止控制）：

  bash
  docker run -it -p 5901:5901 -p 6901:6901 -e VNC_VIEW_ONLY=true consol/centos-xfce-vnc
  

访问方式

• VNC客户端：localhost:5901（默认密码vncpassword）
• Web浏览器：http://localhost:6901/?password=vncpassword

扩展镜像

如需安装自定义软件，可通过Dockerfile扩展：

dockerfile
FROM consol/centos-xfce-vnc:1.1.0
MAINTAINER Your Name "***"
ENV REFRESHED_AT 2024-05-20

# 切换至root用户安装软件
USER 0
RUN yum install -y gedit && yum clean all
# 恢复默认用户
USER 1984