Linux搭建Nexus Maven私服教程

本文详细介绍了如何使用官方 Docker 镜像高效、可靠地在 Linux 环境下搭建 Nexus 3 Maven 私服，强调摒弃过时的手动部署方式（如 WAR 包+Tomcat），转而利用 Docker 实现环境隔离、一键启停与配置简化；重点剖析了实战中高频踩坑点——包括必须挂载并正确授权 `/nexus-data` 数据卷以防数据丢失、首次登录后强制修改 admin 密码的必要性及常见失败原因、Maven `settings.xml` 中 server id 与 `pom.xml` 中 `distributionManagement` id 必须严格一致才能避免 401 错误，以及 release/snapshot 包必须匹配对应仓库类型和 Deployment policy 设置，帮你绕开绝大多数部署和上传失败陷阱，真正实现开箱即用、稳定可靠的私有 Maven 仓库。

直接用官方 Docker 镜像最省事，别硬装 Java + Tomcat + Nexus 手动部署

官方早就不推荐传统 WAR 包部署方式了，nexus3 从 3.0 开始只提供 docker 和 tar.gz 两种分发形式，而 tar.gz 方式仍需手动管理 JVM 参数、启动脚本、权限、日志轮转——出问题时排查路径长、干扰因素多。Docker 方式能隔离依赖、固化环境、一键启停，连 systemd 都不用配。

实操建议：

• 确保宿主机已安装 docker 且当前用户在 docker 组里（避免每次加 sudo）
• 拉镜像：docker pull sonatype/nexus3（注意不是 sonatype/nexus，那是旧版 Nexus2）
• 挂载数据卷（关键！否则容器重启后仓库全丢）：docker run -d -p 8081:8081 --name nexus -v /opt/nexus-data:/nexus-data sonatype/nexus3
• /opt/nexus-data 目录需提前创建并赋权：mkdir -p /opt/nexus-data && chown -R 200:200 /opt/nexus-data（Nexus3 容器内默认以 UID 200 运行）

首次访问 Nexus 后必须改 admin 密码，否则 Maven 上传会 401

安装完打开 http://localhost:8081，初始账号是 admin，密码在容器日志里：docker logs nexus | grep 'password is'。但这个临时密码只能登录一次，系统强制跳转到改密页——很多人卡在这儿，以为登录成功就完事了，结果后续用 mvn deploy 时一直报 401 Unauthorized。

容易踩的坑：

• 改密页没点「Save」而是直接关页面，下次登录仍用旧密码会失败
• 新密码不符合策略（至少 8 位、含大小写字母+数字+特殊字符），页面无明确提示，只静默失败
• 改完密码后，Maven 的 settings.xml 里 的 必须同步更新，否则所有 deploy 操作都 401

maven settings.xml 里 的 id 必须和 中的 id 完全一致

这是 Maven 私服最常配置错的一环。Nexus 不认 URL，只靠 id 字符串做凭证匹配。哪怕只差一个空格或大小写，Maven 就找不到对应账号密码，最终报 401 或 403。

示例片段（注意两处 nexus-releases 必须一模一样）：

<settings>
  <servers>
    <server>
      <id>nexus-releases</id>
      <username>admin</username>
      <password>your_new_password</password>
    </server>
  </servers>
  <profiles>
    <profile>
      <id>my-nexus</id>
      <repositories>
        <repository>
          <id>nexus</id>
          <url>http://localhost:8081/repository/maven-public/</url>
        </repository>
      </repositories>
    </profile>
  </profiles>
  <activeProfiles>
    <activeProfile>my-nexus</activeProfile>
  </activeProfiles>
</settings>

对应项目 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>

仓库类型选错会导致 deploy 失败：release 包不能发到 snapshot 仓库，反之亦然

Nexus 默认建了三个关键仓库：maven-releases（type: hosted, Release）、maven-snapshots（type: hosted, Snapshot）、maven-public（type: group）。Maven 的 deploy 行为严格按 结尾是否含 -SNAPSHOT 判定目标仓库——不是看 URL，也不是看 profile 激活状态。

常见错误现象：

• 项目 1.0.0-SNAPSHOT 却配置了 指向 maven-releases → 报错 Failed to deploy artifacts: Could not transfer artifact ... Failed to transfer file ... Return code is: 400
• 非 SNAPSHOT 版本发到 maven-snapshots → 报错 400 Bad Request，日志里提示 Snapshot artifacts may not be deployed to a release repository
• 想让 CI 自动发布 release 包，却忘了在 Nexus 后台关闭 maven-releases 的 Deployment policy（默认是 Disable redeploy），导致重复构建失败

真正需要关注的是 Nexus 界面里每个 hosted 仓库的「Configuration」页签下的 Version policy 和 Deployment policy，而不是 Maven 配置本身。

今天关于《Linux搭建Nexus Maven私服教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！