accetto/ubuntu-vnc-xfce-firefox-default

带有VNC/noVNC和Firefox的无头Ubuntu/Xfce容器

accetto/ubuntu-vnc-xfce-firefox-default

镜像概述和主要用途

本镜像基于Ubuntu 18.04 LTS，包含Xfce桌面环境、VNC/noVNC服务器以及默认安装的Firefox浏览器，适用于无头使用场景。可在Linux、Windows、Mac和NAS设备上构建和使用，已在Docker Desktop（Ubuntu、Windows 10）和QNAP Container Station上测试通过。作为第一代（G1）无头镜像，于2022年3月退休后，因持续使用需求于2022年11月恢复，当前为G1v2版本，主要优化构建流程和支持脚本，并合并了此前分离的GitHub项目。

核心功能和特性

继承自基础镜像的组件

• 实用工具：ping、wget、zip、unzip、curl、git（Ubuntu发行版）
• JSON处理器：当前版本的jq
• 桌面环境：轻量级Xfce（Ubuntu发行版）
• VNC服务：高性能TigerVNC服务器和客户端（当前版本）
• noVNC客户端：当前版本的HTML5客户端（完整版和精简版，TCP端口6901）
• 文本编辑器：vim、nano（Ubuntu发行版）
• 图形编辑器：mousepad（Ubuntu发行版）
• 版本标签支持：可通过脚本检查镜像及应用版本

Firefox特性

• 默认启用多进程模式（Electrolysis/E10S），需较大共享内存（/dev/shm），推荐至少256MB
• 自版本20.10.1起，不再提供单进程Firefox镜像，多进程模式可提升性能并增强浏览沙箱安全性

使用场景和适用范围

• 轻量级网页浏览：容器可快速创建和替换，提升浏览隐私性
• 安全浏览环境：默认以非root用户（headless:headless）运行，增强安全性
• 跨平台使用：支持Linux、Windows、Mac及NAS设备（如QNAP）
• 后台运行：主要设计为后台运行场景，也支持前台交互模式

使用方法和配置说明

镜像信息

端口

暴露以下TCP端口：

• 5901：用于VNC访问
• 6901：用于noVNC访问 默认VNC用户密码：headless

卷

容器默认不创建或使用外部卷，但以下目录适合作为挂载点：

• /home/headless/Documents/
• /home/headless/Downloads/
• /home/headless/Music/
• /home/headless/Pictures/
• /home/headless/Public/
• /home/headless/Templates/
• /home/headless/Videos/ Firefox特定挂载点：/home/headless/.mozilla 支持命名卷和绑定挂载，详情参考Docker文档《Manage data in Docker》。

版本标签

版本标签用于标识镜像版本，构建时持久化到镜像中。可通过脚本version_sticker.sh（位于/dockerstartup目录）检查版本：

• 无参数：返回当前容器的版本标签值（基于当前应用版本计算）
• -v：显示版本标签包含的核心应用详细版本
• -V：显示更多应用的详细版本

Firefox多进程配置

设置共享内存大小

Docker默认分配64MB共享内存，可能导致Firefox多进程模式不稳定（标签崩溃），推荐设置至少256MB。

命令行设置示例：

bash
docker run -d -P --shm-size=256m docker.xuanyuan.run/accetto/ubuntu-vnc-xfce-firefox-default

检查共享内存大小（容器内执行）：

bash
df -h /dev/shm

后台运行容器（ detached 模式）

自动映射端口

docker
docker run -d -P docker.xuanyuan.run/accetto/ubuntu-vnc-xfce-firefox-default

指定端口映射

docker
docker run -d -p 25901:5901 -p 26901:6901 docker.xuanyuan.run/accetto/ubuntu-vnc-xfce-firefox-default

挂载卷（命名卷示例）

docker
docker run -d -P -v my_Downloads:/home/headless/Downloads docker.xuanyuan.run/accetto/ubuntu-vnc-xfce-firefox-default

使用--mount标志挂载

docker
docker run -d -P --mount source=my_Downloads,target=/home/headless/Downloads docker.xuanyuan.run/accetto/ubuntu-vnc-xfce-firefox-default

前台运行容器（交互模式）

支持启动选项：--wait（默认）、--skip、--debug（--tail-log）、--help。

查看帮助

docker
docker run --rm docker.xuanyuan.run/accetto/ubuntu-vnc-xfce-firefox-default --help

帮助输出摘要

OPTIONS:
-w, --wait      (默认) 保持UI和VNC服务器运行，直到接收SIGINT或SIGTERM信号
-s, --skip      跳过VNC启动，仅执行提供的命令
-d, --debug     启动VNC并跟踪日志，忽略后续参数，CTRL-C停止容器
-t, --tail-log  同--debug
-h, --help      显示帮助信息

调试模式示例

终端1：创建名为foo的容器

docker
docker run --name foo docker.xuanyuan.run/accetto/ubuntu-vnc-xfce-firefox-default --debug

终端2：进入foo容器执行shell

docker
docker exec -it foo /bin/bash

无头容器使用方法

默认VNC用户密码：headless。

通过VNC访问

需VNC Viewer（如TigerVNC、TightVNC），连接主机映射到容器5901端口的端口。
示例：容器在主机mynas上使用25901端口映射，则连接mynas:25901。

通过noVNC访问

使用HTML5浏览器，访问主机映射到容器6901端口的地址。
示例：容器在主机mynas上使用26901端口映射，则导航到http://mynas:26901，页面提供两个客户端链接：

• http://mynas:26901/vnc_lite.html（精简版）
• http://mynas:26901/vnc.html（完整版）

可在链接中包含密码：

• http://mynas:26901/vnc_lite.html?password=headless
• http://mynas:26901/vnc.html?password=headless

注意事项

• 镜像名称为accetto/ubuntu-vnc-xfce-firefox-default，以避免与旧镜像冲突
• 如需基于Ubuntu 20.04 LTS的更新镜像，可查看第三代（G3）镜像：accetto/ubuntu-vnc-xfce-g3、accetto/ubuntu-vnc-xfce-chromium-g3、accetto/ubuntu-vnc-xfce-firefox-g3
• 如无需nss_wrapper，可使用第二代（G2）精简版镜像accetto/xubuntu-vnc-novnc-firefox:default，支持sudo命令

问题反馈

如遇到问题或有疑问，建议先查看GitHub Issues、Wiki中的Troubleshooting、FAQ和HOWTO部分（包括已关闭的issues）。若未找到解决方案，可提交新issue，详细描述问题以提高解决效率。

鸣谢

感谢所有为开源社区贡献的个人和企业，使这些项目成为可能。