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

在分布式开发与微服务架构下，企业面临两大核心痛点：一是Maven中央仓库下载依赖缓慢且存在网络风险，二是Docker镜像存储缺乏统一管理导致版本混乱。Nexus3作为Sonatype推出的下一代仓库管理器，通过单一平台支持Maven、npm、Docker等15+种格式的存储，其Blob Store机制可节省30%以上存储空间。

1.1 核心优势分析

性能提升：本地缓存使Maven构建速度提升5-8倍
安全合规：支持镜像签名验证与漏洞扫描
成本控制：避免重复下载节省带宽费用
权限隔离：支持项目级仓库权限控制

二、环境准备与容器化部署

2.1 容器运行时选择

特性	Docker	Podman
架构	Client-Server模式	无守护进程的库模式
安全性	需root权限运行	支持rootless模式
兼容性	全面兼容	兼容Docker CLI
集群管理	依赖Swarm/K8s	内置Pod支持

2.2 部署方案实施

方案一：Docker部署（推荐生产环境）

# 创建持久化卷
docker volume create nexus-data
# 启动容器（内存建议≥4GB）
docker run -d --name nexus \
  -p 8081:8081 -p 8082-8083:8082-8083 \
  -v nexus-data:/nexus-data \
  -e INSTALL4J_ADD_VM_PARAMS="-Xms2g -Xmx4g" \
  sonatype/nexus3:3.60.0

方案二：Podman部署（开发环境优选）

# 创建存储目录
mkdir -p /var/nexus-data
# 启动容器（使用rootless模式）
podman run -d --name nexus \
  --network host \
  -v /var/nexus-data:/nexus-data \
  -e NEXUS_CONTEXT=nexus \
  sonatype/nexus3:3.60.0

关键参数说明：

-Xms2g -Xmx4g：JVM堆内存配置，需根据服务器规格调整
8082-8083端口：预留用于Docker代理仓库
NEXUS_CONTEXT：设置上下文路径（Podman特有）

三、核心仓库配置

3.1 Maven仓库配置

创建blob存储：

// 通过REST API创建（需获取admin密码）
curl -u admin:$(cat /nexus-data/admin.password) \
  -X POST "http://localhost:8081/service/rest/v1/blobstores" \
  -H "accept: application/json" \
  -H "content-type: application/json" \
  -d '{"name": "maven-blob", "type": "File"}'

配置代理仓库：
- 类型选择maven2(proxy)
- 远程存储：https://repo.maven.apache.org/maven2/
- 设置存储路径规则：^/(com|org)/([^/]+)/([^/]+)/([^/]+)/
创建宿主仓库：
- 类型选择maven2(hosted)
- 部署策略：Allow redeploy
- 存储位置：指向maven-blob

3.2 Docker仓库配置

创建Docker代理仓库：

# 通过Nexus UI配置示例
provider: docker-proxy
remoteUrl: https://registry-1.docker.io
port: 8082
httpClient:
  blocked: false
  autoBlock: true

配置私有仓库：
- 类型选择docker(hosted)
- 启用HTTPS（需配置证书）
- 设置存储限制：maxStorage: 50gb

镜像签名验证：

# 生成GPG密钥
gpg --full-generate-key
# 导出公钥
gpg --export -a "Key Name" > pubkey.asc

四、高级运维管理

4.1 备份与恢复策略

# 完整备份脚本示例
#!/bin/bash
BACKUP_DIR="/backups/nexus-$(date +%Y%m%d)"
mkdir -p $BACKUP_DIR
# 备份数据库
docker exec nexus /opt/sonatype/nexus/bin/nexus.sh db export $BACKUP_DIR/db.json
# 备份blob存储
rsync -avz /nexus-data/blobs $BACKUP_DIR/

4.2 性能优化方案

JVM调优参数：

-XX:+UseG1GC
-XX:MaxGCPauseMillis=200
-XX:InitiatingHeapOccupancyPercent=35

存储优化：
- 启用压缩：nexus.blobstore.compact.enabled=true
- 设置清理任务：0 0 * * * /opt/sonatype/nexus/bin/nexus.sh blobstore compact

4.3 安全加固措施

访问控制：

<!-- capabilities.xml配置示例 -->
<capability>
  <id>routing</id>
  <type>routing</type>
  <properties>
    <property>
      <key>ruleSet</key>
      <value>
        <rule>
          <pattern>^/repository/internal/.*</pattern>
          <type>blacklist</type>
        </rule>
      </value>
    </property>
  </properties>
</capability>

审计日志：
- 启用nexus.audit.enabled=true
- 配置日志轮转：maxFileSize=10MB, maxBackupIndex=5

五、客户端集成实践

5.1 Maven配置示例

<!-- settings.xml配置 -->
<servers>
  <server>
    <id>nexus</id>
    <username>deploy</username>
    <password>${env.NEXUS_PASSWORD}</password>
  </server>
</servers>
<mirrors>
  <mirror>
    <id>nexus</id>
    <url>http://nexus:8081/repository/maven-public/</url>
    <mirrorOf>central</mirrorOf>
  </mirror>
</mirrors>

5.2 Docker客户端配置

# 配置insecure-registries（测试环境）
echo '{"insecure-registries":["nexus:8082"]}' > /etc/docker/daemon.json
systemctl restart docker
# 登录私有仓库
docker login nexus:8082

六、故障排查指南

6.1 常见问题处理

现象	解决方案
503 Service Unavailable	检查JVM内存配置，调整`-Xmx`参数
401 Unauthorized	重置admin密码：`cat /nexus-data/admin.password`
镜像推送失败	检查防火墙放行8082-8083端口
构建缓慢	配置Maven镜像加速：`-Dmaven.repo.local=/tmp/m2`

6.2 日志分析技巧

关键日志路径：
- 应用日志：/nexus-data/log/nexus.log
- 访问日志：/nexus-data/log/request.log
- GC日志：/nexus-data/log/gc.log

日志分析命令：

# 统计错误请求
grep "ERROR" /nexus-data/log/nexus.log | awk '{print $5}' | sort | uniq -c
# 分析GC停顿
grep "Pause Full" /nexus-data/log/gc.log | awk '{print $4}' | numavg

七、升级与扩展方案

7.1 版本升级流程

# 1. 备份当前数据
docker exec nexus tar czf /tmp/nexus-backup.tar.gz /nexus-data
# 2. 停止旧容器
docker stop nexus
# 3. 启动新版本（使用相同卷）
docker run -d --name nexus-new \
  -v nexus-data:/nexus-data \
  sonatype/nexus3:3.61.0
# 4. 验证服务
curl -I http://localhost:8081/service/metrics/ping

7.2 集群部署架构

推荐采用以下高可用方案：

主从复制：
- 主节点：写入操作
- 从节点：只读缓存
- 同步间隔：30秒

负载均衡配置：

upstream nexus {
  server nexus1:8081 weight=5;
  server nexus2:8081;
  server nexus3:8081 backup;
}
server {
  listen 80;
  location / {
    proxy_pass http://nexus;
    proxy_set_header Host $host;
  }
}

通过以上方案，企业可构建出高可用、高性能的私有仓库系统。实际部署时建议先在测试环境验证配置，再逐步推广到生产环境。定期监控关键指标（如响应时间、存储增长率）并建立预警机制，可确保系统长期稳定运行。

使用Podman/Docker搭建Nexus3私有Maven与Docker镜像仓库全攻略