带VNC/noVNC和drawio-desktop的无头Ubuntu/Xfce容器

accetto/ubuntu-vnc-xfce-drawio-g3

镜像概述

本Docker Hub仓库包含用于无头运行免费开源 diagramming 应用drawio-desktop的Docker镜像。镜像基于Ubuntu 24.04 LTS (Noble Numbat)构建，集成Xfce桌面环境、TigerVNC服务器、noVNC客户端，以及流行的Web浏览器Chromium和Firefox。

核心功能与特性

主要组件

• 桌面环境：轻量级Xfce桌面（Debian发行版）
• 远程访问：TigerVNC服务器（TCP端口5901）和noVNC HTML5客户端（TCP端口6901）
• 浏览器：Chromium和非snap版本Firefox（来自Mozilla Team PPA）
• 核心应用：drawio-desktop diagramming工具（来自diagrams.net作者）
• 辅助工具：文本编辑器nano、图形编辑器mousepad、JSON处理器jq
• 系统工具：sudo支持、tini作为PID 1初始化进程

drawio-desktop安全特性

• 设计为完全隔离互联网（仅更新过程除外）
• 所有JavaScript文件自给自足，内容安全策略禁止运行远程加载的JavaScript
• 不向外发送任何图表数据或应用使用分析

暴露端口

• 5901：通过VNC viewer访问
• 6901：通过Web浏览器访问noVNC

支持的标签

• latest：基础版本，包含VNC和noVNC
• chromium：在latest基础上添加Chromium浏览器
• firefox：在latest基础上添加Firefox浏览器

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

使用场景

• 需要在隔离环境中使用drawio进行图表绘制的场景
• 远程访问 diagramming 工具的需求
• 开发或测试环境中集成drawio的工作流

使用方法

基本部署（docker run）

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

访问方式

• VNC viewer：连接localhost:5901
• Web浏览器：访问http://localhost:6901，点击页面中的"Connect"按钮

持久化数据（挂载目录）

bash
docker run -d -p 5901:5901 -p 6901:6901 -v /本地目录:/home/headless/workspace accetto/ubuntu-vnc-xfce-drawio-g3:latest

配置参数

环境变量（可覆盖）

• VNC_RESOLUTION：设置VNC分辨率（默认1280x720）
• VNC_PASSWORD：设置VNC访问密码（默认无密码）
• USER_ID/GROUP_ID：自定义容器内用户ID和组ID

示例：自定义分辨率和密码

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

备注

• Chromium说明：包含来自Ubuntu 18.04 LTS发行版的Chromium，因Ubuntu 24.04版本依赖snap（容器中不支持）；以--no-sandbox模式运行，需注意安全影响。
• Firefox说明：包含来自Mozilla Team PPA的非snap版本，因Ubuntu 24.04默认提供snap版本（容器中不支持）。
• 版本代系：本镜像为第三代（G3）无头镜像，第二代（G2）和第一代（G1）分别对应GitHub仓库accetto/xubuntu-vnc-novnc和accetto/ubuntu-vnc-xfce。

获取帮助

• 参考用户指南
• 查看GitHub项目Issues和Wiki
• 通过GitHub Discussions提问