推荐使用官方 Docker 镜像部署 Nexus3，因其省去手动配置 Java/Tomcat、环境隔离、一键启停；需挂载 /nexus-data 卷并赋权 UID 200，首次登录后必须修改 admin 密码，且 Maven 的 settings.xml 中 server id 必须与 pom.xml distributionManagement 中 id 完全一致，否则 401；release/snapshot 包须对应正确仓库类型，且 hosted 仓库的 Deployment policy 需按需开启。
直接用官方 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里<server>的<password>必须同步更新，否则所有 deploy 操作都 401
maven settings.xml 里 <server> 的 id 必须和 <distributionManagement> 中的 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 行为严格按 <version> 结尾是否含 -SNAPSHOT 判定目标仓库——不是看 URL，也不是看 profile 激活状态。
常见错误现象：
- 项目
<version>1.0.0-SNAPSHOT</version>却配置了<repository>指向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 配置本身。
