
如果你用 DeepSeek、元宝AI、Copilot 等 AI 代为编写轩辕镜像的 docker pull、修改 compose 镜像地址,或排查拉取失败等问题,请让 AI 先读规则再动手,只要在 AI 对话里直接发送下面这句话即可:
生成 docker pull、修改 compose 的 image,或排查拉取失败前,请先阅读并严格遵守 https://xuanyuan.cloud/agents.md 中的规则。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
视频演示 [***]
https://github.com/cclient/ubuntu-vnc-xfce-chromium-g3
百度云
迅雷
网易云音乐
网易云音乐-Unblock
搜狗拼音输入法
xnview-图片浏览器
SMPlayer-视频播放
dupeguru-重复文件检索
Chromium
UI中文语言支持
...
考虑镜像体积,只装了个人觉得必要的部分,有其他需求可以进入容器内自行安装
个人试过nextcloud客户端,vlc,wps,mega,都可以安装成功并运行
https://hub.docker.com/repository/docker/cclient/ubuntu-vnc-xfce-chromium-g3
vnc客户端访问
docker run --user root -d --name vnc -e VNC_PW=headless -e LIBVA_DRIVER_NAME=iHD -v /root/headless_config_baidunetdisk:/home/headless/.config/baidunetdisk -v /root/headless_cache:/home/headless/.cache -v /root/headless_ThunderNetwork:/home/headless/ThunderNetwork --device /dev/dri:/dev/dri -p 5901:5901 cclient/ubuntu-vnc-xfce-chromium-g3:vnc
浏览器访问
docker run --user root -d --name vnc -e VNC_PW=headless -e LIBVA_DRIVER_NAME=iHD -v /root/headless_config_baidunetdisk:/home/headless/.config/baidunetdisk -v /root/headless_cache:/home/headless/.cache -v /root/headless_ThunderNetwork:/home/headless/ThunderNetwork --device /dev/dri:/dev/dri -p 6901:6901 cclient/ubuntu-vnc-xfce-chromium-g3:vnc-novnc
参数说明
通用参数
--user headless / root 以指定用户身份访问,root其实方便一些,不过有些软件例如vlc, nextcloud 无法以root 用户执行,需要以headless运行,或更改设置,若直接以headless启动,则因为部分目录权限问题,不可保存登录状态,需以root进入容器,更改相关目录的权限
-e VNC_PW=headless vnc 密码
-e LANG='zh_CN.utf8' 指定UI为中文,默认英语,建议对英文环境不熟悉的先用中文进入熟悉环境,然后以英语启动,中文环境下终端的字体比较诡异
视频硬解显卡相关参数-实际并不生效,未解决
--device /dev/dri:/dev/dri 显卡,映射显卡,硬解使用,虽然查看显卡信息正常,但我个人硬解并不生效,部分环境没有/dev/dri 路径,移除该项参数即可
-e LIBVA_DRIVER_NAME=iHD 显卡名称,需根据不同的显卡调整,我个人的U集显为hd630 LIBVA_DRIVER_NAME设置为iHD,hd610可能是i915 其他显卡需要自行测试
支持`i915,i965,iHD,iris,kms_swrast,nouveau,nouveau_vieux,r200,r300,r600,radeon,radeonsi,swrast,virtio_gpu,vmwgfx,zink这些参数,可以查询相应的显卡设置值,或更改env测试
测试方法如下,更改环境变量后执行vainfo
CODE_TOKEN_0
匹配成功则输出
CODE_TOKEN_1
匹配失败则输出
CODE_TOKEN_2
不过虽然看样子驱动成功了,但个人实际播放视频并没有使用硬解,我也不知哪里的问题,还希望熟悉的提示解决
软件状态保持参数-需-v映射外部目录(主要是登录状态)
| 软件 | 描述 | 路径 |
|---|---|---|
| 迅雷 | 软件运行状态/用户登录信息 | /home/headless/ThunderNetwork |
| 迅雷 | 默认下载目录,可操作调整 | /home/headless/迅雷下载 |
| 百度云 | 软件运行状态/用户登录信息 | /home/headless/.config/baidunetdisk |
| 百度云 | 默认下载目录,可操作调整 | /home/headless |
| 网易云音乐 | 软件运行状态/用户登录信息 | /home/headless/.config/netease-cloud-music /home/headless/.cache/netease-cloud-music |
CODE_TOKEN_3
其实可以粗放些,直接映射这些目录,若以headless启动,则因为headless对部分目录无权限,导致无法保存,需以root更改权限,这些目录可只选择必要的挂载,挂载多了,同时启动会有更高的概率失败
操作如下
CODE_TOKEN_4
镜像适用于所有支持docker的x86/amd64
群晖安装docker套件后也同样可用,只是挂载路径和显卡路径稍有些区别
docker web界面点鼠标操作太墨迹,而且不好迁移重置,以下是群晖的使用样例,可以先跑起来,熟悉后再自行调整参数
群晖开启 ssh 登录,登录成功
创建目录 docker套件会自动创建/volume1/docker目录,先都放在/volume1/docker之下
CODE_TOKEN_5
启动服务
CODE_TOKEN_6
tag 为vnc-novnc的镜像,是通过浏览器访问,启动成功后
浏览器打开 http://synology-ip:59902 即可
https://hub.docker.com/r/accetto/ubuntu-vnc-xfce-chromium-g3/tags?page=1&ordering=last_updated 底包提供了 vnc,vnc-novnc 两项tag
vnc 以vnc 客户端访问
vnc-novnc 以浏览器访问
值得说明的是vnc-novnc 默认是以http方式访问,http整体安全性较低,因此只适合内网访问,公网访问有安全隐患
解决办法
一是 通过nginx等反向代理软件把http包装为https服务,这里就不引申了
二是 套一层vpn(vpn一般自带加密解密),openvpn或飞机什么的都可以做到
PS: vpn/飞机连国外干扰的厉害些,但在国内互相连,实际是很宽松的。打工人北漂中,老家起server-北京起client,并没有察觉到有干扰异常,个人用户也没有固定ip,真封ip了,重拨换个ip就行,这也和运营商及所在地区有关,每人的体验可能不同
留心http协议的公网访问的安全性即可
国内nas,迅雷,百度云足够覆盖日常应用场景,最初参照学习选型
迅雷 https://hub.docker.com/r/yinheli/docker-thunder-xware
通过 http://yuancheng.xunlei.com/ 访问,有时会无法豆录
百度云 https://hub.docker.com/r/johnshine/baidunetdisk-crossover-vnc/
百度云
https://hub.docker.com/r/johnshine/baidunetdisk-crossover-vnc/
百度云本想用 baidunetdisk-crossover-vnc
因为这是专为群晖做的适配,个人系统为omv,当时可以启动运行,但无法登录,短期不好解决,现在的版本在omv下运行良好
了解到baidunetdisk-crossover-vnc是基于vnc实现的,我另找个vnc镜像再装个baidu云不就好了
安装百度云官方deb包 https://pan.baidu.com/download#pan
迅雷
既然有了vnc的桌面环境,找找有没有迅雷的linux包,官方的没找到,找到了网友提供安装包
https://tieba.baidu.com/p/6926605744
网易云音乐
nas除了文件下载,音乐下载也是需要的,考虑会员限制,Unblock也是需要的
首先强调下,vnc不支持音频,播放无声,只是下载
官方提供镜像 https://music.163.com/#/download
版本为1.2,不便Unblock,花了较多时间,最后完成了1.2+Unblock
第三方镜像 https://github.com/InNoob/netease-cloud-music/releases 版本为1.1,Unblock容易,但安装后稳定性较差,窗口无法拖拽,需重复多次运行才能成功启动
网易云音乐-Unblock
https://github.com/nondanee/UnblockNeteaseMusic
最好能把Unblock集成在镜像内,并且可以切换是否使用代理,有会员的直接使用,无会员的Unblock使用
集成了Unblock服务
并在桌面上添加了两个图标
搜狗拼音输入法
中文环境,需要中文输入法
百度输入法 https://srf.baidu.com/site/guanwang_linux/index.html
安装包太大了,考虑镜像的体积,放弃
搜狗输入法 https://pinyin.sogou.com/linux/?r=pinyin
体积较小
xnview-图片浏览器
迅雷和百度云下的文件,主要是图片和视频类,需要基本的查看预览
图片浏览/管理
SMPlayer-视频播放
视频播放有个硬件直通的问题
这个我个人一直没解决-已经把显卡映身进镜像了,驱动也显示正常,但是播放时并不会使用硬解
个人试了多项视频播放器
vlc功能强大,使用的人也较多(个人mac,app,机顶盒也是用的vlc)
该镜像内视频播放器,主要目的是预览视频,不是真正的播放
同时鉴于nas 平台的性能一般,负载也是很重要的考虑因素
在同样硬解无法生效的前提下SMPlayer的负载远比vlc要低,个人感觉SMPlayer的负载是vlc的1/3
vlc的安装包也更大
因此个人选择SMPlayer,对vlc有需求的,可以直接在镜像内执行 apt-get install vlc 其他视频播放器也同理
dupeguru-重复文件检索
[***]
nas下重复文件检索也是必须的功能,dupeguru是带ui的较好的方案
安装时遇到一些问题,不过解决了
Chromium
这是底包自带的
UI中文语言支持
已安装,启动时指定环境变量生效
vnc 底包结合需要安装的软件试了多种
aicampbell/vnc-ubuntu18-xfce
https://github.com/accetto/ubuntu-vnc-xfce
https://github.com/accetto/ubuntu-vnc-xfce-g3
最终选择accetto/ubuntu-vnc-xfce-g3
对cpu性能较强,且支持硬件直通的nas机器提升有限,因为可以用虚拟机+各种直通(网卡/硬盘/显卡)的方案
对J1900之类低性能且不支硬件直通的nas 提升较大
docker的方案,整体cpu负载比虚拟机低倒是其次,主要是io的负载,不支持硬件直通的nas,除了虚拟磁盘,只能是宿主机开smb/nfs,虚拟机挂载smb/nfs之类方案,io的负载都较高
docker的方案,可以直接挂载宿主机的目录,对不支持硬件直通的设备更友好,io几乎无额外开销
负载低,耗电量也低
2019年末入了蜗牛星际的坑,然后开始入nas的坑
因为本人工作一部分就涉及linxu集群,kubernetes/k8s,大数据组件的管理和运维,对docker也比较熟悉,所以也因需整理了一些nas相关的镜像
这个镜像,断断续续花费了个人两周左右,太折腾人了
本来只是自已在使用
目前个人升级了nas方案,该方案对我个人意义降低,调整优化了下镜像,共享出来,供需要的人使用
官方的krusader中文乱码,个人加了中文支持https://hub.docker.com/repository/docker/cclient/krusader-chinese
有时间会介绍下自已的nas方案(比较廉价),并做些简单教程
End
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
发给 Cursor、ChatGPT、豆包等 AI 的说明文档
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
docker search 限制
站内搜不到镜像
离线 save/load
插件要用 plugin install
WSL 拉取慢
安全与 digest
新手拉取配置
镜像合规机制
不支持 push
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
域名连通性排查
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务