一、为什么需要私有Nexus3仓库？

在软件开发过程中，依赖管理和制品存储是核心环节。传统开发模式下，团队可能面临以下问题：

依赖下载不稳定：公共Maven仓库（如Maven Central）或Docker Hub可能因网络问题导致构建失败
安全风险：直接使用公共仓库可能引入存在漏洞的第三方依赖
合规性要求：金融、医疗等行业对数据存储位置有严格规定
构建效率低下：重复下载相同依赖导致网络带宽浪费

Nexus Repository Manager 3（简称Nexus3）是Sonatype推出的企业级仓库管理解决方案，支持：

同时管理Maven、npm、PyPI等多种格式的依赖
托管私有Docker镜像
提供代理缓存加速公共仓库访问
具备细粒度的权限控制和审计功能

二、环境准备与镜像获取

1. 容器运行时选择

根据团队技术栈选择Podman或Docker：

Docker：生态成熟，社区资源丰富

# 安装Docker（Ubuntu示例）
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io
sudo systemctl enable docker

Podman：无守护进程设计，更安全

# 安装Podman（CentOS示例）
sudo dnf install podman

2. 获取Nexus3镜像

推荐使用官方镜像：

# Docker方式
docker pull sonatype/nexus3:latest
# Podman方式（镜像存储在用户命名空间）
podman pull docker.io/sonatype/nexus3:latest

三、部署Nexus3服务

1. 基础容器启动

使用以下命令快速启动Nexus3（以Docker为例）：

docker run -d --name nexus3 \
  -p 8081:8081 \
  -p 8082-8084:8082-8084 \
  -v nexus-data:/nexus-data \
  sonatype/nexus3

关键参数说明：

8081：Nexus3默认Web端口
8082-8084：为Docker仓库预留的端口范围
-v：持久化存储卷，防止数据丢失

2. 生产环境优化配置

对于企业级部署，建议：

docker run -d --name nexus3 \
  --restart unless-stopped \
  -p 8081:8081 \
  -p 8082:8082 \
  -p 8083:8083 \
  -p 8084:8084 \
  -e INSTALL4J_ADD_VM_PARAMS="-Xms2g -Xmx4g -XX:MaxDirectMemorySize=1g" \
  -v /opt/nexus-data:/nexus-data \
  sonatype/nexus3

配置要点：

内存参数：根据服务器配置调整JVM参数
持久化路径：建议使用独立磁盘分区
自动重启策略：确保服务高可用

四、仓库配置实战

1. 初始化访问

首次访问http://<服务器IP>:8081，使用默认凭证：

用户名：admin
密码：从/nexus-data/admin.password文件获取

2. 创建Maven私有仓库

登录后进入 Settings > Repository > Repositories
点击 Create repository，选择 maven2 (hosted)
配置参数：
- Name: maven-private
- Online: 勾选
- Storage: 默认Blob store
- Deployment policy: Allow redeploy（开发环境）或Disable redeploy（生产环境）

3. 配置Docker私有仓库

创建Docker hosted仓库：
- Name: docker-private
- HTTP port: 8082
- V1 enabled: 勾选（兼容旧客户端）
创建Docker proxy仓库（可选）：
- 代理Docker Hub加速下载
- Name: docker-proxy
- Remote storage: https://registry-1.docker.io

4. 创建仓库组

将多个仓库聚合为一个访问点：

创建 maven2 (group) 类型仓库
添加成员仓库：
- maven-public（Nexus内置代理仓库）
- maven-private（自建私有仓库）
配置客户端使用该组作为仓库地址

五、客户端配置指南

1. Maven配置

在settings.xml中添加：

<servers>
  <server>
    <id>nexus</id>
    <username>deploy-user</username>
    <password>your-password</password>
  </server>
</servers>
<profiles>
  <profile>
    <id>nexus</id>
    <repositories>
      <repository>
        <id>nexus</id>
        <url>http://nexus-host:8081/repository/maven-group/</url>
        <releases><enabled>true</enabled></releases>
        <snapshots><enabled>true</enabled></snapshots>
      </repository>
    </repositories>
  </profile>
</profiles>
<activeProfiles>
  <activeProfile>nexus</activeProfile>
</activeProfiles>

2. Docker客户端配置

在/etc/docker/daemon.json中添加：

{
  "insecure-registries": ["nexus-host:8082"]
}

重启Docker服务后，可执行：

# 登录私有仓库
docker login nexus-host:8082
# 推送镜像
docker tag my-image nexus-host:8082/my-project/my-image:latest
docker push nexus-host:8082/my-project/my-image:latest

六、安全加固建议

HTTPS配置：
- 使用Let’s Encrypt免费证书
- 配置Nginx反向代理
权限管理：
- 创建专用部署账号（仅限nx-repository-admin-*权限）
- 启用匿名访问限制

备份策略：

# 定期备份配置和数据
tar -czvf nexus-backup-$(date +%Y%m%d).tar.gz /nexus-data

监控告警：
- 监控磁盘空间使用率
- 设置仓库存储配额

七、常见问题解决方案

端口冲突：
- 检查8081-8084端口是否被占用
- 修改容器端口映射
内存不足：
- 观察Nexus3日志中的OOM错误
- 调整JVM参数（建议生产环境至少4GB内存）
仓库访问404：
- 确认仓库类型配置正确
- 检查客户端URL是否包含/repository/前缀
Docker推送失败：
- 确认已执行docker login
- 检查镜像标签格式是否正确

八、进阶使用技巧

内容选择器：
- 创建规则限制特定组只能访问特定仓库
- 示例：禁止开发人员访问生产仓库
清理策略：
- 设置Maven快照自动清理
- 配置Docker镜像保留策略
高可用部署：
- 使用共享存储（如NFS）
- 配置多个Nexus3实例组成集群

CI/CD集成：

在Jenkins/GitLab CI中配置Nexus3作为制品仓库

示例Jenkinsfile片段：

pipeline {
  agent any
  stages {
    stage('Deploy') {
      steps {
        nexusPublisher(
          nexusInstanceId: 'my-nexus',
          nexusRepositoryId: 'maven-private',
          packages: [[$class: 'MavenPackage',
                     mavenAssetList: [[classifier: '',
                                      extension: 'jar',
                                      filePath: 'target/my-app.jar']],
                     mavenCoordinate: [artifactId: 'my-app',
                                      groupId: 'com.example',
                                      packaging: 'jar',
                                      version: '1.0.0']]]
        )
      }
    }
  }
}

通过以上步骤，您已经成功构建了一个功能完备的私有仓库系统。根据实际需求，可以进一步探索Nexus3的IQ Server集成、仓库健康检查等高级功能，为企业软件交付提供更强大的支撑。

使用Podman/Docker快速搭建Nexus3私有Maven与Docker镜像仓库