accetto/ubuntu-vnc-xfce-inkscape-g3

无头Ubuntu/Xfce容器与VNC/noVNC和Inkscape

accetto/ubuntu-vnc-xfce-inkscape-g3

镜像概述和主要用途

本Docker Hub仓库包含用于无头工作的Docker镜像，预装了免费开源矢量绘图应用程序Inkscape。镜像基于https://hub.docker.com/_/ubuntu/%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%8C%85%E5%90%ABXfce%E6%A1%8C%E9%9D%A2%E7%8E%AF%E5%A2%83%E3%80%81TigerVNC%E6%9C%8D%E5%8A%A1%E5%99%A8%E5%92%8Chttps://github.com/kanaka/noVNC%E5%AE%A2%E6%88%B7%E7%AB%AF%E3%80%82%E6%AD%A4%E5%A4%96%EF%BC%8C%E8%BF%98%E5%8C%85%E5%90%AB%E6%B5%81%E8%A1%8C%E7%9A%84Web%E6%B5%8F%E8%A7%88%E5%99%A8Chromium%E5%92%8CFirefox%E3%80%82

这是第三代(G3)无头镜像，适用于需要通过VNC或Web浏览器远程访问图形界面环境，特别是进行矢量图形设计和编辑的场景。

核心功能和特性

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

• 轻量级Xfce桌面环境(Debian发行版)
• sudo支持
• 当前版本的JSON处理器https://stedolan.github.io/jq/
• 当前版本的高性能TigerVNC服务器和客户端
• 当前版本的https://github.com/kanaka/noVNC HTML5客户端(完整版和精简版)
• 流行的文本编辑器nano(Ubuntu发行版)
• 轻量级但高级的图形编辑器https://github.com/codebrainz/mousepad(Ubuntu%E5%8F%91%E8%A1%8C%E7%89%88)
• 当前版本的https://github.com/krallin/tini%E4%BD%9C%E4%B8%BA%E5%85%A5%E5%8F%A3%E7%82%B9%E5%88%9D%E5%A7%8B%E8%BF%9B%E7%A8%8B(PID 1)
• 支持覆盖环境变量、VNC参数、用户和组
• 支持版本标签功能
• 当前版本的Chromium浏览器开源Web浏览器(来自Ubuntu 18.04 LTS发行版)
• 当前非snap版本的Firefox，来自Mozilla Team PPA，并支持额外的Firefox plus功能
• 免费开源矢量绘图应用程序Inkscape(Ubuntu发行版)

镜像标签

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

• latest: 实现VNC和noVNC
• chromium: 添加Chromium浏览器
• firefox: 添加Firefox浏览器

暴露端口

默认暴露以下TCP端口：

• 5901: 用于通过VNC访问(使用VNC查看器)
• 6901: 用于通过https://github.com/kanaka/noVNC%E8%AE%BF%E9%97%AE(%E4%BD%BF%E7%94%A8Web%E6%B5%8F%E8%A7%88%E5%99%A8)

使用场景和适用范围

本镜像适用于以下场景：

1. 远程图形设计工作：需要在没有本地图形界面的服务器或容器环境中运行Inkscape进行矢量图形编辑
2. 教育和培训：提供统一的Inkscape教学环境，学生可通过Web浏览器访问
3. 团队协作：共享设计环境，多用户可远程访问相同的设计工具和资源
4. 自动化图形处理：结合脚本实现无头环境下的自动化图形处理任务
5. 临时图形工作站：快速部署临时的图形编辑工作站，无需本地安装

使用方法和配置说明

Docker Run命令示例

基本用法(使用latest标签)：

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

使用Chromium浏览器版本：

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

使用Firefox浏览器版本：

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

自定义VNC密码和分辨率：

bash
docker run -d -p 5901:5901 -p 6901:6901 \
  -e VNC_PW=my-custom-password \
  -e VNC_RESOLUTION=1920x1080 \
  accetto/ubuntu-vnc-xfce-inkscape-g3:latest

挂载本地目录(持久化数据)：

bash
docker run -d -p 5901:5901 -p 6901:6901 \
  -v $(pwd)/my-projects:/home/headless/Projects \
  accetto/ubuntu-vnc-xfce-inkscape-g3:latest

Docker Compose配置示例

yaml
version: '3.8'

services:
  inkscape-workspace:
    image: accetto/ubuntu-vnc-xfce-inkscape-g3:latest
    container_name: inkscape-workspace
    restart: unless-stopped
    ports:
      - "5901:5901"   # VNC端口
      - "6901:6901"   # noVNC端口
    environment:
      - VNC_PW=secure-password-here
      - VNC_RESOLUTION=1920x1080
      - USER_UID=1000
      - USER_GID=1000
    volumes:
      - ./inkscape-projects:/home/headless/Projects
      - ./inkscape-config:/home/headless/.config/inkscape
    shm_size: "2gb"

环境变量说明

镜像支持以下环境变量进行配置：

• VNC_PW: VNC访问密码
• VNC_RESOLUTION: 桌面分辨率，默认为"1280x1024"
• VNC_COL_DEPTH: 颜色深度，默认为24
• VNC_PORT: VNC服务器端口，默认为5901
• NOVNC_PORT: noVNC服务器端口，默认为6901
• USER_UID: 自定义用户UID
• USER_GID: 自定义用户GID
• USER_NAME: 自定义用户名
• USER_PASSWORD: 自定义用户密码
• USER_GROUP: 自定义用户组名

注意事项

• 镜像中包含的Chromium浏览器来自Ubuntu 18.04 LTS发行版，因为Ubuntu 24.04 LTS版本依赖于snap，而snap目前在Docker容器中不受支持。
• Chromium浏览器在--no-sandbox模式下运行，请注意相关安全影响。
• 镜像中包含的Firefox浏览器是来自Mozilla Team PPA的当前非snap版本，因为Ubuntu 24.04 LTS发行版仅包含snap版本，而snap目前在Docker容器中不受支持。
• 这是第三代(G3)无头镜像，第二代(G2)位于GitHub仓库https://github.com/accetto/xubuntu-vnc-novnc/%EF%BC%8C%E7%AC%AC%E4%B8%80%E4%BB%A3(G1)%E4%BD%8D%E4%BA%8EGitHub%E4%BB%93%E5%BA%93https://github.com/accetto/ubuntu-vnc-xfce%E3%80%82

获取帮助

如果您发现问题或有疑问，请首先查阅https://accetto.github.io/user-guide-g3/%E3%80%81https://github.com/accetto/headless-drawing-g3/issues%E5%92%8Chttps://github.com/accetto/ubuntu-vnc-xfce-g3/wiki%E3%80%82%E8%AF%B7%E4%B8%8D%E8%A6%81%E5%BF%BD%E7%95%A5%E5%B7%B2%E5%85%B3%E9%97%AD%E7%9A%84issues%E3%80%82

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

如果您有问题或想法但不想创建issue，也可以使用https://github.com/accetto/ubuntu-vnc-xfce-g3/discussions%E3%80%82

相关链接

• 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-inkscape/README.md
• https://github.com/accetto/headless-drawing-g3/blob/master/CHANGELOG.md