accetto/ubuntu-vnc-xfce-freecad-g3

accetto/ubuntu-vnc-xfce-freecad-g3

镜像概述和主要用途

本Docker Hub仓库包含用于无头运行免费开源3D参数化建模软件FreeCAD的Docker镜像。基于https://hub.docker.com/_/ubuntu/，集成Xfce桌面环境、TigerVNC服务器和https://github.com/kanaka/noVNC客户端，支持通过VNC查看器或Web浏览器访问图形界面。

镜像包含Mesa3D库和VirtualGL工具包，支持OpenGL、OpenGL ES、WebGL等3D图形API，以及Chromium、Firefox浏览器，适合构建远程3D建模工作环境。

标签

定期构建并发布到Docker Hub的镜像标签：

• latest：实现VNC/noVNC、Mesa3D和VirtualGL
• chromium：添加Chromium浏览器
• firefox：添加Firefox浏览器（含Firefox plus特性）

核心功能和特性

主要组件

• 桌面环境：轻量级Xfce桌面（Debian发行版）
• 远程访问：TigerVNC服务器（VNC协议）和noVNC客户端（Web访问）
• 3D图形支持：Mesa3D库、VirtualGL工具包，支持多图形API
• 测试工具：glxgears、es2tri（OpenGL测试），https://github.com/glmark2/glmark2（OpenGL基准测试）
• 浏览器：
  • Chromium（来自Ubuntu 18.04 LTS发行版，--no-sandbox模式运行）
  • Firefox（Mozilla Team PPA的非snap版本，含Firefox plus特性）
• 3D建模软件：免费开源3D参数化建模软件FreeCAD
• 辅助工具：sudo支持、jq（JSON处理器）、nano（文本编辑器）、mousepad（图形编辑器）、tini（入口点初始进程）

暴露端口

默认暴露以下TCP端口：

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

使用场景和适用范围

• 远程3D建模：无需本地安装FreeCAD，通过VNC或Web浏览器访问容器图形界面
• 跨平台协作：在不同操作系统上通过Docker实现统一的FreeCAD运行环境
• 快速部署：用于测试、演示或临时建模任务，避免本地环境配置复杂问题

使用方法和配置说明

基本运行命令

启动容器（映射端口并后台运行）：

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

访问方式

1. VNC查看器访问：使用VNC查看器连接localhost:5901
2. Web浏览器访问：打开浏览器访问http://localhost:6901，通过noVNC客户端连接

注意事项

• 镜像体积：FreeCAD的AppImage归档约950MB，首次下载可能需要较长时间
• 启动时间：容器中启动FreeCAD需几秒（AppImage需解压），关闭后清理也需几秒
• 浏览器说明：
  • Chromium因Ubuntu 24.04 LTS版本依赖snap（容器中不支持），故使用Ubuntu 18.04 LTS版本并以--no-sandbox模式运行
  • Firefox为Mozilla Team PPA的非snap版本，避免容器中snap支持问题
• 版本说明：属第三代（G3）无头镜像，第二代（G2）对应https://github.com/accetto/xubuntu-vnc-novnc/，第一代（G1）对应https://github.com/accetto/ubuntu-vnc-xfce

相关资源

• https://accetto.github.io/user-guide-g3/
• https://github.com/accetto/headless-drawing-g3/
• https://github.com/accetto/headless-drawing-g3/blob/master/docker/Dockerfile.xfce.drawing
• https://github.com/accetto/headless-drawing-g3/blob/master/docker/xfce-freecad/README.md
• https://github.com/accetto/headless-drawing-g3/blob/master/CHANGELOG.md