
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
本仓库包含基于[Ubuntu 18.04 LTS][docker-ubuntu]的Docker镜像构建资源,该镜像配备[Xfce][xfce]桌面环境和[VNC][tigervnc]/[noVNC][novnc]服务器,适用于无头使用场景。
这是我的无头镜像的第二代(G2),曾于2022年3月停用。由于发现仍有用户拉取该镜像,于2022年11月恢复项目。当前第二版(G2v2)主要在构建流程和支持脚本方面进行了改进。
若需要基于[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]。
本镜像属于[镜像层级][this-wiki-image-hierarchy]的一部分,基于[accetto/xubuntu-vnc-novnc][accetto-docker-xubuntu-vnc-novnc]构建,继承了其所有功能,因此此处不再重复完整描述。
latest镜像继承的功能包括:
.deb包并解析依赖(Ubuntu发行版)并额外添加:
重要变更历史记录在[CHANGELOG][this-changelog]中。
以下镜像标签会定期维护和重建:
latest:基于accetto/xubuntu-vnc-novnc:latest[GitHub仓库][this-github-xubuntu-vnc-novnc-chromium]包含以下可用于构建镜像的Dockerfile:
Dockerfile.chromiumlatest镜像标签的主要Dockerfile,默认基于accetto/xubuntu-vnc-novnc:latest标签。通过提供BASETAG构建参数,可基于其他基础标签构建镜像,例如accetto/xubuntu-vnc-novnc:lab。暴露以下TCP端口:
容器默认不创建或使用任何外部卷,但以下文件夹适合作为挂载点:/home/headless/Documents/、/home/headless/Downloads/、/home/headless/Pictures/、/home/headless/Public/
支持命名卷和绑定挂载。有关卷的更多信息,请参阅[Docker文档][docker-doc](例如[管理Docker中的数据][docker-doc-managing-data])。
基于这些镜像创建的容器以非root默认应用用户(headless,1001:0)运行。但sudo命令允许用户提权。有关详细描述,请查看基础镜像[accetto/xubuntu-vnc-novnc][accetto-docker-xubuntu-vnc-novnc]或[Wiki][this-wiki]。
版本标签具有多种用途,详情在[Wiki][this-wiki]中描述。版本标签值标识Docker镜像版本,在构建时持久化到镜像中,并在README文件中以徽章形式显示。
脚本version_sticker.sh可随时用于便捷检查已安装应用的当前版本。该脚本部署在启动文件夹中,启动文件夹由环境变量STARTUPDIR定义,默认值为/dockerstartup。
在容器内不带参数执行该脚本时,返回容器的当前版本标签值,该值基于容器中必要应用的当前版本重新计算。若任何包含的应用已更新到其他版本,当前版本标签值将与持久化值不同。
使用参数-v(小写v)调用脚本时,输出版本标签值中包含的必要应用的详细版本。使用参数-V(大写v)时,输出更多应用的详细版本。示例可在[Wiki][this-wiki]中找到。
有两种使用创建的无头容器的方式。请参考基础镜像[accetto/xubuntu-vnc-novnc][accetto-docker-xubuntu-vnc-novnc]了解详情。
注意,默认VNC用户密码为headless。
若发现问题或有疑问,请先查看[Issues][this-issues]和[Wiki][this-wiki],不要忽略已关闭的问题。若未找到解决方案,可提交新问题。问题描述越详细,解决的可能性越大。
感谢所有为开源社区做出贡献的无数个人和公司,是他们让许多梦想成为现实。
注意:此镜像中的[Chromium浏览器][chromium]以
--no-sandbox模式运行。您应了解其影响。该镜像适用于测试和开发场景。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务