简介：Nexus Repository Manager 3.50.0-01 是面向 Windows 64 位系统的仓库管理软件，主要服务于需要搭建 Maven 私服、统一管理构建产物的软件开发团队与运维人员。它支持 Maven、npm、Docker 等多种构建工具，可集中存储与发布软件包，并通过细粒度权限控制保障仓库内容的完整性与安全性，同时优化了存储与检索速度，提升构建部署效率。压缩包共 690 个文件，约 240.15MB，以 419 个 jar 核心库、82 个 dll 动态链接库、22 个 exe 可执行程序为主，辅以 xml、properties、cfg 等配置文件和 png、gif 等界面资源，结构完整，开箱即可部署。目前已有 494 人学习下载。借助该安装包，读者可快速搭建本地 Maven 私服，掌握仓库创建、代理配置、权限分配与依赖缓存等关键环节，为团队内部构件共享与持续集成提供稳定支撑。
1. 从一台被 Nexus 拖垮的构建机说起
上周帮一个朋友收拾他团队里那台构建服务器，Windows Server 2019，8 核 16G，跑 Jenkins 拉代码、跑 Maven 打包，本来挺稳。结果他们为了图省事，在同一个目录里先后解压过两个不同版本的 Nexus Repository，服务注册表里还留着旧版本的残留项，最后表现是：nexus.exe /run能起来，但 Web 控制台 8081 端口时通时不通，Maven 拉依赖间歇性 502。折腾了一下午，最后把目录清空、服务删干净、重新解压nexus-3.50.0-01-win64.zip才恢复正常。
这件事让我意识到，Nexus 在 Windows 上的安装，坑不在“装不上”，而在“装完之后环境不干净”。nexus-3.50.0-01-win64.zip这个包本身是免安装的绿色压缩包，解压即用，但它的运行依赖 JVM、依赖目录权限、依赖sonatype-work数据目录的独立位置。很多人把它当成一个普通 exe 双击就完事，结果后面配置私服、配代理仓库、配 blob 存储时处处别扭。
这篇笔记面向的是需要在 Windows 上搭一套本地或内网 Maven / npm / Docker 私服的开发者，尤其是那些第一次接触 Nexus、或者被旧版本残留坑过的人。我会把版本选择、解压路径、JVM 参数、服务注册、仓库配置、验证跑通这一整条链路拆开写，每一步都落到能直接抄的命令和配置上。装之前先把环境列清楚，比装完再救火省事得多。
2. 装前环境核对：JDK、目录与端口三件事
2.1 JDK 版本怎么选，别用系统自带那个
Nexus 3.50.0 对 JDK 的要求是 JDK 8 或 JDK 11，官方推荐 JDK 8。这里有个反直觉的点：很多人机器上已经装了 JDK 17 甚至 JDK 21，觉得版本越高越好，直接拿高版本 JDK 去跑 Nexus，结果启动时报Unsupported class file major version或者java.lang.NoClassDefFoundError。原因是 Nexus 3.50 内部依赖的一些库还没适配高版本 JDK 的模块化限制。
我一般会单独给 Nexus 准备一个 JDK 8 的运行时，不和系统里其他 JDK 混用。Windows 上可以用压缩版的 JDK，解压到D:\tools\jdk8，然后在 Nexus 的启动脚本里显式指定JAVA_HOME，而不是依赖系统环境变量。这样做的另一个好处是：以后系统 JDK 升级，不会波及 Nexus。
验证 JDK 是否可用，用这条命令：
D:\tools\jdk8\bin\java -version输出里应该看到1.8.0_xxx字样。如果输出的是 17 或 21，说明你调用的还是系统 PATH 里的 java，需要检查路径写对没有。参数说明：-version只打印版本信息，不会真正启动 JVM 进程，适合快速核对。
2.2 解压路径与数据目录分离
nexus-3.50.0-01-win64.zip解压后会有两个顶层目录：nexus-3.50.0-01是程序目录，sonatype-work是数据目录。默认情况下，sonatype-work会生成在程序目录的上一级。这个默认行为在测试环境没问题，但在生产或长期使用的机器上，我强烈建议把数据目录单独放到一个盘，比如D:\nexus-data。
原因很直接：程序目录以后升级版本是要整个替换的，如果数据目录混在里面，升级时容易误删。分离之后，升级只需要解压新版本、改一下nexus.vmoptions里的数据路径，旧数据原封不动。
具体做法是在nexus-3.50.0-01\bin\nexus.vmoptions文件里加一行：
-Dkaraf.data=D:\nexus-data参数说明：karaf.data是 Nexus 底层 Karaf 容器的数据根目录，所有仓库内容、blob、配置、日志都从这里派生。改完这一行，Nexus 启动时会自动在D:\nexus-data下创建完整目录结构。注意路径不要带中文和空格，Windows 上带空格的路径在服务注册时经常出玄学问题。
2.3 端口与防火墙预检
Nexus 默认监听 8081 端口。装之前先确认这个端口没被占用：
netstat -ano | findstr :8081如果输出里有LISTENING，说明端口被占了，要么停掉占用进程，要么改 Nexus 端口。改端口在nexus-3.50.0-01\etc\nexus-default.properties里：
application-port=8081 application-host=0.0.0.0参数说明：application-port是 Web 控制台和仓库服务的统一入口端口；application-host设为0.0.0.0表示允许内网其他机器访问，如果只想本机访问就改成127.0.0.1。改完记得在 Windows 防火墙里放行对应端口，否则内网同事连不上，会以为是 Nexus 没起来。
提示：端口预检这一步很多人跳过，结果装完发现 8081 被某个监控 agent 占了，排查半天。花一分钟 netstat 一下，比事后翻日志快。
3. 解压与首次启动：从命令行到 Web 控制台
3.1 解压与目录结构确认
把nexus-3.50.0-01-win64.zip解压到D:\nexus，解压后确认目录结构：
D:\nexus\nexus-3.50.0-01\bin\nexus.exe D:\nexus\nexus-3.50.0-01\etc\nexus-default.properties D:\nexus\nexus-3.50.0-01\bin\nexus.vmoptions这三个文件是后面配置的核心。nexus.exe是 Windows 下的启动器，它负责读取nexus.vmoptions里的 JVM 参数，再拉起 Java 进程。nexus-default.properties管端口和上下文路径。nexus.vmoptions管内存、数据目录、临时目录。
我一般会先不改任何配置，直接跑一次nexus.exe /run，看看默认状态下能不能起来。这一步的目的是确认 JDK 能被正确找到、端口没冲突、目录权限没问题。如果默认都起不来，先别急着改配置，先把基础环境修好。
3.2 用 /run 前台启动做冒烟测试
进入D:\nexus\nexus-3.50.0-01\bin，执行：
nexus.exe /run参数说明：/run是前台运行模式，日志直接打在控制台，方便看启动过程。启动成功会看到类似Started Sonatype Nexus OSS 3.50.0-01的输出。这个过程第一次会比较慢，因为要初始化数据目录、建默认仓库、生成安全配置，通常 1 到 3 分钟。
如果卡在某个阶段不动，重点看日志里有没有java.io.IOException或AccessDeniedException。前者多半是端口或路径问题，后者是目录权限问题。Windows 上如果解压到了C:\Program Files下面，普通用户没有写权限，Nexus 建不了数据目录就会报 AccessDenied。所以解压路径选D:\这种非系统盘、非受保护目录，能省掉一大类权限坑。
启动完成后，浏览器打开http://localhost:8081，应该能看到 Nexus 的登录页。默认管理员用户名是admin，密码不在文档里，而是存在数据目录的一个文件里：
D:\nexus-data\admin.password用记事本打开这个文件，复制里面的随机密码登录。登录后会强制要求修改密码，改成一个自己记得住的。这个初始密码文件在修改密码后会被删除，所以第一次登录后如果没记下来，就只能走密码重置流程了。
3.3 注册为 Windows 服务
前台跑通之后，下一步是注册成 Windows 服务，让它开机自启、后台运行。命令是：
nexus.exe /install NexusRepo参数说明：/install是注册服务，后面的NexusRepo是服务名，可以自定义。注册完成后用nexus.exe /start NexusRepo启动，nexus.exe /stop NexusRepo停止。如果想卸载服务，用nexus.exe /uninstall NexusRepo。
这里有个血泪经验：注册服务之前，一定要确认nexus.vmoptions里的JAVA_HOME或 java 路径是写死的绝对路径，不要依赖系统环境变量。因为 Windows 服务是以 SYSTEM 账户运行的，它读不到你当前用户的环境变量。如果服务启动时报Unable to find java，八成就是这个原因。解决办法是在nexus.vmoptions里加一行：
-Djava.home=D:\tools\jdk8或者直接在服务注册时指定 java 路径。我一般用前者，改配置文件比改服务参数直观。
注意：服务注册后如果修改了
nexus.vmoptions，需要先/stop再/start才生效，直接重启服务不会重新读取配置。这个细节很多人踩过，改了内存参数发现没生效，以为改错了文件。
4. 仓库配置：代理、宿主与仓库组怎么摆
4.1 先理解三种仓库类型的分工
Nexus 里的仓库分三类：代理仓库（proxy）、宿主仓库（hosted）、仓库组（group）。代理仓库用来代理远程的中央仓库，比如 Maven Central，第一次拉取时缓存到本地，后续就走本地缓存。宿主仓库用来存放自己团队发布的构件，比如内部 jar 包、npm 包。仓库组则是把多个代理仓库和宿主仓库聚合成一个地址，客户端只需要配一个 URL 就能同时访问多个仓库。
我一般会建三个 Maven 仓库：一个maven-central代理仓库指向 Maven Central，一个maven-releases宿主仓库放正式版本，一个maven-snapshots宿主仓库放快照版本，然后建一个maven-public仓库组把这三个聚合起来。客户端只需要配maven-public的地址。
配置入口在 Web 控制台的Settings -> Repositories -> Create repository。代理仓库的 Remote storage 填https://repo1.maven.org/maven2/，宿主仓库的 Version policy 分别选 Release 和 Snapshot。仓库组里把三个仓库按顺序加进去，代理仓库放前面，宿主仓库放后面。
4.2 客户端 settings.xml 怎么配
服务端配好之后，客户端 Maven 的settings.xml里加一个 mirror：
<mirror> <id>nexus</id> <mirrorOf>*</mirrorOf> <url>http://192.168.1.100:8081/repository/maven-public/</url> </mirror>参数说明：mirrorOf设为*表示所有仓库请求都走 Nexus，包括插件仓库。url里的 IP 换成 Nexus 所在机器的内网地址，maven-public是仓库组的名称。如果只想代理部分仓库，可以把*改成central或*,!my-repo这种排除写法。
配完之后，删掉本地.m2/repository里某个依赖的目录，重新执行mvn clean package，观察控制台是否从 Nexus 地址下载。如果看到Downloading from nexus: http://192.168.1.100:8081/...，说明代理生效了。
4.3 npm 与 Docker 仓库的额外注意点
Nexus 3.50 也支持 npm 和 Docker 仓库。npm 代理仓库的 Remote storage 填https://registry.npmjs.org/，客户端用npm config set registry http://192.168.1.100:8081/repository/npm-public/切换。Docker 仓库稍微特殊，需要额外配一个 HTTP Connector 端口，比如 8082，然后在 Docker 客户端配置insecure-registries。
这里有个容易忽略的点：Docker 仓库如果配了 HTTPS 但证书不对，客户端会直接拒绝连接，报x509: certificate signed by unknown authority。内网环境如果不想折腾证书，就用 HTTP 端口加insecure-registries，简单直接。配置位置在Settings -> Repositories -> Docker -> HTTP里勾选端口并启用。
提示：仓库配置改完后，建议用
mvn -X开 debug 日志跑一次构建，能看到完整的仓库请求链路。比在 Web 界面里猜哪个仓库生效了要靠谱。
5. 避坑与排查：五个真实踩过的坑
5.1 服务启动报 1067：进程意外终止
现象：nexus.exe /start NexusRepo后服务状态一闪就变成“已停止”，事件查看器里报错误 1067。
原因：nexus.vmoptions里的-Xms或-Xmx设得太大，超过了机器可用内存，或者karaf.data指向的目录不存在且没有创建权限。
解决：先把-Xmx降到 1024m 试启动，确认能起来再逐步往上加。数据目录如果不存在，手动建好并给 SYSTEM 账户完全控制权限。我一般用icacls D:\nexus-data /grant SYSTEM:(OI)(CI)F这条命令赋权。
5.2 控制台能打开但拉依赖 502
现象：浏览器访问 8081 正常，但 Maven 构建时拉依赖报 502 Bad Gateway。
原因：Nexus 的代理仓库连不上远程中央仓库，通常是机器没有外网访问权限，或者 DNS 解析失败。
解决：在 Nexus 所在机器上用curl https://repo1.maven.org/maven2/测试连通性。如果不通，检查代理设置或 DNS。如果通但 Nexus 还是 502，去Settings -> Repositories里点开代理仓库，用Test connection按钮测一下，看具体报错。
5.3 升级后旧数据读不出来
现象：把程序目录换成新版本，启动后仓库列表空了，或者报 blob 存储找不到。
原因：新版本的nexus.vmoptions里没有保留karaf.data的路径配置，Nexus 在默认位置新建了一个空的数据目录。
解决：升级前先备份nexus.vmoptions，升级后把数据路径那行加回去。如果已经启动了空目录，停掉服务，删掉新建的空sonatype-work，把路径改回旧数据目录再启动。
5.4 管理员密码文件找不到
现象：第一次启动后，在数据目录里找不到admin.password文件。
原因：Nexus 3.50 在某些 Windows 环境下会把密码文件生成在etc目录而不是数据目录，或者因为权限问题写入失败。
解决：用dir /s admin.password在整个 Nexus 相关目录下搜一遍。如果确实没有，停掉服务，删掉数据目录下的db文件夹，重启服务让它重新初始化。注意这会清空已有配置，只适合全新安装的场景。
5.5 磁盘写满导致服务假死
现象：Nexus 进程还在，但 Web 控制台打不开，日志里刷No space left on device。
原因：blob 存储默认放在数据目录，长期使用后缓存了大量构件，把磁盘写满。
解决：定期清理不需要的缓存，或者在Settings -> Blob Stores里把 blob 存储指向另一个大容量盘。我一般会在nexus.vmoptions里把java.io.tmpdir也指到大盘，避免临时文件把系统盘撑爆。
6. 装完怎么验证：三条命令确认整套环境跑通
装完不算完，能验证跑通才算。我一般用三条命令做最终确认，分别覆盖服务状态、仓库代理、构件发布三个环节。
第一条，确认服务状态和端口监听：
sc query NexusRepo netstat -ano | findstr :8081sc query的输出里STATE应该是RUNNING。netstat应该看到 8081 处于LISTENING。两条都对，说明服务层面没问题。
第二条，确认代理仓库能正常缓存远程构件：
curl -I http://192.168.1.100:8081/repository/maven-public/org/springframework/spring-core/5.3.20/spring-core-5.3.20.pom返回HTTP/1.1 200 OK说明代理链路通。如果返回 404，说明仓库组里没包含代理仓库，或者路径写错了。如果返回 502，回到 5.2 排查外网连通性。
第三条，确认宿主仓库能发布构件。在本地 Maven 项目的pom.xml里加 distributionManagement：
<distributionManagement> <repository> <id>nexus-releases</id> <url>http://192.168.1.100:8081/repository/maven-releases/</url> </repository> </distributionManagement>然后在settings.xml里配好对应的用户名密码，执行mvn deploy。看到BUILD SUCCESS并且 Nexus 的Browse里能搜到刚发布的构件，说明发布链路也通了。
这三条走完，整套 Nexus 私服就算真正跑通了。从那以后我每次装完 Nexus，都会强制走一遍这三条验证，不管前面启动看起来多顺利。因为启动成功和仓库可用是两回事，中间隔着代理配置、权限、网络好几层。希望帮到你。
本文还有配套的精品资源，点击获取
