accetto/ubuntu-vnc-xfce-gimp-g3

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

accetto/ubuntu-vnc-xfce-gimp-g3

此Docker Hub仓库包含用于无头(headless)工作的Docker镜像，内置免费开源位图图像编辑器https://www.gimp.org/。

镜像基于https://hub.docker.com/_/ubuntu/构建，包含http://www.xfce.org桌面环境、TigerVNC服务器和https://github.com/kanaka/noVNC客户端。同时还预装了流行的网页浏览器https://www.chromium.org/Home和https://www.mozilla.org。

镜像概述和主要用途

该镜像提供了一个完整的无头图形工作环境，特别适用于需要远程访问GIMP图像编辑功能的场景。用户可以通过VNC客户端或Web浏览器(通过noVNC)访问容器内运行的Xfce桌面环境，使用GIMP进行图像编辑工作，同时也可以使用预装的网页浏览器进行网络访问。

核心功能和特性

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

• 轻量级http://www.xfce.org桌面环境(Debian发行版)
• sudo支持
• 当前版本的JSON处理器https://stedolan.github.io/jq/
• 当前版本的高性能TigerVNC服务器和客户端
• 当前版本的https://github.com/kanaka/noVNC HTML5客户端(完整版和精简版)，使用TCP端口6901
• 流行的文本编辑器https://www.nano-editor.org/nano
• 轻量级但高级的图形编辑器https://github.com/codebrainz/mousepadmousepad
• 当前版本的https://github.com/krallin/tini作为入口点初始进程(PID 1)
• 支持覆盖环境变量、VNC参数、用户和组
• 支持版本标签功能
• 当前版本的https://www.chromium.org/Home开源网页浏览器(来自Ubuntu 18.04 LTS发行版)
• 当前非snap版本的https://www.mozilla.org，来自Mozilla Team PPA，包含额外的Firefox plus功能
• 免费开源位图图像编辑器https://www.gimp.org/gimp

默认暴露以下TCP端口：

• 5901：通过VNC访问(使用VNC查看器)
• 6901：通过https://github.com/kanaka/noVNC访问(使用网页浏览器)

镜像标签

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

• latest：实现VNC和noVNC功能

• chromium：添加Chromium浏览器

• firefox：添加Firefox浏览器

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

使用场景和适用范围

该镜像适用于以下场景：

1. 需要远程访问GIMP进行图像编辑的个人用户
2. 开发团队需要共享图形编辑环境
3. 教学环境中提供GIMP实践操作
4. 自动化图像编辑工作流
5. 云环境中的图形处理任务

详细的使用方法和配置说明

基本使用方法

使用docker run命令

1. 基本启动命令

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

2. 使用自定义VNC密码

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

3. 挂载本地目录到容器

bash
docker run -d -p 5901:5901 -p 6901:6901 -v /path/to/local/files:/home/headless/Desktop/files docker.xuanyuan.run/accetto/ubuntu-vnc-xfce-gimp-g3:latest

4. 指定自定义屏幕分辨率

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

使用docker-compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  gimp-vnc:
    image: docker.xuanyuan.run/accetto/ubuntu-vnc-xfce-gimp-g3:latest
    ports:
      - "5901:5901"
      - "6901:6901"
    environment:
      - VNC_PW=mysecretpassword
      - VNC_RESOLUTION=1920x1080
      - USER_ID=1000
      - GROUP_ID=1000
    volumes:
      - ./local-files:/home/headless/Desktop/files
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

环境变量配置

访问方法

通过VNC客户端访问

1. 启动容器后，使用VNC客户端连接到 localhost:5901
2. 输入配置的VNC密码(或容器日志中显示的随机密码)

通过Web浏览器访问

1. 启动容器后，打开Web浏览器
2. 访问 http://localhost:6901
3. 在noVNC登录页面中，点击"Connect"按钮
4. 如提示输入密码，输入配置的VNC密码(或容器日志中显示的随机密码)

注意事项

• 镜像中包含的Chromium浏览器来自Ubuntu 18.04 LTS发行版，因为Ubuntu 24.04 LTS的版本依赖于snap，而snap目前在Docker容器中不受支持。
• 这些镜像中的https://www.chromium.org/Home以--no-sandbox模式运行，用户应了解其潜在影响。
• 镜像中包含的https://www.mozilla.org浏览器是来自Mozilla Team PPA的当前非snap版本，因为Ubuntu 24.04 LTS发行版仅包含snap版本，而snap目前在Docker容器中不受支持。
• 这是第三代(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/headless-drawing-g3/issues和https://github.com/accetto/ubuntu-vnc-xfce-g3/wiki。请不要忽略已关闭的issues。

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

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