accetto/ubuntu-vnc-xfce-g3

无头Ubuntu/Xfce容器与VNC/noVNC

accetto/ubuntu-vnc-xfce-g3

镜像概述和主要用途

本Docker Hub仓库包含用于无头工作的Docker镜像。这些镜像基于https://hub.docker.com/_/ubuntu/，并包含Xfce桌面环境、TigerVNC服务器和https://github.com/kanaka/noVNC客户端。

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

核心功能和特性

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

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

默认暴露以下TCP端口：

• 5901 - 通过VNC访问(使用VNC查看器)
• 6901 - 通过https://github.com/kanaka/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流程中的图形应用测试

使用方法和配置说明

基本运行命令

使用默认配置运行容器：

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

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

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

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

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

Docker Compose配置示例

yaml
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)

相关资源

• 用户指南：https://accetto.github.io/user-guide-g3/
• GitHub项目：https://github.com/accetto/ubuntu-vnc-xfce-g3/
• Dockerfile：https://github.com/accetto/ubuntu-vnc-xfce-g3/blob/master/docker/Dockerfile.xfce.24-04
• 完整README：https://github.com/accetto/ubuntu-vnc-xfce-g3/blob/master/docker/xfce/README.md
• 更新日志：https://github.com/accetto/ubuntu-vnc-xfce-g3/blob/master/CHANGELOG.md

备注

还有一个类似的兄弟仓库https://hub.docker.com/r/accetto/debian-vnc-xfce-g3，基于https://hub.docker.com/_/debian/。

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

获取帮助

如果您发现问题或有疑问，请先查看https://accetto.github.io/user-guide-g3/、https://github.com/accetto/ubuntu-vnc-xfce-g3/issues和https://github.com/accetto/ubuntu-vnc-xfce-g3/wiki。请不要忽略已关闭的问题。

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

如果您有问题或想法，但不想打开问题，也可以使用https://github.com/accetto/ubuntu-vnc-xfce-g3/discussions功能。