如果你使用 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
本仓库的master分支包含构建基础镜像的信息,该基础镜像是所有平台特定子镜像的基础。基础镜像被视为抽象镜像,正常使用场景下不应直接在容器中运行。尽管如此,基础镜像设计为可运行的,以便Docker镜像开发者在开发针对新平台的子镜像时进行测试。
本仓库包含多个分支,每个分支对应一个目标平台。更多详情请参见各分支的README.md文件:
尽管这些Docker镜像的主要用途是构建Urho3D项目,但任何重用Urho3D构建系统的Urho3D下游项目也可受益于该Docker化构建环境。因此,只需将README.md中所有对Urho3D项目的引用替换为您自己的项目即可。
除非需要将默认locale更改为非en_US.UTF-8,否则无需自行构建基础镜像。
| 构建参数 | 默认值 | 描述 |
|---|---|---|
| lang | en_US.UTF-8 | 语言locale设置 |
示例:
bash$ docker build --build-arg lang=en_SG.UTF-8 --tag=urho3d/dockerized .
如前所述,基础镜像主要供Docker镜像开发者使用。运行基础镜像或其子镜像时,至少需要传入Urho3D项目根目录位置,并确保容器内运行用户可访问这些文件。这通过将主机文件系统中的Urho3D项目根目录挂载到容器内的本地位置,然后设置PROJECT_DIR环境变量指向该本地位置,并设置HOST_UID和HOST_GID为Urho3D项目根目录所有者在主机文件系统中的用户ID和组ID来实现。
示例:
bash$ docker run -it --rm \ --mount type=bind,source=/host-path/to/urho3D,target=/local-path/to/urho3d \ -e PROJECT_DIR=/local-path/to/urho3d \ -e HOST_UID=1234 -e HOST_GID=1234 \ urho3d/dockerized
正常输入exit即可退出shell。shell进程使用urho3d用户ID调用,该用户仅在容器内动态创建(使用指定的UID和GID),并可无密码使用sudo命令以root身份安装新软件包。urho3d用户在挂载的(本地)Urho3D项目目录中创建的任何新文件(如构建产物),在容器停止后,主机文件系统中Urho3D项目根目录的所有者仍可访问。
警告:在容器内挂载的Urho3D项目目录中删除的任何文件也将从主机文件系统中永久删除!
在该挂载目录外创建或删除的任何内容仅在容器内临时存在,即容器停止并移除后将全部消失。要提交此类更改,必须如本章开头所述,在新的Dockerfile中相应地编写脚本指令。
Urho3D项目中提供了一个便捷的shell脚本来运行Docker镜像,位于Urho3D项目根目录的script目录下,名为dockerized.sh。假设调用该shell脚本的用户也是Urho3D项目根目录的所有者,只需输入以下命令即可运行基础镜像:
bash$ script/dockerized.sh base
更多详情请参考Urho3D项目在线文档https://urho3d.github.io/documentation/HEAD/_building.html#Dockerized_Build_Environment%E3%80%82
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。






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