简介Nexus 3.70.1-02 是 Sonatype 官方推出的 Windows 64 位仓库管理平台安装包面向需要在内网搭建私有 Maven、npm、Docker 等镜像源的开发与运维人员用于统一代理、缓存和分发依赖解决外网拉取慢、依赖不可控等问题。压缩包共 758 个文件以 499 个 jar 核心库、82 个 dll 本地库、30 个 xml 配置、22 个 exe 可执行程序为主另含 properties、cfg、vmoptions 等运行参数文件及少量图片与说明文档整体约 284.34MB。内容预览可见 jmxremote.access、cacerts、karaf 系列 cfg 等说明包内保留了完整的 Karaf 容器配置、证书与安全策略解压后可直接启动服务并按需调整端口、存储与代理仓库。已有 593 人学习下载适合希望快速落地企业级镜像源、理解 Nexus 目录结构与配置体系的读者参考使用。1. Nexus 3.70.1-02 win64 压缩包到底装的是什么从解压到能跑的最小闭环很多人第一次拿到nexus-3.70.1-02-win64.zip这个文件时会下意识双击解压然后对着里面一堆目录发愣——bin、etc、lib、system没有setup.exe没有安装向导甚至连个像样的启动图标都没有。这不是打包失误而是 Nexus Repository Manager 在 Windows 上的标准交付形态它就是一个免安装的绿色压缩包解压即用但前提是你得知道怎么把它“点着”。这个标题背后真正要解决的问题是在 Windows 64 位环境下如何把 Nexus 3.70.1-02 这个 zip 包从一堆文件变成一个能访问的私有仓库服务。适合谁看适合需要在内网搭建 Maven、npm、Docker 私服的后端或运维同学也适合想在自己机器上跑一个本地仓库做依赖缓存、又不想被安装程序绑死的人。热搜里反复出现的 nexus 仓库 使用、nexus 桌面、win64 这些词指向的正是同一件事解压之后怎么让它跑起来、怎么配、怎么少踩坑。下面按“先立住原理、再动手复现”的顺序拆开讲。2. 解压与目录结构先看清 zip 里有什么再动手2.1 为什么 Nexus 用 zip 而不是 exe 安装包Nexus 3.x 在 Windows 上一直保留 zip 分发核心原因是它本质是一个 Java 应用外层套了一个启动器。zip 包里已经包含了运行所需的 Jetty 容器、Karaf 内核和默认配置解压后目录结构是固定的不写注册表、不往系统目录塞东西。这意味着你可以同时放多个版本在不同盘符互不干扰删掉就是卸载。对于需要在内网离线环境部署的场景zip 比 exe 更可控——你只需要把整个目录拷过去改几个配置就能用。常见做法是把它解压到一个路径里没有空格、没有中文的目录比如D:\nexus或C:\tools\nexus。路径带空格或中文在后续配置nexus.vmoptions和写服务脚本时容易出玄学问题这是血泪经验。2.2 解压后必须认识的四个目录解压nexus-3.70.1-02-win64.zip后你会看到类似这样的结构nexus-3.70.1-02/ ├── bin/ │ ├── nexus.exe │ ├── nexus.vmoptions │ └── nexus.bat ├── etc/ │ └── nexus-default.properties ├── lib/ ├── system/ └── ...四个关键位置bin/nexus.exeWindows 下的启动器负责读取 vmoptions 并拉起 Java 进程。bin/nexus.vmoptionsJVM 参数文件内存、端口、数据目录都在这里改。etc/nexus-default.properties应用层配置默认端口 8081、上下文路径/在这里。../sonatype-work/这个目录不在 zip 里第一次启动后会在上级目录自动生成所有仓库数据、Blob、配置都存这里。注意sonatype-work默认生成在 nexus 安装目录的上一级。如果你把 nexus 解压到D:\nexus\nexus-3.70.1-02数据会落在D:\nexus\sonatype-work。备份时别只备份安装目录数据目录才是命根子。2.3 解压命令与路径检查如果你习惯用命令行Windows 10/11 自带tar可以解 zip也可以用 7-Zip。下面用 PowerShell 演示# 创建目标目录路径不要带空格和中文 New-Item -ItemType Directory -Path D:\nexus -Force # 使用 tar 解压Windows 10 1803 自带 tar -xf .\nexus-3.70.1-02-win64.zip -C D:\nexus # 确认解压结果 Get-ChildItem D:\nexus逻辑说明tar -xf在 Windows 上能识别 zip 格式解压后会在D:\nexus下生成nexus-3.70.1-02目录。参数-C指定解压目标避免解到当前目录造成混乱。如果你用 7-Zip右键“提取到指定文件夹”效果一样。解压完先别急着启动检查两件事一是bin\nexus.exe是否存在二是当前系统是否已装 JDK。Nexus 3.70 需要 Java 8 或 Java 11推荐用 JDK 11。在命令行执行java -version如果提示找不到命令先去装一个 JDK 11 并配好JAVA_HOME。3. 启动与端口配置让 8081 真正监听起来3.1 前台启动看日志别一上来就装服务第一次启动强烈建议用前台方式这样报错能直接看到。进入bin目录执行cd D:\nexus\nexus-3.70.1-02\bin .\nexus.exe /run逻辑说明/run参数让 Nexus 在当前控制台前台运行日志直接打到终端。启动过程会先解压 Karaf 内核再初始化数据库第一次通常需要 30 秒到 2 分钟。看到Started Sonatype Nexus字样才算成功。参数说明/run和/start的区别在于/start会后台拉起进程然后返回出错时你只能去sonatype-work/nexus3/log/nexus.log里翻。第一次用/run确认没问题后再考虑后台或装服务。启动成功后浏览器访问http://localhost:8081应该能看到 Nexus 的欢迎页。默认管理员用户名是admin密码不在文档里而是存在数据目录的一个文件中Get-Content D:\nexus\sonatype-work\nexus3\admin.password这个文件在首次登录后会被删除所以拿到密码后先复制出来登录后系统会强制你改密码。3.2 改端口和 JVM 内存的正确位置默认 8081 端口如果被占用或者你想换端口改etc\nexus-default.properties# 默认配置改端口只动 application-port application-port8081 application-host0.0.0.0 nexus-context-path/逻辑说明application-port控制监听端口application-host0.0.0.0表示允许局域网访问nexus-context-path是访问路径前缀。改完必须重启 Nexus 才生效。JVM 内存则在bin\nexus.vmoptions里调-Xms1200m -Xmx1200m -XX:MaxDirectMemorySize2g -XX:UnlockDiagnosticVMOptions参数说明-Xms和-Xmx是堆内存初始值和最大值小团队用 1200m 够仓库大了或并发高就往上加但别超过物理内存的 70%。MaxDirectMemorySize影响文件上传下载的零拷贝性能Docker 镜像多的话建议给到 2g 以上。改完同样要重启。3.3 装成 Windows 服务开机自启的稳妥做法确认前台能跑通后用nexus.exe自带的命令装服务# 以管理员身份打开 PowerShell进入 bin 目录 .\nexus.exe /install nexus-repo # 启动服务 Start-Service nexus-repo # 查看状态 Get-Service nexus-repo逻辑说明/install后面跟的是服务名可以自定义。Nexus 会把自己注册成 Windows 服务并读取同目录的nexus.vmoptions。/uninstall是卸载服务但不会删数据。参数说明服务方式启动后日志在sonatype-work/nexus3/log/nexus.log排查问题看这个文件。如果服务启动失败先检查JAVA_HOME是否配在系统环境变量里服务账户是否有权限访问 nexus 目录和数据目录。4. 仓库类型与代理配置把私服真正用起来4.1 Maven 私服的三类仓库怎么选Nexus 里最常用的仓库类型有三种理解它们的区别比会点按钮重要类型作用典型场景hosted本地存储自己发布构件公司内部 jar 包发布proxy代理远程仓库缓存下载代理 Maven Central加速构建group聚合多个仓库统一入口对外只暴露一个 URL常见做法是建一个maven-central的 proxy 指向https://repo1.maven.org/maven2/再建一个maven-releases的 hosted 存内部发布最后建一个maven-public的 group 把前两个加进去。开发人员只需要在settings.xml里配 group 的地址。4.2 创建 proxy 仓库并验证缓存生效在 Nexus 界面里操作路径是齿轮图标 → Repository → Repositories → Create repository → maven2 (proxy)。关键参数Namemaven-centralRemote storagehttps://repo1.maven.org/maven2/Blob store默认 defaultHTTP 端口不填走主端口创建后在浏览器访问http://localhost:8081/repository/maven-central/org/slf4j/slf4j-api/1.7.36/slf4j-api-1.7.36.pom如果能看到 pom 内容说明代理和缓存都通了。第一次访问会稍慢因为 Nexus 要去远程拉第二次就快了。注意proxy 仓库的缓存有 TTL 设置默认对 release 版本永久缓存snapshot 按策略过期。如果远程仓库更新了某个版本但 Nexus 还返回旧缓存去仓库配置里把Not Found Cache TTL和Metadata Max Age调小或者手动执行 Invalidate Cache。4.3 客户端 settings.xml 的最小配置开发机上的~/.m2/settings.xml只需要加一段 mirrormirrors mirror idnexus-local/id mirrorOf*/mirrorOf urlhttp://192.168.1.100:8081/repository/maven-public//url /mirror /mirrors逻辑说明mirrorOf设为*表示所有仓库请求都走 Nexus这样 Maven Central 的依赖也会被 Nexus 代理缓存。url换成你 Nexus 所在机器的 IP 和 group 仓库路径。参数说明如果只想代理部分仓库把*改成central或*,!internal。生产环境建议配mirrorOf时排除内部发布仓库避免发布请求被 mirror 拦截。5. 避坑与排查zip 部署最常见的五个翻车点5.1 启动报 “JAVA_HOME is not set” 但明明装了 Java现象命令行java -version正常但nexus.exe /run提示找不到 Java。原因Nexus 的启动器读的是系统环境变量JAVA_HOME而不是 PATH 里的 java。如果你只在 PATH 里配了%JAVA_HOME%\bin但没设JAVA_HOME本身就会报这个错。解决在系统环境变量里新建JAVA_HOME值指向 JDK 根目录比如C:\Program Files\Java\jdk-11。注意路径不要带\bin。设完重开命令行再试。5.2 8081 端口被占用启动到一半卡住现象前台启动日志停在 “Starting Jetty” 不动或者直接报Address already in use。原因8081 被其他进程占了常见的是之前没关干净的 Nexus 进程或者某些监控软件。解决netstat -ano | findstr :8081找到 PIDtaskkill /PID pid /F干掉。如果不想杀就改nexus-default.properties里的application-port换一个端口。5.3 数据目录权限不足导致启动失败现象服务方式启动后立刻停止日志里出现AccessDeniedException或Cannot create directory。原因Windows 服务默认以Local System账户运行如果 nexus 目录或sonatype-work目录在用户目录下System 账户可能没权限。解决把 nexus 解压到D:\或C:\tools这类公共路径右键目录 → 属性 → 安全 → 编辑给SYSTEM账户完全控制权限。或者装服务时指定运行账户。5.4 解压后直接双击 nexus.exe 没反应现象双击nexus.exe窗口一闪而过什么都没发生。原因nexus.exe不带参数时默认行为不是前台运行而是尝试以服务方式交互没有服务注册就会退出。解决用命令行加/run参数启动或者先/install装服务再Start-Service。别指望双击。5.5 浏览器访问 8081 显示 404 或空白现象Nexus 启动日志显示成功但浏览器打开http://localhost:8081是 404 或空白页。原因nexus-context-path被改过或者访问时多加了路径。默认 context path 是/如果你改成了/nexus就必须访问http://localhost:8081/nexus。解决检查etc\nexus-default.properties里的nexus-context-path改回/或按实际路径访问。改完重启。6. 进阶技巧用脚本做健康检查与数据备份6.1 写一个 Windows 下的 Nexus 健康检查脚本Nexus 跑起来之后你需要一个不依赖界面的方式确认它还活着。下面这个 PowerShell 脚本检查 HTTP 状态和关键端口# nexus-health.ps1 $nexusUrl http://localhost:8081/service/rest/v1/status $port 8081 # 检查端口监听 $conn Test-NetConnection -ComputerName localhost -Port $port -WarningAction SilentlyContinue if (-not $conn.TcpTestSucceeded) { Write-Output FAIL: port $port not listening exit 1 } # 检查 REST 状态接口 try { $resp Invoke-WebRequest -Uri $nexusUrl -UseBasicParsing -TimeoutSec 10 if ($resp.StatusCode -eq 200) { Write-Output OK: Nexus is healthy } else { Write-Output WARN: status code $($resp.StatusCode) } } catch { Write-Output FAIL: $($_.Exception.Message) exit 1 }逻辑说明先Test-NetConnection确认端口在监听再请求/service/rest/v1/status接口。这个接口不需要认证返回 200 就说明应用层正常。参数-TimeoutSec 10避免脚本卡死-UseBasicParsing在旧版 PowerShell 里更稳。把这个脚本挂到任务计划程序里每 5 分钟跑一次失败就发告警比等用户报障强。6.2 数据备份别只备份安装目录Nexus 的所有仓库数据、Blob、配置都在sonatype-work目录。备份策略分两种冷备份停掉 Nexus 服务直接拷贝整个sonatype-work目录。简单可靠但需要停机窗口。热备份用 Nexus 自带的backup任务在界面里创建 Admin - Backup 类型的任务导出到指定目录。不停机但恢复时步骤多一些。我一般会写一个批处理每周日凌晨停服务、robocopy 同步数据目录到备份盘、再启动服务echo off net stop nexus-repo robocopy D:\nexus\sonatype-work E:\backup\nexus\sonatype-work /MIR /R:2 /W:5 /LOG:E:\backup\nexus-backup.log net start nexus-repo参数说明/MIR镜像同步会删除目标端多余文件保持两边一致/R:2失败重试 2 次/W:5重试间隔 5 秒/LOG追加日志。注意/MIR有删除风险目标路径别写错。6.3 一个我踩过的坑zip 包升级时数据目录别动从 3.70.1-02 升级到更高版本时正确做法是停服务 → 解压新版本到新目录 → 把旧版本的sonatype-work目录路径配到新版本的nexus.vmoptions里通过-Dkaraf.data参数或者直接把旧数据目录软链过去。千万别在新版本目录里重新初始化一个空数据目录否则你会得到一个“全新”的 Nexus所有仓库和用户都没了。这个后悔药不好吃升级前先备份sonatype-work这是习惯不是建议。希望帮到你。本文还有配套的精品资源点击获取