accetto/ubuntu-vnc-xfce-firefox-g3 镜像文档

镜像概述和主要用途

本镜像基于 Ubuntu LTS 发行版，提供无头（Headless）远程桌面环境，包含 Xfce 桌面、TigerVNC 服务器、noVNC 客户端及 Firefox 浏览器。主要用途包括远程图形化操作、应用测试、轻量级桌面环境访问等场景，支持通过 VNC 客户端或 Web 浏览器（noVNC）访问。

核心功能和特性

基础组件

• 操作系统：基于 Ubuntu 24.04 LTS、22.04 LTS 或 20.04 LTS
• 桌面环境：轻量级 Xfce 桌面（Ubuntu 发行版）
• 远程访问：
  • TigerVNC 服务器（高性能 VNC 服务）
  • noVNC HTML5 客户端（支持完整版和精简版）
• 浏览器：Firefox 网页浏览器
  • Ubuntu 24.04/22.04 版本：Mozilla Team PPA 提供的非 Snap 版本（因 Snap 在容器中不支持）
  • Ubuntu 20.04 版本：Ubuntu 发行版自带版本

工具与支持

• 系统工具：sudo 权限支持、nano 文本编辑器、mousepad 图形编辑器
• 开发工具：JSON 处理器 jq
• 进程管理：tini 作为入口进程（PID 1），优化信号处理
• 扩展性：支持覆盖环境变量、VNC 参数、用户及用户组配置
• 版本标识：集成版本标签（version sticker），显示构建信息

网络端口

默认暴露以下 TCP 端口：

• 5901：VNC 协议访问（需 VNC 客户端）
• 6901：noVNC 访问（需 Web 浏览器）

附加功能

• Firefox plus：增强型 Firefox 配置（详情参考用户指南）

标签信息

提示：点击版本标签徽章可查看构建详情。

使用场景和适用范围

1. 远程桌面环境：需要通过图形界面远程操作的场景，如服务器管理、家庭办公。
2. 开发与测试：在隔离环境中运行图形化应用、测试跨浏览器兼容性（Firefox）。
3. 轻量级图形应用：运行无需本地桌面的图形化工具，降低本地资源占用。
4. 教学与演示：提供临时可访问的图形环境，用于教学或演示操作流程。

使用方法和配置说明

快速启动（Docker Run）

基础启动命令

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

带密码保护的启动

bash
docker run -d -p 5901:5901 -p 6901:6901 \
  -e VNC_PASSWORD=mysecretpassword \
  --name ubuntu-vnc-secure \
  accetto/ubuntu-vnc-xfce-firefox-g3:22.04

自定义分辨率和挂载目录

bash
docker run -d -p 5901:5901 -p 6901:6901 \
  -e VNC_RESOLUTION=1920x1080 \
  -v /host/path:/container/path \
  --name ubuntu-vnc-custom \
  accetto/ubuntu-vnc-xfce-firefox-g3:20.04

Docker Compose 配置

创建 docker-compose.yml 文件：

yaml
version: '3.8'
services:
  ubuntu-vnc:
    image: accetto/ubuntu-vnc-xfce-firefox-g3:latest
    container_name: ubuntu-vnc
    ports:
      - "5901:5901"  # VNC 端口
      - "6901:6901"  # noVNC 端口
    environment:
      - VNC_PASSWORD=myvncpass  # 可选：设置 VNC 密码
      - VNC_RESOLUTION=1600x900  # 可选：设置分辨率
      - USER_ID=1000  # 可选：覆盖容器内用户 ID
      - GROUP_ID=1000  # 可选：覆盖容器内用户组 ID
    volumes:
      - ./data:/home/headless/data  # 挂载本地目录到容器
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

环境变量说明

支持通过环境变量自定义配置，常见变量包括：

注意：完整环境变量列表可参考 用户指南。

访问方式

1. 通过 VNC 客户端：

   • 地址：localhost:5901
   • 若设置密码，输入 VNC_PASSWORD 的值

2. 通过 Web 浏览器（noVNC）：

   • 地址：http://localhost:6901
   • 点击页面中的 "Connect" 按钮，若设置密码则输入

备注

相关镜像

• Debian 版本：同系列镜像 accetto/debian-vnc-xfce-firefox-g3 基于 Debian 发行版。

版本代次说明

• G3（第三代）：当前镜像系列，基于 Ubuntu LTS 版本，优化构建流程。
• G2（第二代）：仓库 accetto/xubuntu-vnc-novnc。
• G1（第一代）：仓库 accetto/ubuntu-vnc-xfce。

Firefox 版本说明

Ubuntu 24.04/22.04 LTS 发行版默认提供 Firefox 的 Snap 版本，但因 Snap 在 Docker 容器中存在兼容性问题，本镜像从 Mozilla Team PPA 安装非 Snap 版本的 Firefox。

获取帮助

若遇到问题或有疑问，建议优先参考：

• 用户指南
• GitHub Issues（含已关闭 issue）
• GitHub Wiki

如需进一步支持，可通过 GitHub Discussions 提问，或提交新 issue（建议详细描述问题以提高解决效率）。