library/maven
Apache Maven是一款基于项目对象模型（POM）的软件项目管理与理解工具，主要用于自动化项目构建流程、统一管理项目依赖、整合项目信息（如文档、报告等），并通过标准化的项目结构和生命周期管理，帮助开发团队提高协作效率、简化构建过程，确保项目开发的一致性与可重复性。
Maven Docker镜像使用指南
快速参考
维护者
Carlos Sanchez（GitHub仓库）
获取帮助渠道
- Docker社区Slack
- Server Fault
- Unix & Linux
- Stack Overflow
提交issue地址
[***]
支持的架构
（更多信息见官方说明）
amd64、arm32v7、arm64v8、ppc64le、riscv64、s390x
镜像详情
repo-info仓库的repos/maven/目录（含镜像元数据、传输大小等，历史记录）
镜像更新
- official-images仓库的
library/maven标签 - official-images仓库的
library/maven文件（历史记录）
描述来源
docs仓库的maven/目录（历史记录）
支持的标签及对应Dockerfile链接
基于Eclipse Temurin JDK的镜像
JDK 8
- Alpine基础镜像：
3.9.11-eclipse-temurin-8-alpine、3.9-eclipse-temurin-8-alpine、3-eclipse-temurin-8-alpine
Dockerfile - Noble基础镜像：
3.9.11-eclipse-temurin-8-noble、3.9.11-eclipse-temurin-8、3.9-eclipse-temurin-8-noble、3.9-eclipse-temurin-8、3-eclipse-temurin-8-noble、3-eclipse-temurin-8
Dockerfile
JDK 11
- Alpine基础镜像：
3.9.11-eclipse-temurin-11-alpine、3.9-eclipse-temurin-11-alpine、3-eclipse-temurin-11-alpine
Dockerfile - Noble基础镜像：
3.9.11-eclipse-temurin-11-noble、3.9.11-eclipse-temurin-11、3.9-eclipse-temurin-11-noble、3.9-eclipse-temurin-11、3-eclipse-temurin-11-noble、3-eclipse-temurin-11
Dockerfile
JDK 17
- Alpine基础镜像（Maven 3）：
3.9.11-eclipse-temurin-17-alpine、3.9-eclipse-temurin-17-alpine、3-eclipse-temurin-17-alpine
Dockerfile - Alpine基础镜像（Maven 4 RC）：
4.0.0-rc-4-eclipse-temurin-17-alpine
Dockerfile - Noble基础镜像（Maven 3）：
3.9.11-eclipse-temurin-17-noble、3.9.11-eclipse-temurin-17、3.9-eclipse-temurin-17-noble、3.9-eclipse-temurin-17、3-eclipse-temurin-17-noble、3-eclipse-temurin-17
Dockerfile - Noble基础镜像（Maven 4 RC）：
4.0.0-rc-4-eclipse-temurin-17-noble、4.0.0-rc-4-eclipse-temurin-17
Dockerfile
JDK 21
- Alpine基础镜像（Maven 3）：
3.9.11-eclipse-temurin-21-alpine、3.9-eclipse-temurin-21-alpine、3-eclipse-temurin-21-alpine
Dockerfile - Alpine基础镜像（Maven 4 RC）：
4.0.0-rc-4-eclipse-temurin-21-alpine
Dockerfile - Noble基础镜像（Maven 3）：
3.9.11-eclipse-temurin-21-noble、3.9.11-eclipse-temurin-21、3.9-eclipse-temurin-21-noble、3.9-eclipse-temurin-21、3-eclipse-temurin-21-noble、3-eclipse-temurin-21
Dockerfile - Noble基础镜像（Maven 4 RC）：
4.0.0-rc-4-eclipse-temurin-21-noble、4.0.0-rc-4-eclipse-temurin-21
Dockerfile
JDK 25（最新稳定版）
- Alpine基础镜像（Maven 3）：
3.9.11-eclipse-temurin-25-alpine、3.9-eclipse-temurin-25-alpine、3-eclipse-temurin-25-alpine
Dockerfile - Alpine基础镜像（Maven 4 RC）：
4.0.0-rc-4-eclipse-temurin-25-alpine
Dockerfile - Noble基础镜像（Maven 3，含默认标签）：
3.9.11-eclipse-temurin-25-noble、3.9.11、3.9.11-eclipse-temurin、3.9.11-eclipse-temurin-25、3.9-eclipse-temurin-25-noble、3.9、3.9-eclipse-temurin、3.9-eclipse-temurin-25、3-eclipse-temurin-25-noble、3、latest、3-eclipse-temurin、eclipse-temurin、3-eclipse-temurin-25
Dockerfile - Noble基础镜像（Maven 4 RC）：
4.0.0-rc-4-eclipse-temurin-25-noble、4.0.0-rc-4、4.0.0-rc-4-eclipse-temurin、4.0.0-rc-4-eclipse-temurin-25
Dockerfile
基于IBM Java/IBM Semeru JDK的镜像
IBM Java 8
- 标签：
3.9.11-ibmjava-8、3.9.11-ibmjava、3.9-ibmjava-8、3.9-ibmjava、3-ibmjava-8、3-ibmjava、ibmjava
Dockerfile
IBM Semeru JDK 11/17/21（Noble基础镜像）
- JDK 11：
3.9.11-ibm-semeru-11-noble、3.9-ibm-semeru-11-noble、3-ibm-semeru-11-noble
Dockerfile - JDK 17（Maven 3）：
3.9.11-ibm-semeru-17-noble、3.9-ibm-semeru-17-noble、3-ibm-semeru-17-noble
Dockerfile - JDK 17（Maven 4 RC）：
4.0.0-rc-4-ibm-semeru-17-noble
Dockerfile - JDK 21（Maven 3）：
3.9.11-ibm-semeru-21-noble、3.9-ibm-semeru-21-noble、3-ibm-semeru-21-noble
Dockerfile - JDK 21（Maven 4 RC）：
4.0.0-rc-4-ibm-semeru-21-noble
Dockerfile
基于Amazon Corretto JDK的镜像
（涵盖JDK 8/11/17/21/24/25，支持Alpine/Al2023/Debian/Noble基础镜像，部分提供Maven 4 RC版本，详情参见原始标签列表）
基于SAP Machine JDK的镜像
（涵盖JDK 11/17/21/25，支持Maven 3和4 RC版本，JDK 25为默认标签，详情参见原始标签列表）
什么是Maven？
Apache Maven是一款软件项目管理工具，基于项目对象模型（POM），可从中央信息源管理项目的构建、报告和文档。
如何使用本镜像
直接运行Maven项目
通过docker run命令传递Maven命令，直接运行项目：
console# 将当前目录挂载到容器内工作目录，执行mvn clean install $ docker run -it --rm --name my-maven-project -v "$(pwd)":/usr/src/mymaven -w /usr/src/mymaven maven:3.3-jdk-8 mvn clean install
构建本地Docker镜像（可选）
如需添加自定义依赖，可基于此镜像构建本地镜像。例如，修改Dockerfile后执行：
console# 构建标签为my_local_maven:3.5.2-jdk-8的本地镜像 $ docker build --tag my_local_maven:3.5.2-jdk-8 .
重用Maven本地仓库
通过创建卷挂载/root/.m2目录，实现本地仓库跨容器复用：
console# 创建名为maven-repo的卷 $ docker volume create --name maven-repo # 首次运行下载依赖，存储到卷中 $ docker run -it -v maven-repo:/root/.m2 maven mvn archetype:generate # 后续运行直接重用已下载的依赖 $ docker run -it -v maven-repo:/root/.m2 maven mvn archetype:generate
或直接挂载本地.m2目录（与本地IDE共享缓存）：
console# 挂载当前目录、本地.m2缓存和target目录，执行打包 $ docker run -it --rm -v "$PWD":/usr/src/mymaven -v "$HOME/.m2":/root/.m2 -
更多相关 Docker 镜像与资源
以下是 maven 相关的常用 Docker 镜像，适用于 不同场景 等不同场景：
- okteto/maven Docker 镜像说明（Maven 构建工具，Okteto 维护版本）
- atlassian/maven Docker 镜像说明（Maven 构建工具，Atlassian 维护版本，适合 Java 项目构建）
- library/openjdk Docker 镜像说明
- library/gradle Docker 镜像说明（Gradle 构建工具，适合 Java 和 Android 项目）
- cimg/openjdk Docker 镜像说明（OpenJDK 运行时，CI/CD 优化版本，适合持续集成环境）
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 版本下载页面。
更多 maven 镜像推荐
okteto/maven
okteto
用于Okteto CLI的Java Maven开发环境镜像，Okteto是面向开发者的Kubernetes工具。
10万+ 次下载
1 个月前更新
chainguard/maven
chainguard
使用Chainguard的低至零CVE容器镜像构建、交付和运行安全软件。
5万+ 次下载
10 天前更新
atlassian/maven
atlassian
在预创建的非root用户下运行的Apache Maven
6 次收藏6.4千+ 次下载
7 年前更新
activestate/maven
activestate
ActiveState的可定制、低/零漏洞Maven容器镜像，提供安全、最新的Maven工具链，适用于构建和运行Maven应用程序，为生产级镜像提供可靠精简基础。
3.5千+ 次下载
10 天前更新
paketobuildpacks/maven
paketobuildpacks
暂无描述
10万+ 次下载
14 天前更新
eucm/maven
eucm
包含Maven 3.3.9和Java JDK 8的Docker镜像仓库，提供便捷的Java项目构建环境。
1 次收藏1万+ 次下载
9 年前更新
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
专属域名拉取
无需登录使用专属域名
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
Harbor 镜像源配置
Harbor Proxy Repository 对接专属域名
Portainer 镜像源配置
Portainer Registries 加速拉取
Nexus 镜像源配置
Nexus3 Docker Proxy 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
使用与功能问题
错误码与失败问题
docker pull 提示 manifest unknown 怎么办？
manifest unknown
docker pull 提示 no matching manifest 怎么办？
no matching manifest（架构）
镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？
invalid tar header（解压）
Docker pull 时 HTTPS / TLS 证书验证失败怎么办？
TLS 证书失败
Docker pull 时 DNS 解析超时或连不上仓库怎么办？
DNS 超时
Docker 拉取出现 410 Gone 怎么办？
410 Gone 排查
出现 402 或「流量用尽」提示怎么办？
402 与流量用尽
Docker 拉取提示 UNAUTHORIZED（401）怎么办？
401 认证失败
遇到 429 Too Many Requests（请求太频繁）怎么办？
429 限流
docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？
D-Bus 凭证提示
为什么会出现「单层超过 20GB」或 413，无法加速拉取？
413 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"