在Windows上用Nexus搭建私有Maven仓库需先安装匹配JDK(3.15.2配JDK 8u202+,3.45.0配JDK 11.0.16+),配置JAVA_HOME和PATH;解压至全英文无空格路径,确保nexus-3.x.x与sonatype-work并列;注册服务后修改端口并启动,访问初始化页面获取密码;创建proxy、hosted、group三类仓库;最后在settings.xml配置mirror指向内网IP的maven-public仓库。

在Windows系统上用Nexus搭建私有Maven仓库,就是给团队建一个内网依赖中转站——所有开发机不再各自连外网拉jar包,而是统一从这台Windows机器上的Nexus取依赖,既提速又稳,还能发布自家SDK和二方库。
环境准备与JDK适配
下载并安装 64位 JDK 8u202 或更高小版本(如 8u333),不要用 JDK 11/17 直接跑 Nexus 3.15.2,否则启动时会报 java.lang.NoClassDefFoundError 类加载失败;Nexus 3.45.0 则推荐 JDK 11,但必须是 11.0.16+,低于此版本可能触发 Jetty 初始化异常。
安装完后,在命令行执行 java -version 确认输出含 x64 和 1.8.0_ 或 11.0. 字样;若显示 x86 或版本号错乱,说明装错了位数或环境变量没生效。
把 JDK 安装路径下的 bin 目录加进系统 PATH,再新建系统变量 JAVA_HOME 指向 JDK 根目录(如 C:\Program Files\Java\jdk1.8.0_333)——这一步漏掉,后续 nexus.exe 启动会直接闪退。
解压与目录规划
将下载的 nexus-3.15.2-win64.rar 或 nexus-3.45.0-01-win64.zip 解压到一个**全英文、无空格、非系统盘根目录**的路径下,例如 D:\nexus。
解压后必须看到两个平行目录:nexus-3.x.x-xx(程序目录)和 sonatype-work(数据目录);如果只有一层嵌套或解压出一堆零散文件,说明解压方式错误(RAR包需用 WinRAR 完整解压,不能双击打开后拖文件出来)。
进入 nexus-3.x.x-xx\bin 目录,右键以管理员身份运行 nexus.exe /install 注册 Windows 服务——这步成功后,可在「服务」管理器里看到 nexus 服务,状态为“已安装”但未启动。
首次启动与端口配置
打开 nexus-3.x.x-xx\etc\nexus-default.properties,找到 application-port=8081 这一行;如果本机已有 Tomcat 或其他服务占用了 8081,直接改成 application-port=8091 并保存。
仍在此目录下,双击运行 nexus.exe /run 启动控制台模式(不注册服务,纯调试用);等待约 90 秒,命令行出现 Started Sonatype Nexus OSS 且末尾带版本号,表示服务已就绪。
打开浏览器访问 http://localhost:8081(或你改的端口),首次访问会跳转到初始化密码页面;密码文件位置在 sonatype-work\nexus3\admin.password,用记事本打开复制粘贴即可登录,默认账号是 admin。
创建三类核心仓库
登录后台后,点击左侧菜单 Repository → Repositories,右上角点 Create repository。
方法一:创建代理仓库(用于缓存中央仓库)
选择 maven2-proxy → 填写 Name 如 maven-central → Remote storage URL 填 https://repo.maven.apache.org/maven2/ → Blob store 选默认的 default → Online 打钩 → Create repository。
方法二:创建宿主仓库(用于发布自己团队的 release/snapshot 包)
选 maven2-hosted → Name 填 my-releases → Version policy 选 Release → Deployment policy 选 Allow redeploy(方便测试)→ Blob store 选 default → Create repository。
方法三:创建仓库组(对外统一入口)
选 maven2-group → Name 填 maven-public → Members 里勾选刚建的 maven-central 和 my-releases → Order 保持默认顺序(release 优先于 proxy)→ Create repository。
注意:宿主仓库的 Deployment policy 若选 Disable redeploy,则同名同版本 jar 上传会直接 400 报错,无法覆盖——开发调试阶段务必设为 Allow redeploy。
Maven客户端对接
打开本地 Maven 安装目录下的 conf\settings.xml,在 标签下插入以下配置:
其中 192.168.1.100 换成你 Windows 服务器的真实局域网 IP,不是 localhost 或 127.0.0.1;改完保存,重启 IDE 或刷新 Maven 项目。
在任意 Maven 项目中执行 mvn clean compile,观察日志是否出现 Downloading from nexus-public 字样;若仍显示 Downloading from central,说明 settings.xml 路径不对,或 IDE 未读取全局配置(IntelliJ 需在 Settings → Build → Maven → User settings file 中手动指定路径)。











