Maven servers、repositories、mirrors、私服配置

最新推荐文章于 2025-04-18 19:40:57 发布
最新推荐文章于 2025-04-18 19:40:57 发布
阅读量1.1k 收藏 26
点赞数 26
分类专栏： Maven 文章标签： maven java
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/qq_38074398/article/details/143754010
版权

id 标签的作用

不同的功能标签下，都可以配置 id 标签，该 id 值是自定义的，当不同的功能标签下存在同值的 id 标签，那么将这些功能标签视为一组配置。

例，配置 private-repo-1 私服的鉴权信息：

<servers>
	<server>
		<id>private-repo-1</id>
		<username>repouser</username>
		<password>repopwd</password>
	</server>
</servers>

<repositories>
	<repository>
	     <id>private-repo-1</id>
	     <url>https://maven.aliyun.com/repository/central</url>
	 </repository>
</repositories>

id:central

id:central 是一个特殊的 id 值，Maven 的中央仓库的默认ID正是 central。当所有配置的 repositories 中都搜索不到依赖时，就会走 central 从中央仓库中进行拉取。

server

服务器配置，设置 repositories 鉴权信息的地方。当们配置私服时，在此处指定私服的鉴权信息。分为两种配置方式：1.账号密码、2.私钥文件

<servers>
	<server>
		<id>private-repo-1</id>
		<username>repouser</username>
		<password>repopwd</password>
	</server>
	   
	<server>
		<id>private-repo-2</id>
		<privateKey>/path/to/private/key</privateKey>
		<passphrase>optional; leave empty if not used.</passphrase>
	</server>
</servers>

repositories

依赖仓库，下载 jar 依赖的仓库配置。分为本地仓库、远程仓库两种。

搜索规则：

  1. jar 依赖包下载时从配置的所有 repositories 逐一查找，查询顺序为配置的顺序。当所有的 repositories 都找不到需要的依赖，那么会提示找不到依赖的异常。
  2. 先检查 local repository，如果 local repository 有则直接返回，否则会向 remote repositories 请求，并缓存到 local repository。

当我们项目里面需要设置第三方的仓库时，建议 <repositories> 的第一个 <repository> 写为 id 为 center 的国内镜像仓库，后面再写第三方的<repository>。这样优先国内镜像仓库搜索，其次三方仓库搜索，速度要更快（当然也可以配置 mirrorOf 为 central 的镜像）。

<repositories>
     <!-- central -->
     <repository>
         <id>central</id>
         <url>https://maven.aliyun.com/repository/central</url>
     </repository>
     <!-- other repository -->
     <!-- ... -->
<repositories>

mirrors

mirror 镜像，重定向 remote repositories 请求地址的配置。它会拦截对 remote repositories 的相关请求，把请求里的 remote repositories url 标签值，重定向到mirror里配置的 url。

例，通过 mirrorOf 标签，配置转发 private-repo-1 私服的请求至 private-repo-2：

<mirrors>
	<mirror>
	    <id>private-repo-2-mirror</id>
	    <url>https://private-repo-2-mirror/repository/central</url>
	    <mirrorOf>private-repo-1</mirrorOf>
	</mirror>
</mirrors>

<repositories>
	<repository>
	    <id>private-repo-1</id>
	    <url>https://private-repo-1-mirror/repository/central</url>
	</repository>
</repositories>

另一个常见的例子，settings.xml 中修改阿里云镜像仓库：

<mirrors>
	<mirror>
	    <id>alimaven</id>
	    <name>aliyun maven</name>
	    <url>https://maven.aliyun.com/nexus/content/groups/public/</url>
	    <mirrorOf>central</mirrorOf>
	</mirror>
</mirrors>

mirrOf 指定的正是 central，这意味着告诉 Maven 将中央仓库的请求重定向到指定的阿里云镜像。

依赖 deploy 推送配置

全局配置 (settings.xml)：

 <!-- 全局部署推送配置 -->
<properties>
	<!-- 1. 快照 -->
	<altReleaseDeploymentRepository>xxx-snapshot-ssMnl0::default::https://packages.aliyun.com/xxx/maven/xxx-snapshot-ssmnl0/</altReleaseDeploymentRepository>
	<!-- 2. 发行 -->
	<!-- <altSnapshotDeploymentRepository></altSnapshotDeploymentRepository> -->
</properties>

局部配置 (pom.xml)：

<distributionManagement>
	<repository>
	    <id>my-repository</id>
	    <url>https://my.repository.url/repo</url>
	</repository>
</distributionManagement>

云效私服配置案例

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.2.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0 https://maven.apache.org/xsd/settings-1.2.0.xsd">

    <localRepository>E:\dev\maven\apache-maven-repo</localRepository>

    <mirrors>
        <mirror>
            <id>alimaven</id>
            <name>aliyun maven</name>
            <url>https://maven.aliyun.com/nexus/content/groups/public/</url>
            <mirrorOf>central</mirrorOf>
        </mirror>
    </mirrors>
    <servers>
        <!-- 1. 云效私服-快照仓库 -->
        <server>
            <id>xxx-snapshot-ssMnl0</id>
            <username>username</username>
            <password>password</password>
        </server>
        <!-- 2. 云效私服-发行仓库 -->
        <!-- 
          <server>
            <id></id>
            <username></username>
            <password></password>
          </server>
         -->
    </servers>

    <profiles>
        <profile>
            <id>default</id>
            <!-- 全局依赖推送配置 -->
            <properties>
                <!-- 1. 快照 -->
                <altSnapshotDeploymentRepository>
                    xxx-snapshot-ssMnl0::default::https://packages.aliyun.com/xxx/maven/xxx-snapshot-ssmnl0
                </altSnapshotDeploymentRepository>
                <!-- 2. 发行 -->
                <!-- <altReleaseDeploymentRepository></altReleaseDeploymentRepository> -->
            </properties>

            <!-- 云效私服仓库 -->
            <repositories>
                <repository>
                    <id>central</id>
                    <url>https://maven.aliyun.com/repository/central</url>
                </repository>
                <!-- 1. 云效私服-快照仓库 -->
                <repository>
                    <id>xxx-snapshot-ssMnl0</id>
                    <url>https://packages.aliyun.com/xxx/maven/xxx-snapshot-ssmnl0</url>
                    <releases>
                        <enabled>false</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </repository>
                <!-- 2. 云效私服-发行仓库 -->
                <!-- 
                  <repository>
                    <id></id>
                    <url></url>
                    <releases>
                      <enabled>true</enabled>
                    </releases>
                    <snapshots>
                      <enabled>false</enabled>
                    </snapshots>
                  </repository>
                -->
            </repositories>
            <!-- 插件仓库 -->
            <pluginRepositories>
                <pluginRepository>
                    <id>central</id>
                    <url>https://maven.aliyun.com/nexus/content/groups/public</url>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>false</enabled>
                    </snapshots>
                </pluginRepository>
                <pluginRepository>
                    <id>snapshots</id>
                    <url>https://maven.aliyun.com/nexus/content/groups/public</url>
                    <releases>
                        <enabled>false</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </pluginRepository>
                <pluginRepository>
                    <id>xxx-snapshot-ssMnl0</id>
                    <url>https://packages.aliyun.com/xxx/maven/xxx-snapshot-ssmnl0</url>
                    <releases>
                        <enabled>false</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </pluginRepository>
            </pluginRepositories>
        </profile>
    </profiles>

    <activeProfiles>
        <activeProfile>default</activeProfile>
    </activeProfiles>

    <!-- 
      <pluginGroups>
      </pluginGroups>
      
      <proxies>
      </proxies>
    -->
</settings>

坑

1. 记得配置 deploy 插件

Deployment failed: repository element was not specified in the POM inside distributionManagement element or in -DaltDeploymentRepository=id::layout::url parameter

<build>
    <plugins>
    	<!-- ... -->
        <!-- deploy -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-deploy-plugin</artifactId>
            <version>2.8.2</version>
        </plugin>
    </plugins>
</build>

2. 注意 settings.xml 命名的文件

[FATAL] Non-parseable settings E:\dev\maven\apache-maven-3.8.8\conf\settings.xml: end tag name </activeProfile> must match start tag name <activeProfiles> from line 32 (position: TEXT seen ...<activeProfiles>\r\n </activeProfile>... @33:19) @ E:\dev\maven\apache-maven-3.8.8\conf\settings.xml, line 33, column 19

当想配置全局推送配置，不想配置 distributionManagement 标签，并存在多个 settings.xml 文件时，即使 idea 中指定了使用的 settings-xxx.xml 文件，也会读取默认配置文件 settings.xml 中的 activeProfiles 相关标签。默认文件改个名：

maven-settings.xml

Maven的settings.xml文件结构之Servers，Mirror和Repository
诺浅的专栏
02-22 8982
缘起 在maven的配置文件settings.xml中，有Servers节点，Mirror节点和Repository节点，一个典型的settings.xml配置如下 <?xml version="1.0" encoding="UTF-8"?> <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" ...
_maven.repositories
01-16
SSM
自定义 Maven 的 repositories
weixin_33885253的博客
12-12 1015
有时，应用中需要一些比较新的依赖，而这些依赖并没有正式发布，还是处...
Maven 配的好，开发没烦恼！Maven全局配置文件解析
最新发布
本博客纯属个人网络笔记，如对阁下有用，甚喜；否则，关掉即可，不喜勿喷。专心写代码，不做键盘侠！
04-18 972
Maven 配得好，Java 开发没烦恼。整理 Maven 全局配置文件及仓库查找优先级顺序。
Maven学习笔记（三）——Maven仓库（Repositories）、基础命令（二）&自动构建项目
小灯光环
08-28 8445
关于Maven仓库的介绍、clean命令和install命令的介绍以及用于自动构建项目的Archetypes的介绍。
怎样在Maven中配置配置私服
m0_63144319的博客
06-30 1310
【代码】怎样在Maven中配置配置私服。
Maven的settings.xml文件结构之servers
热门推荐
成长的足迹
08-23 1万+
Maven中的构件（artifact）都是以库（repositories）的方式组织的。事实上，库就是符合Maven的库目录结构的构件的集合。 而库又分为本地库和远程库。 通常，本地库位于$user_host/.m2/repository目录下。 而远程库则往往根据需要有多个，默认的是Maven项目本身提供的Maven库，其对应的服务器url如下： https://repo.maven
maven 3.8.1版本私服配置版本
05-30
Maven 3.8.1版本的私服配置涉及到多个Maven配置文件部分，包括`settings.xml`中的服务器、镜像和profiles。正确配置后，Maven将自动从你的内部仓库获取依赖，同时也能方便地将项目发布到私服，便于团队内部共享和...
maven私服的配置使用方法
09-07
本文将详细介绍如何配置和使用Maven私服，包括下载、安装、配置、上传和下载构件。 **一、下载与安装Nexus** 1. **下载Nexus**： 可以访问官方网站[http://www.sonatype.org/nexus/archived/]...
maven私服(nexus)配置(setting,pom.xml)
04-24
2. **配置mirrors**：为了使Maven优先从Nexus下载依赖，需要在`mirrors`节点下添加镜像配置。 ```xml <mirrors> <id>my-nexus-mirror <url>http://localhost:8081/nexus/content/groups/public/</url> * ...
阿里云maven私服jar包上传和拉取教程
03-04
- 确保`settings.xml`中已配置私服仓库的镜像，以便Maven能够自动从私服拉取依赖。 2. **拉取依赖**： - 运行`mvn dependency:resolve`或`mvn install`命令，Maven会自动从私服仓库中拉取所需的jar包，并将其安装...
maven之repository和mirror
wuhelang90的博客
11-04 3188
1.pom.xml里的repositories元素，里面可以包含多少repository(至少默认包含了中央仓库，   该仓库总是在effective-pom里repositories元素的最后一个子元素),   每个repository都有一个id(此id非常重要)。 2.maven获取真正起作用的repository集合流程：      首先会获取pom.xml里的repository
maven私服配置
qq_44004255的博客
05-07 178
<?xml version="1.0" encoding="UTF-8"?> <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apac
Maven 私服配置
adozoo
05-16 1619
Maven 私服配置 上传 将项目发布到私服 ，修改 settings.xml 文件，配置连接私服的用户和密码 。此用户名和密码用于私服校验，因为私服需要知道上传的账号和密码是否和私服中的账号和密码一致。 releases 连接发布版本项目仓库 snapshots 连接测试版本项目仓库 <servers> <server> <id>releases</id> <username>admin&lt
Maven 私服配置
weixin_30559481的博客
09-18 89
1.下载nexus 　　nexus https://help.sonatype.com/display/NXRM3/Download 2.配置环境变量 　　export PATH=$PATH:/Users/wangchengcheng/Downloads/UtilitySoftWare/Work/nexus-3.5.2-01-mac/nexus-3.5.2-01/bin 3.开启服务 ...
Maven私服配置
qq_44942083的博客
09-02 332
下载安装nexus并启动 在maven的setting.xml文件里面继续进行私服的相关配置 下面是上传jar到私服的配置 在idea进行deploy操作，并在私服上可以查找到 再配置从私服上下载jar包的相关配置 从私服下载成功 ...
Maven项目中私服配置
weixin_39190162的博客
07-24 1899
Maven项目中私服配置 规范 开发阶段使用SNAPSHOT格式 测试和上线阶段使用正式格式 配置 项目公共pom文件引入，之后可以deploy项目的jar包到私服上其他人直接拉取使用 <distributionManagement> <repository> <id>maven-releases</id> <url>http://192.168.2.xxx:xxxx/repository/maven-r
Maven 项目中配置私服
通往精英的成长之路
11-13 9398
强烈推荐一个大神的人工智能的教程：http://www.captainbed.net/zhanghan 【前言】 之前公司的项目是大项目中分子模块，不同模块之间通过依赖，不同项目通过Http进行调用；也存在项目之间模块依赖；随着业务的不断扩张；项目维护成本越来越高； 于是我们在开新项目的时候果断采用了在国内非常成熟的微服务体系：大部分SpringCloud系列+A...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值