无头Ubuntu/Xfce容器与VNC/noVNC

accetto/ubuntu-vnc-xfce-g3

镜像概述和主要用途

本Docker Hub仓库包含用于无头工作的Docker镜像。这些镜像基于Ubuntu 24.04、22.04和20.04 LTS，并包含Xfce桌面环境、TigerVNC服务器和noVNC客户端。

这是第三代(G3)无头镜像，专为需要通过VNC或Web浏览器远程访问图形桌面环境的场景设计。

核心功能和特性

默认配置下，镜像的主要功能和组件包括：

• 轻量级Xfce桌面环境(Debian发行版)
• sudo支持
• 当前版本的JSON处理器jq
• 当前版本的高性能TigerVNC服务器和客户端
• 当前版本的noVNC HTML5客户端(完整版和精简版)，使用TCP端口6901
• 流行的文本编辑器nanonano
• 轻量级但高级的图形编辑器mousepadmousepad
• 当前版本的tini作为入口点初始进程(PID 1)
• 支持覆盖环境变量、VNC参数、用户和组
• 支持版本标签(version sticker)功能

默认暴露以下TCP端口：

• 5901 - 通过VNC访问(使用VNC查看器)
• 6901 - 通过noVNC访问(使用Web浏览器)

标签信息

以下镜像标签会定期构建并发布到Docker Hub：

• latest (也作为24.04) - 基于Ubuntu 24.04 LTS
• 22.04 - 基于Ubuntu 22.04 LTS
• 20.04 - 基于Ubuntu 20.04 LTS

提示：点击版本标签徽章可查看特定构建的更多信息。

使用场景和适用范围

本镜像适用于以下场景：

• 需要通过远程桌面访问的无头环境
• 开发和测试环境的图形界面需求
• 云端服务器上的图形应用运行
• 浏览器可访问的远程桌面环境
• 教学和演示环境
• CI/CD流程中的图形应用测试

使用方法和配置说明

基本运行命令

使用默认配置运行容器：

docker run -d -p 5901:5901 -p 6901:6901 accetto/ubuntu-vnc-xfce-g3

指定自定义VNC密码运行容器：

docker run -d -p 5901:5901 -p 6901:6901 -e VNC_PW=mysecretpassword accetto/ubuntu-vnc-xfce-g3

指定自定义屏幕分辨率运行容器：

docker run -d -p 5901:5901 -p 6901:6901 -e VNC_RESOLUTION=1920x1080 accetto/ubuntu-vnc-xfce-g3

Docker Compose配置示例

version: '3'

services:
  ubuntu-vnc-xfce:
    image: accetto/ubuntu-vnc-xfce-g3:latest
    container_name: ubuntu-vnc-xfce
    ports:
      - "5901:5901"  # VNC端口
      - "6901:6901"  # noVNC端口
    environment:
      - VNC_PW=mysecretpassword  # VNC密码
      - VNC_RESOLUTION=1600x900  # 屏幕分辨率
      - VNC_COL_DEPTH=24  # 颜色深度
      - USER=user  # 用户名
      - USER_ID=1000  # 用户ID
      - GROUP_ID=1000  # 组ID
    volumes:
      - ./data:/home/user/data  # 挂载数据卷
    restart: unless-stopped

环境变量配置

访问方法

1. 通过VNC查看器：

   • 连接地址：localhost:5901
   • 密码：环境变量VNC_PW设置的值(默认为headless)

2. 通过Web浏览器(noVNC)：

   • 访问地址：http://localhost:6901
   • 点击"Connect"按钮
   • 输入环境变量VNC_PW设置的密码(默认为headless)

相关资源

• 用户指南：User Guide
• GitHub项目：this-github
• Dockerfile：this-dockerfile
• 完整README：this-readme-full
• 更新日志：this-changelog

备注

还有一个类似的兄弟仓库accetto/debian-vnc-xfce-g3，基于Debian。

这是我的无头镜像的第三代(G3)。第二代(G2)包含GitHub仓库accetto/xubuntu-vnc-novnc。第一代(G1)包含GitHub仓库accetto/ubuntu-vnc-xfce。

获取帮助

如果您发现问题或有疑问，请先查看用户指南、问题和Wiki。请不要忽略已关闭的问题。

如果没有找到解决方案，您可以提交新问题。问题描述越详细，解决的可能性就越大。

如果您有问题或想法，但不想打开问题，也可以使用讨论功能。