
如果你使用 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/linuxserver_medium.png?v=4&s=4000]linuxserverurl
| 类型 | 地址/详情 |
|---|---|
| *** | *** |
| IRC | freenode 频道 #linuxserver.io,更多信息见:IRC |
| 论坛 | LinuxServer.io 论坛 |
https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/Dockerfile-Bionic-green.png](https://github.com/linuxserver/docker-baseimage-gui/blob/master/Dockerfile)
一个自定义图形化基础镜像,构建包含:
我们的镜像支持多种架构,如 x86-64、arm64 和 armhf。我们利用 docker manifest 实现多平台识别。更多信息可参考 docker https://github.com/docker/distribution/blob/master/docs/spec/manifest-v2-2.md#manifest-list 和我们的公告 文章。
直接拉取 linuxserver/docker-baseimage-guacgui 即可获取对应架构的正确镜像,也可通过标签拉取特定架构的镜像。
本镜像支持的架构如下:
| 架构 | 标签 |
|---|---|
| x86-64 | amd64-latest |
| arm64 | arm64v8-latest |
| armhf | arm32v7-latest |
以下是帮助您开始创建容器的示例代码片段。
docker create \ --name=docker-baseimage-guacgui \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Europe/London \ -e APPNAME=xclock \ -e GUAC_USER=abc `#可选` \ -e GUAC_PASS=900150983cd24fb0d6963f7d28e17f72 `#可选` \ -p 8080:8080 \ -p 3389:3389 \ -v </path/to/appdata>:/config \ --restart unless-stopped \ linuxserver/docker-baseimage-guacgui
兼容 docker-compose v2 架构。
--- version: "2" services: docker-baseimage-guacgui: image: linuxserver/docker-baseimage-guacgui container_name: docker-baseimage-guacgui environment: - PUID=1000 - PGID=1000 - TZ=Europe/London - APPNAME=xclock - GUAC_USER=abc #可选 - GUAC_PASS=900150983cd24fb0d6963f7d28e17f72 #可选 volumes: - </path/to/appdata>:/config ports: - 8080:8080 - 3389:3389 restart: unless-stopped
容器镜像通过运行时传递的参数进行配置(如上所示)。这些参数以冒号分隔,表示 <外部>:<内部>。例如,-p 8080:80 表示将容器内的端口 80 暴露到主机的 8080 端口,供外部访问。
| 参数 | 功能 |
|---|---|
-p 8080 | 允许通过 HTTP 访问内部 X 服务器。 |
-p 3389 | 允许通过 RDP 访问内部 X 服务器。 |
-e PUID=1000 | 用户 ID - 详见下文说明 |
-e PGID=1000 | 组 ID - 详见下文说明 |
-e TZ=Europe/London | 指定使用的时区,例如 Europe/London |
-e APPNAME=xclock | 指定 RDP 访问时显示的图形应用名称。 |
-e GUAC_USER=abc | 指定 guacamole Web 界面的用户名。 |
-e GUAC_PASS=900150983cd24fb0d6963f7d28e17f72 | 指定 guacamole Web 界面密码的 MD5 哈希值。 |
-v /config | 包含 X 用户主目录内容。 |
这是一个用于作为图形化应用基础的基础镜像。请参考示例文件夹了解用法。
如果未设置 GUAC_USER 和 GUAC_PASS,则无需认证。
可通过以下命令生成密码的 MD5 哈希值:
echo -n password | openssl md5
printf '%s' password | md5sum
请注意,此镜像未针对互联网使用进行加固。建议使用反向 SSL 代理以提高安全性。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。






来自真实用户的反馈,见证轩辕镜像的优质服务