liumiaocn/nexus

Nexus OSS Docker镜像文档

镜像概述和主要用途

Nexus是当前流行的私库管理工具，广泛应用于包管理和Docker镜像管理场景。Easypack提供的此Docker镜像基于最新版本的Nexus OSS（开源版），旨在提供便捷的私库服务，并支持与Maven集成实现高效的包管理。

核心功能和特性

• 基于最新Nexus OSS：采用最新稳定版本的Nexus OSS作为基础，确保功能完整性和安全性
• 多仓库类型支持：
  • hosted：本地存储，提供私有包的存储和
  • proxy：代理远程仓库，缓存外部依赖
  • group：组合多个仓库，提供统一访问入口
• 数据持久化：支持通过卷挂载、命名卷或数据容器实现数据分离，便于管理和备份
• Maven集成：支持Snapshot和Release版本分离管理，满足开发和发布流程需求

使用场景和适用范围

• 企业内部私有仓库搭建，管理内部开发的包和镜像
• Maven项目依赖管理，加速构建过程并控制依赖版本
• Docker镜像私有仓库，安全存储和分发内部镜像
• 需要统一管理多个外部仓库（如Maven Central）的场景

使用方法和配置说明

下载镜像

bash
docker pull liumiaocn/nexus

启动Nexus容器

1. 创建数据目录（用于持久化Nexus数据）：

bash
mkdir -p /usr/local/nexus-data

2. 启动容器（映射8081端口，指定容器名称）：

bash
docker run -d -p 8081:8081 --name nexus liumiaocn/nexus

登录Nexus

创建仓库

仓库类型说明

创建Snapshot仓库（hosted类型）

用于管理Maven中版本以-SNAPSHOT结尾的开发版本包：

1. 创建blob store：建议为每个仓库单独创建blob store，便于数据隔离管理
2. 进入管理界面：Server administration and configuration -> Administration -> repository -> repositories
3. 选择maven2 (hosted)类型，配置以下参数：
   • name: maven-snapshots
   • version policy: snapshot
   • deployment policy: allow redeploy
   • blob store: 选择之前创建的blob store（如maven-snapshots）

创建Release仓库（hosted类型）

用于管理Maven中正式版本（非-SNAPSHOT结尾）的包：

• 类型: maven2 (hosted)
• name: maven-releases
• deployment policy: allow redeploy
• blob store: maven-releases（单独创建的blob store）

创建Proxy仓库

用于代理远程仓库（如Maven Central），缓存外部依赖：

• 类型: maven2 (proxy)
• name: maven-central
• 远程仓库地址: [***]
• blob store: maven-central
• Maximum component age: 1440（缓存有效期，单位分钟）

创建Group仓库

组合多个仓库，提供统一访问入口：

• 类型: maven2 (group)
• name: maven-group
• blob store: maven-central
• 成员仓库: 按顺序添加 maven-snapshots、maven-releases、maven-central

Maven配置

1. 安装Maven：可通过容器或裸机方式安装（参考官方文档）
2. 配置settings.xml（通常位于~/.m2/settings.xml）：

xml
<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.1.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd">

  <servers>
    <server>
      <id>nexus-snapshots</id>
      <username>admin</username>
      <password>admin123</password>
    </server>
    <server>
      <id>nexus-releases</id>
      <username>admin</username>
      <password>admin123</password>
    </server>
  </servers>

  <mirrors>
    <mirror>
      <id>central</id>
      <name>central</name>
      <url>http://[服务器IP]:8081/repository/maven-group/</url>
      <mirrorOf>*</mirrorOf>
    </mirror>
  </mirrors>

</settings>

项目配置（pom.xml）

在Maven项目的pom.xml中添加仓库和分发管理配置：

xml
<repositories>
  <repository>
    <id>maven-group</id>
    <url>http://[服务器IP]:8081/repository/maven-group</url>
  </repository>
</repositories>

<distributionManagement>
  <snapshotRepository>
    <id>maven-snapshots</id>
    <url>http://[服务器IP]:8081/repository/maven-snapshots/</url>
  </snapshotRepository>
  <repository>
    <id>maven-releases</id>
    <url>http://[服务器IP]:8081/repository/maven-releases/</url>
  </repository>
</distributionManagement>

执行确认

1. 验证依赖拉取：执行mvn install，检查输出日志中依赖是否从Nexus私库拉取

bash
mvn install

2. 检查仓库缓存：登录Nexus管理界面，查看maven-central仓库是否已缓存依赖包
3. 运行项目：通过编译生成的Jar包启动项目，验证依赖是否正常加载

bash
java -jar target/[项目Jar包名称]