简介Nexus 3.45.0-01 win64 是一份适用于 Windows 64 位系统的 Maven 私服资源包由 Sonatype 推出面向 Java 开发工程师、构建运维与架构设计人员主要解决内部组件统一存储、依赖下载加速、公共仓库访问不稳定等问题。压缩包共 690 个文件总体积约 240.62MB其中包含 420 个 jar 包、82 个 dll 动态库、29 个 xml 配置以及大量 properties、cfg、exe 等程序文件构成完整可运行的 Nexus 仓库管理器。解压后可得到 nexus-3.45.0-01 程序目录与 sonatype-work 数据目录便于对照理解程序文件、运行配置、存储索引等模块适合快速搭建本地私服并配置代理仓库、宿主仓库、权限控制等功能。已有 417 人查看学习可配合 Windows 环境完成安装、启动、Web 访问与仓库管理全流程尤其适合刚接触 Nexus 的开发者作为入门部署模板。该包直接提供可落地的目录结构与启动脚本可帮助读者节省从官网收集和匹配文件的时间快速掌握 Maven 私服的日常维护与排错要点。1. 装上 nexus-3.45.0-01-win64 能解决什么Maven 私服的第一个 20 分钟第一次在公司内网跑 Maven 构建卡在中央仓库下载依赖上是很常见的。某天下午我拿到 nexus-3.45.0-01-win64 这个压缩包解压、配代理仓库、把 settings.xml 指过去整个过程花了不到二十分钟然后整个团队构建时依赖下载直接从“碰运气”变成“秒开”。这篇笔记就是围绕这个 Windows 版本写的安装步骤、仓库类型怎么选、Maven 怎么接、以及我在 3.45.0-01 上踩过的几个具体坑。适合刚接手私服搭建、或者想把本地 Maven 仓库升级成团队共享仓库的开发者。2. 安装与初始化从压缩包到后台服务的完整路径2.1 为什么选 Nexus 3 而不是其他私服方案刚接触 Maven 私服时很多人会在 Nexus、Artifactory、Archiva 之间犹豫。我在真实项目里对比过Artifactory 功能更强但商业版收费、配置项多到让人发懵Archiva 轻量但界面老、社区活跃度一般遇到问题查不到答案会很痛苦。Nexus 3 是中间态最舒服的那个——开源版免费、支持 Maven 中央仓库代理、Docker 仓库、npm 仓库等一整套格式而且配置逻辑非常直白。3.45.0-01 是 3.x 里比较稳的一个 Windows 发布版自带 JRE解压即用省掉了到处找 JDK 的功夫。2.2 安装前置检查与环境要求先说结论nexus-3.45.0-01-win64 这个包不需要你提前安装 JDK因为它打包了运行时环境。但有两件事必须提前确认。第一磁盘空间建议给 sonatype-work 目录所在的盘留出至少 20GB私服跑起来后代理缓存和托管构件会快速膨胀第二端口冲突默认管理端口是 8081装之前先确认 8081 没被其他进程占用我见过部署到一半发现 8081 被某个监控系统占掉的情况服务反复起不来还以为是自己配置错了。2.3 从解压到首次启动完整操作步骤把压缩包放到 D 盘或某个空间充足的目录我一般会建一个D:\nexus文件夹专门放它。解压后你会看到两个目录nexus-3.45.0-01程序本体和sonatype-work数据目录第一次启动时自动生成。启动方式有两种前台启动和后台服务。前台启动适合第一次验证环境cd D:\nexus\nexus-3.45.0-01\bin nexus.exe /run这段命令的意思是切到 Nexus 的可执行目录然后以/run参数在前台启动。前台启动的好处是日志直接打在控制台上能第一时间看到启动报错。等看到Started Sonatype Nexus这样的日志行说明核心进程已经起来了这时候可以按 CtrlC 停掉换成注册成 Windows 服务的方式。注册成系统服务需要以管理员身份打开 PowerShell 或 CMDcd D:\nexus\nexus-3.45.0-01\bin nexus.exe /install nexus.exe /start/install是把 Nexus 注册成 Windows 服务服务名默认为nexus/start是启动这个服务。注册完后去服务管理器里确认nexus服务状态是“正在运行”。这一步有个容易忽略的地方如果系统账号对D:\nexus目录没有完全控制权限服务启动会失败所以安装路径尽量不要选在需要 UAC 弹窗才能写入的位置。首次启动后访问http://localhost:8081界面会提示你读取初始密码位置在D:\nexus\sonatype-work\nexus3\admin.password这个文件只在首次启动时存在登录 admin 账号后系统会强制要求改密码并配置匿名访问。这一步我建议直接做掉不要跳过否则后面配 Maven 时你会觉得权限提示莫名其妙。注意3.45.0-01 的默认 JVM 堆内存配置在nexus-3.45.0-01\bin\nexus.vmoptions里默认-Xms1024M -Xmx1024M。如果机器内存只有 4GB建议把-Xmx降到 768M否则服务启动时容易把内存吃满。3. 仓库配置与 Maven 接入三个仓库类型怎么分配3.1 仓库类型的选型逻辑proxy、hosted、groupNexus 3 的仓库配置是核心中的核心它决定了你后续所有使用体验。首次登录后点击设置里的 Repository 菜单你会看到三类仓库proxy代理仓库、hosted宿主仓库、group组仓库。初学者最容易犯的错误是只建一个 proxy 仓库然后用它拉依赖结果内部构件没地方放发布的时候找不到目标仓库。我一般会同时建三个proxy 仓库用于代理 Maven 中央仓库配置时把Remote Storage填成https://repo1.maven.org/maven2/这样团队拉依赖时Nexus 会先把中央仓库的构件缓存到本地磁盘第二次拉就直接命中缓存了。这个环节解决的是“外网慢、反复断”的问题。hosted 仓库用于存放你自己发布的内部构件比如公司的公共工具库、业务封装包。我一般建一个maven-releases和一个maven-snapshots一个管正式版本一个管快照版本。如果团队不分这两类可以只建一个混合仓库但我不推荐这样做正式和快照混在一起版本覆盖问题迟早会出现。group 仓库是把上面几个仓库聚合成一个 URL 的容器。Maven 配置时只需要指向 group 仓库地址Nexus 会按仓库成员顺序自动查找构件。成员顺序有讲究先把 hosted 仓库放在前面再放 proxy 仓库这样内部构件优先命中外部依赖走代理避免同坐标冲突。3.2 修改默认端口与访问地址默认端口是 8081如果已经被占修改方式不是改配置文件而是用控制台命令。停止服务后执行cd D:\nexus\nexus-3.45.0-01\bin nexus.exe /stop nexus.exe /set-http-port 18081 nexus.exe /start/set-http-port是 3.x 提供的专用命令会把端口写进nexus.properties并同步到服务配置里。改完端口后访问路径变成http://localhost:18081。如果你在防火墙里只放行了 8081别忘了同步更新防火墙规则。3.3 配置 Maven settings.xml 接入私服Maven 接入私服核心是改settings.xml位置在 Maven 安装目录的conf下或者用户目录的.m2下。我习惯把配置写在用户目录的settings.xml这样不污染全局配置。先放一个完整的镜像配置settings mirrors mirror idnexus-group/id mirrorOf*/mirrorOf nameNexus Group Mirror/name urlhttp://localhost:8081/repository/maven-public//url /mirror /mirrors servers server idnexus-releases/id usernameadmin/username passwordyour-password/password /server /servers profiles profile idnexus-profile/id repositories repository idnexus-group/id urlhttp://localhost:8081/repository/maven-public//url /repository /repositories /profile /profiles activeProfiles activeProfilenexus-profile/activeProfile /activeProfiles /settingsmirrorOf设为*表示所有仓库请求都走这个镜像这是最省心的做法不用逐个项目指定。servers里的用户名密码用于发布构件时认证注意这里的id必须和后面pom.xml里的distributionManagementid 一致否则发布时 Maven 找不到匹配的凭证。activeProfiles激活后项目里不用写任何仓库配置就能从私服拉依赖。发布内部构件时在项目的pom.xml里加distributionManagement repository idnexus-releases/id urlhttp://localhost:8081/repository/maven-releases//url /repository snapshotRepository idnexus-snapshots/id urlhttp://localhost:8081/repository/maven-snapshots//url /snapshotRepository /distributionManagement然后执行mvn deployMaven 会用 settings.xml 里nexus-releases对应的账号密码把构件推送到 maven-releases 仓库。发布后去 Nexus 界面搜索一下如果能看到刚发布的构件说明整个链路已经通了。4. 常见问题与避坑Nexus 装好后的几处翻车现场4.1 服务启动成功却访问不了页面现象nexus.exe /start提示服务已启动netstat -ano | findstr 8081看不到监听端口页面一直打不开。原因服务启动后进程被系统杀掉了。常见诱因是安装目录或sonatype-work目录所在的盘不是系统系统盘而服务权限只给了Local System账号该账号对 D 盘目录没有写入权限Nexus 启动到一半因无法写入数据目录而崩溃。解决右键服务管理器里的nexus服务选择“属性”在“登录”选项卡里改成“本地系统账户”并勾选“允许服务与桌面交互”。如果还不行直接把整个D:\nexus目录的完全控制权限分配给Everyone临时验证用没问题但生产环境不推荐。4.2 代理仓库一直报 502现象创建 proxy 仓库时测试连接失败或者拉依赖时报Connection timed out浏览器直接访问中央仓库又是通的。原因Nexus 自带的隐式代理模式在某些网络环境下失效尤其公司网络有上网认证或强制走代理服务器时Nexus 默认走直连自然连不上外网。解决在 Nexus 系统设置里配置 HTTP 代理。Admin 账号登录后进入 Settings → System → HTTP/HTTPS Proxy填入公司代理地址和端口。设置完成后去 proxy 仓库里点“Test Connection”确认能通。这个坑我在内网环境踩过几次直接改代码和仓库配置没用问题就是出在代理设置上。4.3 发布的构件在 group 仓库里找不见现象mvn deploy 提示成功单独访问 maven-releases 仓库能看到构件但项目里依赖同坐标构件时报Could not find artifact。原因group 仓库的成员顺序不对或者成员列表里根本没有新创建的 hosted 仓库。我见过一种情况仓库建好后忘记把 maven-releases 加进 maven-public 组导致 group 里永远只有代理仓库。解决进入 maven-public 组的设置把 maven-releases 和 maven-snapshots 添加到成员列表并放在 proxy 仓库前面。注意 group 仓库不看顺序的优先级只看成员顺序列表排在前面的先被搜索所以内部仓库一定要靠前。4.4 磁盘空间被代理缓存撑爆现象运行一段时间后系统盘空间告急检查发现sonatype-work\nexus3\blobs占用了十几个 GB。原因Nexus 默认没有自动清理策略代理仓库下载的构件会一直缓存。默认的defaultblob store 没有设置容量上限时间一久就会膨胀。解决创建独立的 blob store 给代理仓库用并设置清理策略。在 Settings → System → Blob Stores 里新建一个 store然后在 proxy 仓库的高级设置里指定该 store。再在 Repository 的 Cleanup Policy 里建一条“30 天前未使用的构件自动删除”的策略并绑定到代理仓库。4.5 匿名用户无权读取构件现象在 Nexus 界面能看到构件但 Maven 构建时提示401 Unauthorized明明 settings.xml 里已经配置了账号密码。原因创建仓库时没有勾选“Allow anonymous access to this repository”或者全局匿名访问被关闭。Nexus 3 的匿名策略是全局的默认开启但新建仓库时每个仓库单独配置的匿名权限才是真正决定因素。解决进入每个仓库的 Settings勾选匿名访问选项。如果公司内部网络不敏感一般推荐开启匿名读、限制匿名写的配置这样 Maven 构建不需要每次都要认证省时省力。5. 进阶清理策略、备份恢复与批量上传本地构件Nexus 跑顺之后最值得花费时间做的是三件事磁盘清理策略、定时备份数据目录、以及把现有本地仓库的构件批量推送到私服。清理策略我用的是带条件的规则实践下来最有效的一条是“7 天以上未被引用的快照版本删除”。具体做法是创建 cleanup policy 时选择 age 7 days且component的属性为maven2的快照版本然后绑定到 maven-snapshots 托管仓库和所有 proxy 仓库。代理仓库的缓存清理要谨慎如果团队网络不稳定缓存删掉后重建成本很高所以我一般把缓存保留到 90 天。备份方面Nexus 的所有数据都在sonatype-work目录下我写过一个简单的脚本每天凌晨用 robocopy 把整个目录同步到另一块磁盘并保留最近 7 轮的版本robocopy D:\nexus\sonatype-work D:\backup\nexus-work /MIR /LOG:D:\backup\nexus-backup.log/MIR是镜像模式会删除目标目录多余的文件保证备份跟源目录完全一致。这个命令的局限是如果有进程正在写入备份目录会跳过占用文件但考虑到 Nexus 在凌晨基本没有请求风险可控。最后一个实操价值很高的功能是用 API 批量上传本地已有的构件。团队迁移到私服后本地.m2仓库里有一堆历史构件手动一个个部署太慢。我用的是mvn deploy:deploy-file配合脚本循环处理把本地仓库目录下所有 jar 和 pom 文件批量推上去。核心命令长这样mvn deploy:deploy-file ^ -DfileC:\path\to\artifact.jar ^ -DpomFileC:\path\to\artifact.pom ^ -DrepositoryIdnexus-releases ^ -Durlhttp://localhost:8081/repository/maven-releases/-DrepositoryId必须和 settings.xml 里设定的 server id 完全一致否则会走默认本地仓库路径而去尝试连接中央仓库发布报 401。写循环脚本时要注意先校验 pom 文件存在没有 pom 的构件建议直接用generatePomtrue参数让它自动生成。实际迁移时我发现很多老构件的 pom 里groupId路径不对导致上传到错误目录批量上传前先抽查三五个构件的 pom 结构会省掉后面很多找依赖的麻烦。从那以后我每次给团队搭私服都强制自己走一遍“建 proxy — 建 hosted — 配 group — 写 settings.xml — 跑一次 deploy 发布 — 再拉一次依赖验证”这条完整链路所有的配置截图和报错信息都整理到团队内部文档里。花半个小时把底子打好后面省下的是每个人每天反复等超时的抱怨。希望这篇笔记里的步骤和踩坑记录能帮你把第一次装 Nexus 的时间从半天压缩到一顿午饭的功夫。本文还有配套的精品资源点击获取