一、为什么选择Nexus3作为私有仓库解决方案？

Nexus Repository Manager 3（简称Nexus3）是Sonatype公司推出的开源仓库管理工具，相比早期版本，其架构设计更适应现代DevOps需求。作为企业级解决方案，Nexus3同时支持Maven、npm、PyPI等多种包管理格式，但本文重点聚焦其Maven仓库与Docker镜像仓库功能。

核心优势分析：

统一管理：单节点支持多类型仓库，降低运维复杂度
安全控制：提供细粒度的权限管理（RBAC）与IP白名单
性能优化：支持Blob存储分离，可对接S3等对象存储
镜像加速：内置Docker Proxy功能，可缓存远程仓库镜像

相较于Harbor等纯Docker仓库方案，Nexus3的优势在于其多协议支持能力，特别适合需要同时管理Java依赖与容器镜像的团队。

二、环境准备与工具选择

2.1 Podman vs Docker：如何选择？

特性	Podman	Docker
架构	无守护进程（daemonless）	客户端-守护进程模式
安全性	支持rootless容器	需额外配置rootless模式
兼容性	兼容Docker CLI（`podman docker`别名）	原生支持
集群管理	通过CRI-O集成Kubernetes	内置Swarm模式

推荐选择：

开发环境：Docker（生态更成熟）
生产环境：Podman（增强安全性）
混合环境：两者共存（通过alias docker=podman兼容）

2.2 系统要求

操作系统：Linux（推荐CentOS 8+/Ubuntu 20.04+）
硬件配置：
- 基础版：2核CPU/4GB内存/50GB磁盘
- 生产版：4核CPU/8GB内存/200GB磁盘（建议SSD）
网络要求：开放8081（HTTP）、8082（Docker）、8443（HTTPS）端口

三、容器化部署Nexus3（以Docker为例）

3.1 基础部署命令

# 拉取官方镜像（建议指定版本号）
docker pull sonatype/nexus3:3.60.0
# 创建数据持久化目录
mkdir -p /opt/nexus-data
chown -R 200:200 /opt/nexus-data  # Nexus默认使用200用户组
# 启动容器
docker run -d \
  --name nexus3 \
  -p 8081:8081 \
  -p 8082:8082 \
  -p 8443:8443 \
  -v /opt/nexus-data:/nexus-data \
  --restart unless-stopped \
  sonatype/nexus3:3.60.0

关键参数说明：

-v：必须将容器内/nexus-data目录映射到宿主机，否则重启后数据丢失
-p 8082：Docker仓库默认端口（需后续配置）
--restart：设置容器自动重启策略

3.2 使用Podman部署（兼容模式）

# 创建Podman网络（可选）
podman network create nexus-net
# 启动容器（与Docker命令高度相似）
podman run -d \
  --name nexus3 \
  --network nexus-net \
  -p 8081:8081 \
  -v /opt/nexus-data:/nexus-data \
  docker.io/sonatype/nexus3:3.60.0

四、Nexus3核心配置指南

4.1 初始访问与密码获取

访问http://<服务器IP>:8081
首次登录密码位于：/opt/nexus-data/admin.password
```
sudo cat /opt/nexus-data/admin.password
```
登录后强制修改密码

4.2 创建Maven私有仓库

仓库类型选择：
- maven2 (hosted)：私有仓库（上传依赖）
- maven2 (proxy)：代理中央仓库（如Maven Central）
- maven2 (group)：组合多个仓库
配置示例：
- 名称：maven-private
- 存储类型：File（默认）
- 部署策略：Allow redeploy（允许重复部署）

客户端配置（settings.xml）：

<servers>
  <server>
    <id>nexus-maven</id>
    <username>admin</username>
    <password>你的密码</password>
  </server>
</servers>
<mirrors>
  <mirror>
    <id>nexus-mirror</id>
    <url>http://<服务器IP>:8081/repository/maven-public/</url>
    <mirrorOf>central</mirrorOf>
  </mirror>
</mirrors>

4.3 配置Docker私有仓库

创建blob存储（可选）：
- 路径：/nexus-data/blobs/docker
- 用于分离Docker镜像存储
创建Docker仓库：
- 类型：docker (hosted)
- HTTP端口：8082
- 启用V1 API（兼容旧版Docker客户端）

客户端认证配置：

# 登录私有仓库
docker login http://<服务器IP>:8082
# 或使用Podman
podman login http://<服务器IP>:8082

镜像推送示例：

# 标记镜像
docker tag alpine:latest <服务器IP>:8082/myrepo/alpine:1.0
# 推送镜像
docker push <服务器IP>:8082/myrepo/alpine:1.0

五、高级配置与优化

5.1 HTTPS安全配置

生成自签名证书：

openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
  -keyout /etc/ssl/nexus.key -out /etc/ssl/nexus.crt \
  -subj "/CN=nexus.example.com"

配置Nexus3 HTTPS：
- 上传证书至/opt/nexus-data/etc/ssl/
- 修改nexus.properties：
```
application-port-ssl=8443
nexus-args=${jetty.etc}/jetty-https.xml
```

5.2 性能调优建议

JVM参数调整（/opt/nexus-data/etc/nexus.vmoptions）：
```
-Xms4g
-Xmx4g
-XX:MaxDirectMemorySize=2g
```
存储优化：
- 启用压缩：nexus.blobstore.compact.enabled=true
- 定期执行Compact blob store任务

5.3 备份与恢复策略

完整备份脚本：

# 停止服务（可选）
docker stop nexus3
# 备份数据目录
tar -czvf nexus-backup-$(date +%Y%m%d).tar.gz /opt/nexus-data
# 恢复时反向操作

增量备份方案：
- 使用rsync只同步变更文件
- 配置cron定时任务

六、常见问题解决方案

6.1 端口冲突问题

现象：启动时报Address already in use

解决：

# 检查占用端口
ss -tulnp | grep 8081
# 终止冲突进程
kill -9 <PID>
# 或修改Nexus3端口映射

6.2 权限错误（503 Service Unavailable）

原因：数据目录权限不正确

解决：

chown -R 200:200 /opt/nexus-data
chmod -R 755 /opt/nexus-data

6.3 Docker推送失败（405 Method Not Allowed）

检查项：

确认仓库类型为hosted而非proxy
验证客户端是否使用正确端口（8082而非8081）
检查仓库是否启用Docker API支持

七、总结与最佳实践

7.1 部署架构建议

开发环境：单节点Docker部署
生产环境：
- 主备模式（通过文件系统同步）
- 负载均衡（Nginx反向代理）
- 分离存储（NFS/S3对接）

7.2 持续集成集成

将Nexus3与Jenkins/GitLab CI集成示例：

// Jenkinsfile片段
pipeline {
  agent any
  stages {
    stage('Build & Push') {
      steps {
        script {
          docker.withRegistry('http://nexus:8082', 'nexus-creds') {
            def img = docker.build("myapp:${env.BUILD_ID}")
            img.push()
          }
        }
      }
    }
  }
}

7.3 监控告警配置

推荐监控指标：

磁盘空间使用率
JVM内存使用
仓库请求延迟（Prometheus+Grafana）

通过本文的详细指导，开发者可以快速完成从环境准备到高级配置的全流程操作。实际部署时，建议先在测试环境验证配置，再逐步迁移到生产环境。对于大型团队，可考虑结合Ansible/Terraform实现自动化部署。

基于Podman与Docker搭建Nexus3私有Maven及Docker镜像仓库全攻略