accetto/ubuntu-vnc-xfce-blender-g3

accetto/ubuntu-vnc-xfce-blender-g3

镜像概述和主要用途

本镜像基于 Ubuntu 24.04 LTS (Noble Numbat) 构建，提供无头（Headless）环境下运行开源 3D 创作套件 Blender 的完整解决方案。镜像集成 Xfce 桌面环境、TigerVNC 服务器和 noVNC 客户端，支持通过 VNC viewer 或 Web 浏览器远程访问图形界面。同时包含 Mesa3D 图形库和 VirtualGL 工具包，全面支持 OpenGL、OpenGL ES、WebGL 等 3D 图形 API，适用于远程 3D 建模、渲染及图形应用测试场景。

镜像标签

以下标签定期构建并发布至 Docker Hub：

latest

• 基础版本，包含 VNC/noVNC、Mesa3D 和 VirtualGL 核心组件，支持 3D 图形加速和远程桌面访问。

chromium

• 在 latest 基础上添加 Chromium 浏览器，适用于需要网页集成或 WebGL 测试的场景。

firefox

• 在 latest 基础上添加 Firefox 浏览器（非 Snap 版本，来自 Mozilla Team PPA），支持网页图形应用和兼容性测试。

核心功能与特性

桌面环境与远程访问

• 轻量级桌面：集成 Debian 版本的 Xfce 桌面环境，资源占用低且界面简洁。
• 双协议远程访问：
  • VNC 协议（TCP 5901 端口）：支持标准 VNC viewer 连接。
  • noVNC 协议（TCP 6901 端口）：支持通过 Web 浏览器访问（HTML5 客户端）。
• 权限管理：内置 sudo 支持，允许容器内权限提升操作。

3D 图形支持

• 图形加速 stack：
  • Mesa3D：开源 OpenGL/OpenGL ES 实现库，支持硬件加速（需宿主机 GPU 支持）。
  • VirtualGL：重定向 OpenGL 渲染至远程显示的工具包，提升 3D 图形性能。
• 测试与基准工具：
  • OpenGL 测试程序：glxgears（图形渲染测试）、es2tri（OpenGL ES 测试）。
  • 性能基准工具：glmark2（OpenGL 性能基准测试）。

预装软件

• 3D 创作工具：开源 3D 建模套件 Blender（Ubuntu 发行版）。
• 浏览器：
  • Chromium（chromium 标签）：开源网页浏览器，支持 WebGL。
  • Firefox（firefox 标签）：非 Snap 版本浏览器，支持扩展和网页图形应用。
• 文本与图形编辑：
  • 命令行编辑器：nano（Ubuntu 发行版）。
  • 图形编辑器：mousepad（轻量级 GUI 文本编辑器）。
• 系统工具：
  • JSON 处理器：jq（最新版本）。
  • 进程管理：tini（作为 PID 1 进程，确保容器信号处理和资源回收）。

版本与标识

• 版本标签：支持 "version sticker" 机制，可通过容器内文件或环境变量查看组件版本信息。

使用场景

1. 无头 3D 建模与渲染
   通过远程桌面访问 Blender，在无本地图形界面的服务器/云环境中进行 3D 建模和渲染任务。

2. 图形应用测试
   验证 OpenGL/OpenGL ES/WebGL 应用在不同浏览器（Chromium/Firefox）中的兼容性，或测试图形性能基准。

3. 教育与演示
   搭建共享的 Blender 教学环境，学生通过浏览器或 VNC 远程接入，无需本地安装软件。

4. 浏览器兼容性测试
   在隔离环境中测试网页图形应用（如 WebGL 项目）在 Chromium 和 Firefox 中的表现。

使用方法与配置说明

基础运行命令

1. 启动基础版本（latest）

bash
docker run -d -p 5901:5901 -p 6901:6901 --name blender-vnc docker.xuanyuan.run/accetto/ubuntu-vnc-xfce-blender-g3:latest

• 访问方式：
  • VNC viewer：连接 宿主机IP:5901，默认无密码（可通过环境变量设置）。
  • 浏览器：访问 http://宿主机IP:6901，点击 "Connect" 进入桌面。

2. 带密码保护的启动（推荐）

bash
docker run -d -p 5901:5901 -p 6901:6901 \
  -e VNC_PASSWORD=mysecret \  # 设置 VNC/noVNC 访问密码
  --name blender-vnc-secure \
  accetto/ubuntu-vnc-xfce-blender-g3:latest

3. 自定义分辨率与用户权限

bash
docker run -d -p 5901:5901 -p 6901:6901 \
  -e VNC_RESOLUTION=1920x1080 \  # 设置桌面分辨率（默认 1280x720）
  -e USER=developer \             # 自定义容器内用户名（默认 'headless'）
  -e USER_ID=1001 \               # 自定义用户 UID（避免权限冲突）
  -v /host/data:/home/developer/data \  # 挂载宿主机目录（持久化数据）
  --name blender-vnc-custom \
  accetto/ubuntu-vnc-xfce-blender-g3:chromium  # 使用带 Chromium 的标签

docker-compose 配置示例

yaml
version: '3'
services:
  blender-vnc:
    image: docker.xuanyuan.run/accetto/ubuntu-vnc-xfce-blender-g3:firefox
    ports:
      - "5901:5901"  # VNC 端口
      - "6901:6901"  # noVNC 端口
    environment:
      - VNC_PASSWORD=workspace  # VNC 访问密码
      - VNC_RESOLUTION=1600x900  # 桌面分辨率
      - USER=blender-user  # 容器内用户名
    volumes:
      - ./blender-projects:/home/blender-user/projects  # 持久化项目文件
    restart: unless-stopped

环境变量配置

注意事项

1. Chromium 安全模式
   Chromium 浏览器以 --no-sandbox 模式运行（容器环境限制），需注意潜在安全风险，避免访问不受信任的网页。

2. Firefox 版本说明
   firefox 标签中的浏览器为非 Snap 版本，来自 Mozilla Team PPA，解决了 Ubuntu 24.04 原生 Snap 版本在容器中不兼容的问题。

3. 镜像代际
   本镜像为第三代（G3）无头图形镜像，前两代（G1/G2）分别对应 GitHub 仓库 accetto/ubuntu-vnc-xfce 和 accetto/xubuntu-vnc-novnc，功能及架构存在差异，请勿混用配置。

获取帮助

• 用户指南：详细使用说明请参考 https://accetto.github.io/user-guide-g3/%E3%80%82
• 问题反馈：通过 https://github.com/accetto/headless-drawing-g3/issues 提交 bug 或功能需求。
• 讨论社区：通过 https://github.com/accetto/ubuntu-vnc-xfce-g3/discussions 进行技术交流或提问。
• Wiki 文档：参考 https://github.com/accetto/ubuntu-vnc-xfce-g3/wiki 获取进阶配置示例。