Linux怎么安装Apache Maven并配置私服 Linux下Maven设置详解

浅墨君_8252

浅墨君_8252

2026-06-04

630人浏览

原创

linux安装maven需先确认jdk 11+已就位,再解压至/opt/并配置m2_home与path到~/.bashrc;settings.xml优先放~/.m2/,配阿里云镜像及本地仓库路径,私服还需同步配置servers、mirrors和pom.xml的distributionmanagement。

linux怎么安装apache maven并配置私服 linux下maven设置详解

Linux 上装 Maven 本身不难,真正卡住人的地方是 settings.xml 配置错位、镜像没生效、本地仓库路径权限不对,或者私服认证被 silently 忽略——这些都不会报明确错误,只会让你等十几分钟然后发现依赖全从中央仓慢速下载。

怎么解压并设好 M2_HOME 和 PATH

别直接改 /etc/profile 全局配置,除非你确定所有用户都要用同一套 Maven。更稳妥的做法是写进当前用户的 ~/.bashrc 或 ~/.zshrc:

  • 先确认 JDK 已就位:java -version 输出应含 1.8+ 或 11+,Maven 3.9+ 要求 JDK 11+
  • 下载后解压(以 3.9.6 为例):tar -xzvf apache-maven-3.9.6-bin.tar.gz -C /opt/
  • 编辑 ~/.bashrc,追加两行:
    export M2_HOME=/opt/apache-maven-3.9.6
    export PATH=$M2_HOME/bin:$PATH
  • 执行 source ~/.bashrc,再跑 mvn -v 看输出里 Maven home 是否指向你刚设的路径

如果 mvn -v 报 command not found,八成是 PATH 拼写错了(比如写成 Path 或漏了 $),或 source 没执行。

settings.xml 放哪?改哪个?

Maven 会按顺序加载三处 settings.xml:Maven 安装目录下的 $M2_HOME/conf/settings.xml(全局)、用户目录下的 ~/.m2/settings.xml(推荐)、以及项目级的(不常用)。优先用用户级,避免污染全局配置:

  • 首次运行 mvn clean 后,~/.m2 目录会自动生成;若没有,手动建:mkdir -p ~/.m2
  • 把 $M2_HOME/conf/settings.xml 复制一份到 ~/.m2/settings.xml:cp $M2_HOME/conf/settings.xml ~/.m2/
  • 重点改两块:
    — 取消注释并修改 <localrepository></localrepository>,比如设为 /home/yourname/m2-repo(确保该路径存在且可写)
    — 在 <mirrors></mirrors> 下加阿里云镜像(国内最稳):
    <mirror><br><id>nexus-aliyun</id><br><mirrorof>central</mirrorof><br><name>Nexus aliyun</name><br><url>https://maven.aliyun.com/repository/public</url><br></mirror>

注意:<mirrorof>central</mirrorof> 表示只代理中央仓库;若想代理全部远程仓(包括第三方插件库),得写 <mirrorof>*</mirrorof>,但某些私有插件可能因此拉不到。

Linux installer
Linux installer

先解析安全源,运行本地CLI安装、启动、卸载Linux桌面应用。用户请求时使用。

下载

连 Nexus 私服要填哪些关键项?

光配镜像不够,上传或拉取私有构件必须做三件事:声明镜像、声明服务器凭据、在 pom.xml 里指定分发仓库地址。缺一不可:

  • 在 ~/.m2/settings.xml 的 <servers></servers> 块里加账号(Nexus 默认 admin/admin123,但 Nexus 3 会生成随机初始密码,查 cat /opt/sonatype-work/nexus3/admin.password):
    <server><br><id>nexus-releases</id><br><username>admin</username><br><password>{你的明文或加密密码}</password><br></server>
  • 在同一个 settings.xml 的 <mirrors></mirrors> 里加私服镜像(注意 <id></id> 必须和上面 <server></server> 的 <id></id> 一致):
    <mirror><br><id>nexus-releases</id><br><mirrorof>central</mirrorof><br><url>http://your-nexus-host:8081/repository/maven-releases/</url><br></mirror>
  • 项目 pom.xml 中必须声明 <distributions></distributions>:
    <distributionmanagement><br><repository><br><id>nexus-releases</id><br><url>http://your-nexus-host:8081/repository/maven-releases/</url><br></repository><br></distributionmanagement>

最容易漏的是第三步:mvn deploy 时若没配 distributionManagement,Maven 根本不会尝试上传,也不会报错,只会默默把包留在本地仓库。

为什么 mvn clean install 还是从 central 下载?

不是镜像失效,而是你触发了“非 central 依赖”——比如用了 Spring Snapshot 仓库、JBoss 仓库,或者 pom.xml 里显式写了 <repository></repository>。Maven 镜像只代理 <mirrorof></mirrorof> 指定的仓库,其他仓库绕过镜像直连。

  • 运行 mvn help:effective-settings 确认最终生效的 settings.xml 路径和内容
  • 加 -X 参数看详细日志:mvn -X compile,搜索 Downloading from,看它实际连的是哪个 URL
  • 如果看到 Downloading from central 却没走阿里云地址,说明镜像配置的 <id></id> 和 <mirrorof></mirrorof> 不匹配,或 settings.xml 加载顺序被覆盖(比如 IDE 自带 Maven 套件用了自己的配置)

私服调试最耗时间的从来不是安装,而是反复验证每层配置是否真的被读取、是否被覆盖、是否拼写一致——id 字符串大小写敏感,http 和 https 不能混用,Nexus 3 的 repository path 必须带末尾斜杠,这些细节错一个,整个链路就静默降级。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

linux

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Java Maven专题
Java Maven专题

本专题聚焦 Java 主流构建工具 Maven 的学习与应用,系统讲解项目结构、依赖管理、插件使用、生命周期与多模块项目配置。通过企业管理系统、Web 应用与微服务项目实战,帮助学员全面掌握 Maven 在 Java 项目构建与团队协作中的核心技能。

2025.09.15

3320

19

Java Maven/Gradle 构建与依赖管理合集
Java Maven/Gradle 构建与依赖管理合集

系统讲解 Java 项目构建工具的使用与进阶配置,涵盖 Maven 的 POM 文件结构、生命周期(clean/compile/package/install/deploy)与插件机制、依赖范围(compile/provided/test/runtime)与传递依赖管理、多模块聚合与继承、私有 Nexus 仓库发布,以及 Gradle 的 Groovy / Kotlin DSL 语法、Task 自定义与增量构建、依赖版本目录(Versi

2026.05.09

349

25

磁盘配额是什么
磁盘配额是什么

磁盘配额是计算机中指定磁盘的储存限制,就是管理员可以为用户所能使用的磁盘空间进行配额限制,每一用户只能使用最大配额范围内的磁盘空间。php中文网为大家提供各种磁盘配额相关的内容,教程,供大家免费下载安装。

2023.06.21

3870

4

如何安装LINUX
如何安装LINUX

本站专题提供如何安装LINUX的相关教程文章,还有相关的下载、课程,大家可以免费体验。

2023.06.29

3333

10

linux find
linux find

find是linux命令,它将档案系统内符合 expression 的档案列出来。可以指要档案的名称、类别、时间、大小、权限等不同资讯的组合,只有完全相符的才会被列出来。find根据下列规则判断 path 和 expression,在命令列上第一个 - ( ) , ! 之前的部分为 path,之后的是 expression。还有指DOS 命令 find,Excel 函数 find等。本站专题提供linux find相关教程文章,还有相关

2023.06.30

2473

5

linux修改文件名
linux修改文件名

本专题为大家提供linux修改文件名相关的文章,这些文章可以帮助用户快速轻松地完成文件名的修改工作,大家可以免费体验。

2023.07.05

5930

7

linux系统安装教程
linux系统安装教程

linux系统是一种可以免费使用,自由传播,多用户、多任务、多线程、多CPU的操作系统。本专题提供linux系统安装教程相关的文章,大家可以免费体验。

2023.07.06

5582

7

linux查看文件夹大小
linux查看文件夹大小

Linux是一种自由和开放源码的类Unix操作系统,存在着许多不同的Linux版本,但它们都使用了Linux内核。Linux可安装在各种计算机硬件设备中,比如手机、平板电脑、路由器、视频游戏控制台、台式计算机、大型机和超级计算机。linux怎么查看文件夹大小呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.20

3273

8

linux查看ip命令
linux查看ip命令

本专题为大家提供linux查看ip命令相关文章内容,感兴趣的朋友可以免费下载体验试试。

2023.07.20

2785

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习