热门搜索:
accetto/ubuntu-vnc-xfce
自动构建
accetto
基于Ubuntu的Docker镜像，包含Xfce桌面环境和VNC/noVNC服务器，适用于无头使用（第一代G1）。
19 次收藏下载次数: 0状态：自动构建维护者：accetto仓库类型：镜像最近更新：2 年前
带VNC/noVNC的无头Ubuntu/Xfce容器
accetto/ubuntu-vnc-xfce
https://hub.docker.com/r/accetto/ubuntu-vnc-xfce/ - https://github.com/accetto/ubuntu-vnc-xfce - https://github.com/accetto/ubuntu-vnc-xfce/blob/master/CHANGELOG.md - https://github.com/accetto/ubuntu-vnc-xfce/wiki
![badge-docker-pulls][badge-docker-pulls] ![badge-docker-stars][badge-docker-stars] ![badge-github-release][badge-github-release] ![badge-github-release-date][badge-github-release-date] ![badge-github-stars][badge-github-stars] ![badge-github-forks][badge-github-forks] ![badge-github-open-issues][badge-github-open-issues] ![badge-github-closed-issues][badge-github-closed-issues] ![badge-github-releases][badge-github-releases] ![badge-github-commits][badge-github-commits] ![badge-github-last-commit][badge-github-last-commit]
- 带VNC/noVNC的无头Ubuntu/Xfce容器
- accetto/ubuntu-vnc-xfce
- 简介
- 描述
- 镜像集
- 端口
- 卷
- 版本标签
- 后台运行容器（分离模式）
- 前台运行容器（交互模式）
- 使用无头容器
- 通过VNC
- 通过noVNC
- 问题
- 致谢
- accetto/ubuntu-vnc-xfce
提示 如果你需要基于[Ubuntu 20.04 LTS][docker-ubuntu]的更新镜像，且包含最新版本的[TigerVNC][tigervnc-releases]/[noVNC][novnc-releases]，请查看第三代（G3）镜像：[accetto/ubuntu-vnc-xfce-g3][accetto-docker-ubuntu-vnc-xfce-g3]、[accetto/ubuntu-vnc-xfce-chromium-g3][accetto-docker-ubuntu-vnc-xfce-chromium-g3] 或 [accetto/ubuntu-vnc-xfce-firefox-g3][accetto-docker-ubuntu-vnc-xfce-firefox-g3]。
提示 除非你需要[nss_wrapper][nsswrapper]，否则也可以使用第二代（G2）镜像https://hub.docker.com/r/accetto/xubuntu-vnc-novnc，它是本镜像的精简版本（https://github.com/accetto/xubuntu-vnc-novnc/wiki/Image-hierarchy）。该镜像还支持sudo命令。
简介
本仓库包含用于构建基于[Ubuntu 18.04 LTS][docker-ubuntu]的Docker镜像的资源，该镜像带有[Xfce][xfce]桌面环境和[VNC][tigervnc]/[noVNC][novnc]服务器，适用于无头使用场景。
这些镜像可在Linux、Windows、Mac和NAS设备上成功构建和使用。已在[Ubuntu衍生版][ubuntu-flavours]的[Docker Desktop][docker-desktop]、[Windows 10][docker-for-windows]以及[QNAP][qnap]的[Container Station][container-station]上进行测试。
这是我的无头镜像的第一代（G1），我于2022年3月停止维护。但由于注意到镜像仍被拉取，我在2022年11月恢复了该项目。
当前的第二版（G1v2） 带来了一些改进，主要体现在构建流程和支持脚本上。
它还将之前分离的GitHub项目https://github.com/accetto/ubuntu-vnc-xfce-firefox、https://github.com/accetto/ubuntu-vnc-xfce-firefox-plus和https://github.com/accetto/ubuntu-vnc-xfce-chromium合并到了这个单一项目中。
描述
本镜像 accetto/ubuntu-vnc-xfce 是我的其他具有附加功能的Docker镜像（https://hub.docker.com/r/accetto/ubuntu-vnc-xfce-firefox-plus/、https://hub.docker.com/r/accetto/ubuntu-vnc-xfce-firefox-default/ 和 https://hub.docker.com/r/accetto/ubuntu-vnc-xfce-chromium/）的基础镜像。
由此镜像创建的容器非常适合学习、开发或测试，因为它们可以通过Web浏览器（通过[noVNC][novnc]）或VNC查看器（如[TigerVNC][tigervnc]或[TightVNC][tightvnc]）轻松进行无头使用。同时提供精简版（lite） 和完整版（full） [noVNC][novnc]客户端。
虽然容器不包含任何Web浏览器，但已包含[mousepad][mousepad]和[vim][vim]编辑器以及ping工具。其他应用程序也可以在运行时轻松添加，因为容器在特权root用户下运行。
需要注意的是，容器的root与主机的root不同，并且不会自动获得主机上的所有root权限。有关更多信息，请查看[Docker文档][docker-doc]（例如[运行时特权和Linux功能][docker-doc-capabilities]）。
容器的主要使用场景是后台运行，但也可以在前台交互使用。有关示例，请参见下面的描述或https://github.com/accetto/ubuntu-vnc-xfce/wiki中的https://github.com/accetto/ubuntu-vnc-xfce/wiki/How-to部分。
镜像包含以下组件：
- 工具 ping、wget、zip、unzip、[curl][curl]、[git][git]（Ubuntu发行版）
- JSON处理器[jq][jq]的当前版本
- 轻量级[Xfce][xfce]桌面环境（Ubuntu发行版）
- 高性能[TigerVNC][tigervnc]服务器和客户端的当前版本
- [noVNC][novnc] HTML5客户端的当前版本（完整版和精简版）（TCP端口6901）
- 流行的文本编辑器[vim][vim]和[nano][nano]（Ubuntu发行版）
- 轻量级但高级的图形编辑器[mousepad][mousepad]（Ubuntu发行版）
- 支持版本标签（见下文）
镜像会定期维护和重建。重大变更历史记录在https://github.com/accetto/ubuntu-vnc-xfce/blob/master/CHANGELOG.md中。
![screenshot-container][screenshot-container]
镜像集
-
https://hub.docker.com/r/accetto/ubuntu-vnc-xfce/
基于官方[ubuntu][docker-ubuntu]镜像的镜像。
-
latest基于ubuntu:latest![badge-VERSION_STICKER_LATEST][badge-VERSION_STICKER_LATEST]
-
端口
暴露以下TCP端口：
- 5901 用于通过VNC访问
- 6901 用于通过[noVNC][novnc]访问
默认VNC用户密码为headless。
卷
容器默认不创建或使用任何外部卷。但是，以下文件夹是良好的挂载点：
- /home/headless/Documents/
- /home/headless/Downloads/
- /home/headless/Music/
- /home/headless/Pictures/
- /home/headless/Public/
- /home/headless/Templates/
- /home/headless/Videos/
可以使用命名卷和绑定挂载。有关卷的更多信息，请参见[Docker文档][docker-doc]（例如[管理Docker中的数据][docker-doc-managing-data]）。
版本标签
版本标签有多种用途，在https://github.com/accetto/ubuntu-vnc-xfce/wiki中有更详细的描述。版本标签值标识Docker镜像的版本，在构建时持久化到镜像中，并在README文件中显示为徽章。
但是，脚本version_sticker.sh可随时用于方便地检查已安装应用程序的当前版本。
该脚本部署在启动文件夹中，该文件夹由环境变量STARTUPDIR定义，默认值为/dockerstartup。
如果在容器内执行不带参数的脚本，则返回容器的当前版本标签值。此值是新计算的，基于容器中基本应用程序的当前版本。
如果任何包含的应用程序已更新到其他版本，则当前版本标签值将与持久化值不同。
如果使用参数-v（小写v）调用脚本，则会打印出版本标签值中包含的基本应用程序的详细版本。
如果使用参数-V（大写v）调用，则会打印出更多应用程序的详细版本。
示例可在https://github.com/accetto/ubuntu-vnc-xfce/wiki中找到。
后台运行容器（分离模式）
容器默认在特权root用户下运行。但请注意，这是容器的root，与主机的root不同（见上文）。
以下容器将侦听主机自动选择的TCP端口：
dockerdocker run -d -P accetto/ubuntu-vnc-xfce
以下容器将侦听主机的显式TCP端口25901（VNC）和26901（noVNC）：
dockerdocker run -d -p 25901:5901 -p 26901:6901 accetto/ubuntu-vnc-xfce
以下容器将创建或重用本地命名卷my_Downloads，挂载为/headless/Downloads：
dockerdocker run -d -P -v my_Downloads:/home/headless/Downloads accetto/ubuntu-vnc-xfce
或使用带有**--mount**标志的较新语法：
dockerdocker run -d -P --mount source=my_Downloads,target=/home/headless/Downloads accetto/ubuntu-vnc-xfce
更多使用示例可在https://github.com/accetto/ubuntu-vnc-xfce/wiki的https://github.com/accetto/ubuntu-vnc-xfce/wiki/How-to部分找到。
前台运行容器（交互模式）
镜像支持以下容器启动选项：--wait（默认）、--skip、--debug（也为--tail-log）和--help。
以下容器将打印帮助信息，然后自行删除：
dockerdocker run --rm accetto/ubuntu-vnc-xfce --help
输出摘录，描述其他选项：
dockerOPTIONS: -w, --wait (默认) 保持UI和vnc服务器运行，直到收到SIGINT或SIGTERM信号。 可选命令可在vnc启动后执行。 示例: docker run -d -P accetto/ubuntu-vnc-xfce 示例: docker run -it -P --rm accetto/ubuntu-vnc-xfce bash -s, --skip 跳过vnc启动，仅执行提供的命令。 示例: docker run -it -P --rm accetto/ubuntu-vnc-xfce --skip echo $BASH_VERSION -d, --debug 执行vnc启动并跟踪vnc/noVNC日志。 '--debug'后的任何参数将被忽略。CTRL-C停止容器。 示例: docker run -it -P --rm accetto/ubuntu-vnc-xfce --debug -t, --tail-log 与'--debug'相同 -h, --help 打印此帮助信息。 示例: docker run --rm accetto/ubuntu-vnc-xfce
需要注意的是，即使提供了-it运行参数，--debug启动选项也不会显示命令提示符。这是因为容器正在监视传入的vnc/noVNC连接并实时打印其日志。但是，可以轻松附加到正在运行的容器，如下例所示。
在主机的第一个终端窗口中，创建名为foo的新容器：
dockerdocker run --name foo accetto/ubuntu-vnc-xfce --debug
在主机的第二个终端窗口中，在foo容器内执行shell：
dockerdocker exec -it foo /bin/bash
使用无头容器
有两种方式使用创建的无头容器。注意默认VNC用户密码为headless。
通过VNC
要通过VNC使用容器，需要一些VNC查看器（如[TigerVNC][tigervnc]或[TightVNC][tightvnc]）。
VNC查看器应连接到运行容器的主机，指向映射到容器TCP端口5901的主机TCP端口。
例如，如果容器在名为mynas的主机上使用上述参数创建，则VNC查看器应连接到mynas:25901。
通过noVNC
要通过[noVNC][novnc]使用容器，需要支持HTML5的Web浏览器。实际上，任何当前的Web浏览器都可以使用。
浏览器应导航到运行容器的主机，指向映射到容器TCP端口6901的主机TCP端口。
但是，自版本1.2.0起，容器提供两个[noVNC][novnc]客户端。除了之前可用的精简版（lite） 客户端外，还有完整版（full） 客户端，具有更多功能。两种情况下的连接URL略有不同。为方便起见，实现了一个简单的启动页面。
如果容器在名为mynas的主机上使用上述参数创建，则Web浏览器应导航到http://mynas:26901。
启动页面将显示指向两个noVNC客户端的超链接：
http://mynas:26901/vnc_lite.htmlhttp://mynas:26901/vnc.html
也可以通过链接提供密码：
http://mynas:26901/vnc_lite.html?password=headlesshttp://mynas:26901/vnc.html?password=headless
问题
如果你发现问题或有疑问，请先查看https://github.com/accetto/ubuntu-vnc-xfce/issues以及https://github.com/accetto/ubuntu-vnc-xfce/wiki中的https://github.com/accetto/ubuntu-vnc-xfce/wiki/Troubleshooting、https://github.com/accetto/ubuntu-vnc-xfce/wiki/Frequently-asked-questions和https://github.com/accetto/ubuntu-vnc-xfce/wiki/How-to部分。请不要忽略已关闭的问题。
如果未找到解决方案，可以提交新问题。你对问题的描述越详细，问题被快速解决的可能性就越大。
致谢
本项目最初受旧Docker镜像[consol/ubuntu-xfce-vnc][consol-docker-ubuntu-xfce-vnc]启发，并源自GitHub仓库[ConSol/docker-headless-vnc-container][consol-github-docker-headless-vnc-container]的旧版本。
同时感谢所有为开源社区做出贡献的无数个人和公司，是他们让许多梦想成为现实。
[acc
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 ubuntu-vnc-xfce 镜像标签
docker pull docker.xuanyuan.run/accetto/ubuntu-vnc-xfce:<标签>
DockerHub 原生拉取命令
docker pull accetto/ubuntu-vnc-xfce:<标签>
更多 ubuntu-vnc-xfce 镜像推荐
ubuntu/squid
Ubuntu 官方镜像
Squid是一款广泛应用的Web缓存代理服务器，主要功能是缓存网页内容，通过存储用户频繁访问的资源来加快后续访问速度并有效减轻源服务器的负载，其长期支持版本由Canonical公司负责持续维护与更新。
127 次收藏1000万+ 次下载
4 天前更新
ubuntu/nginx
Ubuntu 官方镜像
Nginx是一款高性能的反向代理和Web服务器，以高并发处理能力、低资源消耗及出色的稳定性著称，广泛应用于各类网站架构中，承担请求转发、负载均衡、静态资源服务等关键任务，其长期跟踪版本由Canonical公司负责维护，为用户提供持续可靠的技术支持与版本更新。
141 次收藏1000万+ 次下载
4 天前更新
ubuntu/bind9
Ubuntu 官方镜像
BIND 9是灵活且功能全面的DNS系统，提供由Canonical维护的长期版本。
118 次收藏100万+ 次下载
4 天前更新
ubuntu/kafka
Ubuntu 官方镜像
Apache Kafka 是一个分布式事件流平台，它支持高吞吐量、低延迟的实时数据流处理与传输，可广泛应用于消息传递、日志聚合、实时分析、数据集成等场景，其长期维护轨道由 Canonical 负责，以确保平台在稳定性、安全性及功能迭代方面获得持续支持，为企业级用户提供可靠的事件流处理解决方案。
60 次收藏100万+ 次下载
2 个月前更新
ubuntu/zookeeper
Ubuntu 官方镜像
ZooKeeper提供集中式配置信息维护，由Canonical提供长期支持的跟踪版本。
14 次收藏100万+ 次下载
26 天前更新
ubuntu/apache2
Ubuntu 官方镜像
Apache是一款安全且可扩展的开源HTTP服务器，提供由Canonical维护的长期支持版本。
103 次收藏100万+ 次下载
6 天前更新
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
专属域名拉取
无需登录使用专属域名
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
Harbor 镜像源配置
Harbor Proxy Repository 对接专属域名
Portainer 镜像源配置
Portainer Registries 加速拉取
Nexus 镜像源配置
Nexus3 Docker Proxy 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
使用与功能问题
配置了专属域名后，docker search 为什么会报错？
docker search 限制
Docker Hub 上有的镜像，为什么在轩辕镜像网站搜不到？
站内搜不到镜像
机器不能直连外网时，怎么用 docker save / load 迁镜像？
离线 save/load
docker pull 拉插件报错（plugin v1+json）怎么办？
插件要用 plugin install
WSL 里 Docker 拉镜像特别慢，怎么排查和优化？
WSL 拉取慢
轩辕镜像安全吗？如何用 digest 校验镜像没被篡改？
安全与 digest
第一次用轩辕镜像拉 Docker 镜像，要怎么登录和配置？
新手拉取配置
轩辕镜像合规吗？轩辕镜像的合规是怎么做的？
镜像合规机制
错误码与失败问题
docker pull 提示 manifest unknown 怎么办？
manifest unknown
docker pull 提示 no matching manifest 怎么办？
no matching manifest（架构）
镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？
invalid tar header（解压）
Docker pull 时 HTTPS / TLS 证书验证失败怎么办？
TLS 证书失败
Docker pull 时 DNS 解析超时或连不上仓库怎么办？
DNS 超时
docker 无法连接轩辕镜像域名怎么办？
域名连通性排查
Docker 拉取出现 410 Gone 怎么办？
410 Gone 排查
出现 402 或「流量用尽」提示怎么办？
402 与流量用尽
Docker 拉取提示 UNAUTHORIZED（401）怎么办？
401 认证失败
遇到 429 Too Many Requests（请求太频繁）怎么办？
429 限流
docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？
D-Bus 凭证提示
为什么会出现「单层超过 20GB」或 413，无法加速拉取？
413 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"