Nexus私有仓库配置与依赖上传下载的核心是服务启动、仓库创建、Maven客户端配置及行为控制。需启动服务(http://localhost:8081),创建maven-releases、maven-snapshots、maven-central(proxy)和maven-public(group)四类仓库;在pom.xml或settings.xml中配置仓库地址与镜像;在settings.xml中设置server凭证,并在pom.xml的distributionManagement中声明发布目标;上传执行mvn clean deploy,下载自动按本地→私服→中央仓库顺序进行。

配置 Nexus 私有仓库并实现依赖的上传与下载,核心在于四点:服务启动、仓库创建、Maven 客户端配置、上传/下载行为控制。整个过程不依赖外部网络权限,适合内网环境部署。
启动 Nexus 服务并创建基础仓库
Nexus 启动后默认访问地址是 http://localhost:8081,首次登录使用默认账号 admin,密码在日志或 sonatype-work/nexus3/admin.password 中生成。登录后需立即修改密码并关闭“Allow anonymous access”以保障安全。
接着创建两类关键仓库:
-
maven-releases(hosted):用于存放正式版构件(
version不含-SNAPSHOT),启用 Deployment Policy 为 “Disable redeploy” 防止覆盖 -
maven-snapshots(hosted):用于存放开发中版本(
version含-SNAPSHOT),允许重复部署 - (可选)maven-central(proxy):代理中央仓库,URL 填
https://repo.maven.apache.org/maven2/,勾选 “Download remote indexes” 加速搜索 - 再建一个 maven-public(group),把以上三个仓库加入其中,作为统一对外访问入口
在 Maven 中配置私有仓库地址
项目级配置写在 pom.xml 的 <repositories></repositories> 和 <pluginrepositories></pluginrepositories> 区域,让构建时能查到依赖:
<repositories>
<repository>
<id>nexus-public</id>
<url>http://localhost:8081/repository/maven-public/</url>
<releases><enabled>true</enabled></releases>
<snapshots><enabled>true</enabled></snapshots>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>nexus-public</id>
<url>http://localhost:8081/repository/maven-public/</url>
</pluginRepository>
</pluginRepositories>
该配置只影响当前项目。如需全局生效,可改写用户级 ~/.m2/settings.xml 中的 <mirrors></mirrors>,例如:
<mirrors>
<mirror>
<id>nexus-mirror</id>
<mirrorOf>central</mirrorOf>
<url>http://localhost:8081/repository/maven-public/</url>
</mirror>
</mirrors>
配置上传凭证与发布路径
上传依赖必须通过 mvn deploy,前提是 Maven 能验证身份。凭证不写在 pom.xml 中,而是存于 settings.xml 的 <servers></servers> 下:
<servers>
<server>
<id>nexus-releases</id>
<username>admin</username>
<password>your-new-password</password>
</server>
<server>
<id>nexus-snapshots</id>
<username>admin</username>
<password>your-new-password</password>
</server>
</servers>
注意:<id></id> 必须和 pom.xml 中 <distributionmanagement></distributionmanagement> 的 <repository></repository> 或 <snapshotrepository></snapshotrepository> 的 <id></id> 完全一致。
项目 pom.xml 还需声明发布目标:
<distributionManagement>
<repository>
<id>nexus-releases</id>
<url>http://localhost:8081/repository/maven-releases/</url>
</repository>
<snapshotRepository>
<id>nexus-snapshots</id>
<url>http://localhost:8081/repository/maven-snapshots/</url>
</snapshotRepository>
</distributionManagement>
Maven 会根据 <version>1.2.0</version> 自动走 releases 仓库,<version>1.2.0-SNAPSHOT</version> 则走 snapshots 仓库。
上传与下载的实际操作
上传只需在项目根目录执行:
-
mvn clean deploy—— 构建并自动上传 jar/aar/pom 等全套构件 - 若只想上传已打包好的文件(如第三方闭源 jar),可在 Nexus 管理界面进入对应 hosted 仓库 → Upload → 选择文件 + 填写 GAV 坐标(groupId/artifactId/version)
下载无需额外命令,只要上述仓库和镜像配置生效,执行 mvn compile 或 mvn clean install 时,Maven 就会按顺序查找:本地仓库 → 私服(maven-public)→ 若未命中且启用了 proxy,则继续向中央仓库拉取并缓存。
验证是否生效:查看本地 ~/.m2/repository/ 对应路径下是否有新依赖;或登录 Nexus,在对应仓库的 Browse 页面确认构件已存在。


















