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><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><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><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>
注意: 必须和 pom.xml 中 的 或 的 完全一致。
项目 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 会根据 自动走 releases 仓库, 则走 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 页面确认构件已存在。











