
如果你使用 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
该镜像已正式弃用,建议所有用户尽快寻找并使用合适的替代方案。以下是部分官方镜像替代方案示例(按字母顺序排列,无优先级暗示):
amazoncorrettoeclipse-temurinibm-semeru-runtimesibmjavasapmachine更多信息可查看[docker-library/openjdk#505] 。
2022年7月后,仅早期访问版(Early Access builds,源码来自[jdk.java.net] )标签会继续更新,因为上述项目均不发布或支持此类版本。
[Docker社区]
[Docker社区Slack] 、[Server Fault] 、[Unix & Linux] 或 [Stack Overflow]
Dockerfile链接(关于“共享标签”与“简单标签”的区别,参见FAQ中的[“‘Shared’和‘Simple’标签有何不同?”] )
[26-ea-18-jdk-oraclelinux9, 26-ea-18-oraclelinux9, 26-ea-jdk-oraclelinux9, 26-ea-oraclelinux9, 26-jdk-oraclelinux9, 26-oraclelinux9, 26-ea-18-jdk-oracle, 26-ea-18-oracle, 26-ea-jdk-oracle, 26-ea-oracle, 26-jdk-oracle, 26-oracle]
[26-ea-18-jdk-oraclelinux8, 26-ea-18-oraclelinux8, 26-ea-jdk-oraclelinux8, 26-ea-oraclelinux8, 26-jdk-oraclelinux8, 26-oraclelinux8]
[26-ea-18-jdk-trixie, 26-ea-18-trixie, 26-ea-jdk-trixie, 26-ea-trixie, 26-jdk-trixie, 26-trixie]
[26-ea-18-jdk-slim-trixie, 26-ea-18-slim-trixie, 26-ea-jdk-slim-trixie, 26-ea-slim-trixie, 26-jdk-slim-trixie, 26-slim-trixie, 26-ea-18-jdk-slim, 26-ea-18-slim, 26-ea-jdk-slim, 26-ea-slim, 26-jdk-slim, 26-slim]
[26-ea-18-jdk-bookworm, 26-ea-18-bookworm, 26-ea-jdk-bookworm, 26-ea-bookworm, 26-jdk-bookworm, 26-bookworm]
[26-ea-18-jdk-slim-bookworm, 26-ea-18-slim-bookworm, 26-ea-jdk-slim-bookworm, 26-ea-slim-bookworm, 26-jdk-slim-bookworm, 26-slim-bookworm]
[26-ea-18-jdk-windowsservercore-ltsc2025, 26-ea-18-windowsservercore-ltsc2025, 26-ea-jdk-windowsservercore-ltsc2025, 26-ea-windowsservercore-ltsc2025, 26-jdk-windowsservercore-ltsc2025, 26-windowsservercore-ltsc2025]
[26-ea-18-jdk-windowsservercore-ltsc2022, 26-ea-18-windowsservercore-ltsc2022, 26-ea-jdk-windowsservercore-ltsc2022, 26-ea-windowsservercore-ltsc2022, 26-jdk-windowsservercore-ltsc2022, 26-windowsservercore-ltsc2022]
[26-ea-18-jdk-nanoserver-ltsc2025, 26-ea-18-nanoserver-ltsc2025, 26-ea-jdk-nanoserver-ltsc2025, 26-ea-nanoserver-ltsc2025, 26-jdk-nanoserver-ltsc2025, 26-nanoserver-ltsc2025]
[26-ea-18-jdk-nanoserver-ltsc2022, 26-ea-18-nanoserver-ltsc2022, 26-ea-jdk-nanoserver-ltsc2022, 26-ea-nanoserver-ltsc2022, 26-jdk-nanoserver-ltsc2022, 26-nanoserver-ltsc2022]
26-ea-18-jdk, 26-ea-18, 26-ea-jdk, 26-ea, 26-jdk, 26:
26-ea-18-jdk-oraclelinux9]26-ea-18-jdk-windowsservercore-ltsc2025]26-ea-18-jdk-windowsservercore-ltsc2022]26-ea-18-jdk-windowsservercore, 26-ea-18-windowsservercore, 26-ea-jdk-windowsservercore, 26-ea-windowsservercore, 26-jdk-windowsservercore, 26-windowsservercore:
26-ea-18-jdk-windowsservercore-ltsc2025]26-ea-18-jdk-windowsservercore-ltsc2022]26-ea-18-jdk-nanoserver, 26-ea-18-nanoserver, 26-ea-jdk-nanoserver, 26-ea-nanoserver, 26-jdk-nanoserver, 26-nanoserver:
26-ea-18-jdk-nanoserver-ltsc2025]26-ea-18-jdk-nanoserver-ltsc2022][[]]
(更多信息参见[官方镜像文档] )
[amd64] 、[arm64v8] 、[windows-amd64]
[repo-info仓库的repos/openjdk/目录] ([历史记录] )
(包含镜像元数据、传输大小等)
[official-images仓库的library/openjdk标签]
[official-images仓库的library/openjdk文件] ([历史记录] )
[docs仓库的openjdk/目录] ([历史记录] )
OpenJDK(开放Java开发工具包)是Java平台标准版(Java SE)的免费开源实现。自版本7起,OpenJDK成为Java SE的官方参考实现。
Java是Oracle及其关联公司的注册商标。
![logo]
使用该镜像最直接的方式是将Java容器同时作为构建和运行环境。在Dockerfile中,可以按以下方式编写,以编译并运行项目:
dockerfileFROM openjdk:11 COPY . /usr/src/myapp WORKDIR /usr/src/myapp RUN javac Main.java CMD ["java", "Main"]
然后构建并运行Docker镜像:
console$ docker build -t my-java-app . $ docker run -it --rm --name my-running-app my-java-app
有时可能不需要在容器内运行应用,仅需编译。可通过以下命令在Docker实例内编译(但不运行)应用:
console$ docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp openjdk:11 javac Main.java
该命令会将当前目录挂载为容器卷,设置工作目录为该卷,然后执行javac Main.java编译Main.java,输出Main.class文件。
JVM启动时会尝试检测可用CPU核心数和RAM,以调整内部参数(如垃圾回收线程数)。若容器限制了CPU/RAM,JVM用于探测的标准系统API可能返回主机级别的值,导致旧版JVM出现CPU过度使用或内存分配错误。
在Linux容器中,OpenJDK 8及更高版本可正确检测容器限制的CPU核心数和可用RAM,且默认启用此功能。
在Windows Server(非Hyper-V)容器中,CPU核心数限制不生效(被主机计算服务忽略)。需手动设置限制,例如通过以下命令启动JVM:
console$ start /b /wait /affinity 0x3 path/to/java.exe ...
示例中,CPU亲和性十六进制掩码0x3将JVM限制为2个CPU核心。
RAM限制在Windows Server容器中受支持,但JVM目前无法检测。需通过-XX:MaxRAM=...参数指定不超过容器RAM限制的值,避免内存分配过度。
部分shell(如Alpine Linux中包含的[BusyBox /bin/sh] )不支持名称含点的环境变量(技术上不符合POSIX标准),会将其剥离(Bash则会保留)。若应用需要此类环境变量,可直接使用CMD ["java", ...](不通过shell),或安装并显式使用Bash替代/bin/sh。
openjdk镜像有多种版本,适用于不同场景。
openjdk:<version>这是默认镜像。若不确定需求,建议使用此版本。既可作为临时容器(挂载源码并启动容器运行应用),也可作为基础镜像构建其他镜像。
部分标签含bookworm或trixie等名称,这些是[Debian] 的版本代号,标识镜像基于哪个Debian版本。若需安装镜像自带之外的包,建议显式指定此类标签,以减少Debian版本更新时的兼容性问题。
openjdk:<version>(12及以上版本)、openjdk:<version>-oracle 和 openjdk:<version>-oraclelinux8从openjdk:12开始,默认镜像及-oracle、-oraclelinux8变体基于官方[Oracle Linux 8镜像] ,该镜像根据[Oracle Linux最终用户协议(EULA)]([]
以下是 openjdk 相关的常用 Docker 镜像,适用于 不同场景 等不同场景:
在国内网络环境下,直接使用 docker pull 访问 Docker Hub 官方仓库时,较常遇到连接超时、TLS 握手失败或 registry 响应缓慢等情况。这类问题多与跨境链路质量、运营商策略及客户端 DNS 解析有关,并非单个镜像本身异常。
轩辕镜像提供两种常用加速方式:一是使用公共加速域名 docker.xuanyuan.run 拉取(可参考 登录认证方式);二是在控制台配置 专属域名拉取,将拉取命令中的 registry 前缀替换为分配的专属域名,通常能提升成功率与稳定性。
以 openjdk 为例,加速拉取命令格式为 docker pull docker.xuanyuan.run/openjdk:<标签>,请将 <标签> 替换为具体版本。下方「镜像拉取方式」区块提供与本文一致的命令示例,可直接复制使用。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务