library/eclipse-temurin

Eclipse Temurin Docker 镜像使用指南

快速参考

维护者

[Adoptium]

获取帮助

[Adoptium Slack] ；[Adoptium 支持页面]

支持的标签及对应 Dockerfile 链接

说明：由于镜像描述长度超过 Docker Hub 25000 字符限制，"支持的标签"列表已精简。完整列表请参见：
[GitHub 文档中的“支持的标签及对应 Dockerfile 链接”]

快速参考（续）

问题反馈

[GitHub Issues] ；关于 Eclipse Temurin 构建的质量、路线图和支持级别，可参考 [Adoptium 支持页面] 。非 Temurin 本身的漏洞（如 Ubuntu 系统漏洞）需直接反馈给对应项目。

支持的架构

（[更多信息] ）
[amd64] 、[arm32v7] 、[arm64v8] 、[ppc64le] 、[riscv64] 、[s390x] 、[windows-amd64]

镜像 artifact 详情

[repo-info 仓库的 repos/eclipse-temurin/ 目录] （[历史记录] ）
（包含镜像元数据、传输大小等）

镜像更新

[official-images 仓库的 library/eclipse-temurin 标签]
[official-images 仓库的 library/eclipse-temurin 文件] （[历史记录] ）

描述来源

[docs 仓库的 eclipse-temurin/ 目录] （[历史记录] ）

概述

本仓库中的镜像包含由 Eclipse Temurin 构建的 OpenJDK 二进制文件。

什么是 Eclipse Temurin？

Eclipse Temurin 项目提供代码和流程，支持构建高性能、企业级、跨平台、开源许可且通过 Java SE TCK 测试的运行时二进制文件及相关技术，供 Java 生态系统通用。

![logo]

是否提供 JRE（Java 运行时环境）镜像？

所有版本的 Eclipse Temurin 均提供 JRE 镜像，但建议使用 jlink 生成自定义 JRE 类运行时（见下方使用示例）。

如何添加内部 CA 证书到信任库？

除 Windows 镜像外，所有镜像均可添加 CA 证书。证书格式需符合基础镜像 OS 的要求，PEM 格式且扩展名为 .crt 是通用选择。

操作步骤：

1. 将 CA 证书放入容器内 /certificates 目录（可通过挂载卷实现）；
2. 设置环境变量 USE_SYSTEM_CA_CERTS（任意值）以启用证书处理（若自定义入口脚本，需调用 /__cacert_entrypoint.sh）。

Docker CLI 示例：

console
$ docker run -v $(pwd)/certs:/certificates/ -e USE_SYSTEM_CA_CERTS=1 eclipse-temurin:21

此时，证书会添加到 JVM 信任库和系统 CA 存储（供 curl 等工具使用）。但在默认限制环境（如 Red Hat OpenShift）中存在以下差异：

• 非 root 用户运行：JVM 和系统信任库不可写，系统 CA 存储不更新，但会为 JVM 创建独立信任库，证书添加至此，并通过 JAVA_TOOL_OPTIONS 自动切换 JVM 使用新信任库。自定义入口脚本需手动指定新信任库路径（通过 JRE_CACERTS_PATH 环境变量获取）。

• 只读文件系统：与非 root 用户限制相同，需在 /tmp 挂载可写卷以创建新信任库。

如何使用镜像

基础用法（运行 jar 文件）

Dockerfile：

dockerfile
FROM docker.xuanyuan.run/eclipse-temurin:21
RUN mkdir /opt/app
COPY japp.jar /opt/app
CMD ["java", "-jar", "/opt/app/japp.jar"]

构建并运行：

console
docker build -t japp .
docker run -it --rm docker.xuanyuan.run/japp

使用自定义基础镜像

若需基于其他发行版构建，可复制 JDK：

dockerfile
# 示例
FROM docker.xuanyuan.run/<base image>
ENV JAVA_HOME=/opt/java/openjdk
COPY --from=eclipse-temurin:21 $JAVA_HOME $JAVA_HOME
ENV PATH="${JAVA_HOME}/bin:${PATH}"

用 jlink 创建自定义 JRE（OpenJDK 21+）

多阶段构建示例：

dockerfile
# 阶段 1：构建 JRE
FROM docker.xuanyuan.run/eclipse-temurin:21 as jre-build
RUN $JAVA_HOME/bin/jlink \
         --add-modules java.base \
         --strip-debug \
         --no-man-pages \
         --no-header-files \
         --compress=2 \
         --output /javaruntime

# 阶段 2：部署应用
FROM docker.xuanyuan.run/debian:buster-slim
ENV JAVA_HOME=/opt/java/openjdk
ENV PATH "${JAVA_HOME}/bin:${PATH}"
COPY --from=jre-build /javaruntime $JAVA_HOME

RUN mkdir /opt/app
COPY japp.jar /opt/app
CMD ["java", "-jar", "/opt/app/japp.jar"]

挂载主机 jar 文件

将主机 jar 目录挂载到容器：

Dockerfile：

dockerfile
FROM docker.xuanyuan.run/eclipse-temurin:21.0.2_13-jdk
CMD ["java", "-jar", "/opt/app/japp.jar"]

构建并运行：

console
docker build -t japp .
docker run -it -v /path/on/host/system/jars:/opt/app docker.xuanyuan.run/japp

镜像变体

eclipse-temurin:<version>

默认镜像，适用于大多数场景（临时容器或基础镜像）。标签中含 jammy/noble 等 Ubuntu 发行版代号，指定基础系统版本，安装额外包时建议显式指定以减少兼容性问题。

eclipse-temurin:<version>-alpine

基于 [Alpine Linux] ，体积极小（~5MB 基础镜像），适合追求最小镜像体积的场景。注意：使用 musl libc 而非 glibc，部分依赖 libc 的软件可能存在兼容性问题。

eclipse-temurin:<version>-windowsservercore

基于 Windows Server Core，仅支持 Windows 环境（如 Windows 10 专业版/企业版、Windows Server 2016+）。

许可证

• Dockerfile 及脚本：[Apache License 2.0]
• 镜像中软件：
  • OpenJDK：GNU GPL v2 带 Classpath Exception
  • 其他软件（如基础系统的 Bash 等）可能涉及其他许可证，需用户自行确保合规。

更多许可证信息可参考 [repo-info 仓库的 eclipse-temurin/ 目录] 。

使用前请确保遵守所有包含软件的许可证要求。