accetto/debian-vnc-xfce-firefox-g3

带VNC/noVNC和Firefox浏览器的无头Debian/Xfce容器

accetto/debian-vnc-xfce-firefox-g3

该Docker Hub仓库包含用于无头工作的Docker镜像。

镜像概述

这些镜像基于当前的[Debian 13][docker-debian]以及之前的[Debian 12][docker-debian]和[Debian 11][docker-debian]，包含[Xfce][xfce]桌面环境、[TigerVNC][tigervnc]服务器、[noVNC][novnc]客户端以及流行的Web浏览器[Firefox][firefox]。

镜像主要用于提供无头图形工作环境，用户可通过VNC查看器或Web浏览器（通过noVNC）远程访问Xfce桌面及其中的应用程序。

标签

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

• latest（也标记为13）：基于Debian 13
• 12：基于Debian 12
• 11：基于Debian 11

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

核心功能与特性

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

• 轻量级[Xfce][xfce]桌面环境（Debian发行版）
• [sudo][sudo]支持
• 当前版本的JSON处理器[jq][jq]
• 当前版本的高性能[TigerVNC][tigervnc]服务器和客户端
• 当前版本的[noVNC][novnc] HTML5客户端（完整版和精简版），使用TCP端口6901
• 流行的文本编辑器[nano][nano]（Debian发行版）
• 轻量级高级图形编辑器[mousepad][mousepad]（Debian发行版）
• 当前版本的[tini][tini]作为入口点初始进程（PID 1）
• 支持覆盖环境变量、VNC参数、用户和组（详见用户指南）
• 支持版本标签功能（详见用户指南）
• 当前版本的[Firefox ESR（扩展支持版本）][firefox] Web浏览器（来自Mozilla官方仓库），并提供额外的Firefox plus功能（详见用户指南）

默认暴露端口

• 5901：用于通过VNC查看器访问
• 6901：用于通过[noVNC][novnc]（Web浏览器）访问

使用场景

• 无头图形应用程序运行与测试
• 远程桌面访问需求
• 浏览器自动化测试环境
• 需要图形界面但无本地显示设备的场景

使用方法

基本运行命令

通过以下命令启动容器，映射默认端口：

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

通过VNC查看器访问

1. 启动容器后，打开VNC查看器
2. 连接地址：localhost:5901
3. 默认无需密码（可通过环境变量配置密码）

通过Web浏览器访问

1. 启动容器后，打开Web浏览器
2. 访问地址：http://localhost:6901
3. 点击页面中的"Connect"按钮即可连接到桌面

自定义配置

可通过环境变量自定义容器行为，例如：

• 设置VNC分辨率：-e VNC_RESOLUTION=1920x1080
• 设置VNC密码：-e VNC_PASSWORD=yourpassword
• 调整用户ID：-e USER_ID=1000

示例：

bash
docker run -d -p 5901:5901 -p 6901:6901 -e VNC_RESOLUTION=1920x1080 -e VNC_PASSWORD=mysecret docker.xuanyuan.run/accetto/debian-vnc-xfce-firefox-g3:13

备注

存在基于[Ubuntu 22.04 LTS和20.04 LTS][docker-ubuntu]的类似镜像[accetto/ubuntu-vnc-xfce-firefox-g3][accetto-dockerhub-ubuntu-vnc-xfce-firefox-g3]。

本镜像属于第三代（G3）无头镜像。第二代（G2）对应的GitHub仓库为[accetto/xubuntu-vnc-novnc][accetto-github-xubuntu-vnc-novnc]，第一代（G1）为[accetto/ubuntu-vnc-xfce][accetto-github-ubuntu-vnc-xfce]。

获取帮助

如遇到问题或有疑问，请先查阅用户指南、Issues和相关Wiki（包括已关闭的issues）。如未找到解决方案，可提交新issue（问题描述越详细，解决概率越高）。也可通过相关Discussions进行提问或分享想法。