【Nexus】安装配置与使用

Nexus Repository OSS

only°夏至besos

9183人浏览 · 2022-08-03 14:42:30

only°夏至besos · 2022-08-03 14:42:30 发布

1、为什么使用Nexus

如果没有私服，我们所需的所有构件都需要通过maven的中央仓库和第三方的Maven仓库下载到本地，而一个团队中的所有人都重复的从maven仓库下载构件无疑加大了仓库的负载和浪费了外网带宽，如果网速慢的话，还会影响项目的进程。很多情况下项目的开发都是在内网进行的，连接不到maven仓库怎么办呢？开发的公共构件怎么让其它项目使用？这个时候我们不得不为自己的团队搭建属于自己的maven私服，这样既节省了网络带宽也会加速项目搭建的进程，当然前提条件就是你的私服中拥有项目所需的所有构件。

2、Nexus下载

下载地址：Download Archives - Repository Manager 3

3、Nexus启动

我下载的是zip包，解压后进入\nexus-2.1.2-bundle\nexus-2.1.2\bin\jsw\，根据操作系统类型选择文件夹，我选的是windows-x86-32文件夹，进入后可看到如下所示bat文件。

双击console-nexus.bat运行。游览器中输入http://127.0.0.1:8081/nexus/，出现图下所示就代表nexus已经启动成功。

8081为默认的端口号，要修改端口号可进入nexus-2.1.2-bundle\nexus-2.1.2\conf\打开nexus.properties文件，修改application-port属性值就可以了。

默认的用户名和密码：admin/admin123，登录后看到图下所示：

4、Nexus仓库

nexus的仓库类型分为以下四种：

group: 仓库组

hosted：宿主

proxy：代理

virtual：虚拟

首次登陆nexus后可以看到以下一个仓库组和多个仓库。

Public Repositories:  仓库组

3rd party: 无法从公共仓库获得的第三方发布版本的构件仓库

Apache Snapshots: 用了代理ApacheMaven仓库快照版本的构件仓库

Central: 用来代理maven中央仓库中发布版本构件的仓库

Central M1 shadow: 用于提供中央仓库中M1格式的发布版本的构件镜像仓库

Codehaus Snapshots: 用来代理CodehausMaven 仓库的快照版本构件的仓库

Releases: 用来部署管理内部的发布版本构件的宿主类型仓库

Snapshots:用来部署管理内部的快照版本构件的宿主类型仓库

4.1、创建Nexus宿主仓库

在Repositories选项页的菜单栏上点击Add按钮会出现如下所示，选择要添加的仓库类型。

这里我点击添加宿主类型的仓库，在仓库列表的下方会出现新增仓库的配置，如下所示：

点击save按钮后就会在仓库列表中看到刚才新增的仓库。

4.2、创建Nexus代理仓库

点击菜单栏上的Add按钮后选择Proxy Repository，看到如下所示配置界面：

4.3、创建Nexus仓库组

仓库组和仓库关系是一对多的关系，一个仓库组可以指向多个仓库。

点击菜单栏上的Add按钮选择Repository Group就可以看到仓库组的配置界面，如下所示：

点击save后就可在仓库列表中看到新增的仓库组了，项目中如果要下载构件的话，配置文件中一般都用仓库组的URL。

5、修改Maven配置文件从Nexus下载构件

1）如果想对操作系统的所有用户统一配置maven，则只需修改maven\conf\setting.xml文件就可以了，如果只想对用户单独配置maven，只需将conf\setting.xml文件复制到C:\Documents and Settings\Administrator\.m2文件夹下（我这里假设系统装在c盘，用户为Administrator）。
2) 打开setting.xml文件，可以看到如下代码：

<!-- localRepository
   | The path to the local repository maven will use to store artifacts.
   |
   | Default: ~/.m2/repository 
  <localRepository></localRepository>
 -->

表示如果不设置localRepository，maven会默认将本地仓库建到/.m2/repository文件夹下。

设置localRepository如下代码所示：

<localRepository>F:\myCenterRepository</localRepository>

表示在myCenterRepository文件夹下建立本地仓库。个人建议不要采用默认的仓库地址，因为项目如果很多的话，那么本地仓库所占的磁盘空间就比较多了，所以指定仓库地址到其他盘符，更方便管理。

5.2、在POM文件中配置Nexus仓库

在项目的pom文件中添加如下代码：

<repositories>   
    <repository>   
      <id>nexus</id>   
      <name>my-nexus-repository</name>   
      <url>http://127.0.0.1:7788/nexus/content/groups/public/</url>   
      <releases>   
        <enabled>true</enabled>   
      </releases>   
      <snapshots>   
        <enabled>false</enabled>   
      </snapshots>   
    </repository>   
  </repositories>   
  <pluginRepositories>   
    <pluginRepository>   
      <id>nexus</id>   
      <name>my-nexus-repository</name>   
      <url>http://127.0.0.1:7788/nexus/content/groups/public/</url>   
      <releases>   
        <enabled>true</enabled>   
      </releases>   
      <snapshots>   
        <enabled>false</enabled>   
      </snapshots>        
    </pluginRepository>   
  </pluginRepositories>

在pom文件中配置只对当前项目有效，而实际开发中不可能在每个项目中重复配置信息，所以不建议在pom文件中配置。

5.3、在setting.xml文件中配置Nexus仓库

1）maven提供了profile来配置仓库信息，如下所示：

<profiles>
    <profile>
      <id>myprofile</id>
      <repositories>
		    <repository>
		        <id>central</id>                                   
		        <url>http://central</url>                      
		        <releases>
		            <enabled>true</enabled>
		        </releases>
		        <snapshots>
		            <enabled>true</enabled>
		        </snapshots>
		    </repository>
		</repositories>   
		 <pluginRepositories>
			<pluginRepository>
			  <id>central</id>
			  <url>http://central</url>
			  <releases>
				<enabled>true</enabled>
			  </releases>
			  <snapshots>
				<enabled>false</enabled>
			  </snapshots>
			</pluginRepository>
	    </pluginRepositories>
    </profile>
</profiles>

2) 激活profile

<activeProfiles>
    <activeProfile>myprofile</activeProfile>
  </activeProfiles>

3）配置镜像

 <mirrors>
     <mirror>   
      <id>nexus</id>    
      <url>http://127.0.0.1:7788/nexus/content/groups/public/</url>   
      <mirrorOf>*</mirrorOf>   
    </mirror>
  </mirrors>

6、部署构件到Nexus仓库

6.1、maven部署

1）修改pom文件

在pom文件中添加如下配置：

<distributionManagement>
       <repository>
           <id>my-nexus-releases</id>
           <url>http://127.0.0.1:7788/nexus/content/repositories/releases/</url>
       </repository>
       
       <snapshotRepository>
           <id>my-nexus-snapshot</id>
           <url>http://127.0.0.1:7788/nexus/content/repositories/snapshots/</url>
       </snapshotRepository>
  </distributionManagement>

2）在setting.xml文件中添加认证信息：

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

上面的配置中我用的是超级管理员的账户，开发项目中可以改为具有部署构件权限的用户就可以了。

3）执行部署

测试的构件项目信息如下：

<groupId>com.ez</groupId>
  <artifactId>TestJar</artifactId>
  <version>1.0</version>
  <packaging>jar</packaging>
  <name>TestJar</name>

从上面的信息中可以看出构件为发布版本，所以部署构件的话会自动部署至releases仓库中。

在命令行中执行：mvn clean deploy

如果之前没用执行过该命令，maven会自动到中央仓库中下载部署所需的插件。最后在命令行中看到如下所示就代表构件已经部署成功。

到nexus的releases仓库中查看刚刚部署好的构件信息如下所示：

如果部署失败的要检查一下用户是否有部署的权限，目标仓库是否允许部署，是否缺少部署所需的构件。

6.2、手动部署

手动部署构件则更为简单了，在nexus的仓库列表中点击要部署的目标仓库，然后点击Artifact Upload选项卡看到下图所示：

linux安装部署：

1.下载解压

wget http://download.sonatype.com/nexus/3/nexus-3.21.1-01-unix.tar.gz
tar -zxf nexus-3.21.1-01-unix.tar.gz

2.配置
2.1端口及上下文路径

vim nexus/nexus-3.21.1-01/etc/ nexus-default.properties

application-port=8081
application-host=192.168.1.129
nexus-args=${jetty.etc}/jetty.xml,${jetty.etc}/jetty-http.xml,${jetty.etc}/jetty-requestlog.xml
nexus-context-path=/nexus
 
# Nexus section
nexus-edition=nexus-pro-edition
nexus-features=\
nexus-pro-feature

2.2使用root运行

vim nexus/nexus-3.21.1-01/bin/nexus.rc

run_as_user=root #使用root运行

2.3JVM参数

vim nexus/nexus-3.21.1-01/bin/nexus.vmoptions

-Xms256m
-Xmx1024m
-XX:MaxDirectMemorySize=2703m
-XX:+UnlockDiagnosticVMOptions
-XX:+LogVMOutput
-XX:LogFile=../sonatype-work/nexus3/log/jvm.log
-XX:-OmitStackTraceInFastThrow
-Djava.net.preferIPv4Stack=true
-Dkaraf.home=.
-Dkaraf.base=.
-Dkaraf.etc=etc/karaf
-Djava.util.logging.config.file=etc/karaf/java.util.logging.properties
-Dkaraf.data=../sonatype-work/nexus3
-Dkaraf.log=../sonatype-work/nexus3/log
-Djava.io.tmpdir=../sonatype-work/nexus3/tmp
-Dkaraf.startLocalConsole=false
#
# additional vmoptions needed for Java9+
#
# --add-reads=java.xml=java.logging
# --add-exports=java.base/org.apache.karaf.specs.locator=java.xml,ALL-UNNAMED
-Djava.util.logging.config.file=etc/karaf/java.util.logging.properties
-Dkaraf.data=../sonatype-work/nexus3
-Dkaraf.log=../sonatype-work/nexus3/log
-Djava.io.tmpdir=../sonatype-work/nexus3/tmp
-Dkaraf.startLocalConsole=false
#
# additional vmoptions needed for Java9+
#
# --add-reads=java.xml=java.logging
# --add-exports=java.base/org.apache.karaf.specs.locator=java.xml,ALL-UNNAMED
# --patch-module=java.base=lib/endorsed/org.apache.karaf.specs.locator-4.2.6.jar
# --patch-module=java.xml=lib/endorsed/org.apache.karaf.specs.java.xml-4.2.6.jar
# --add-opens=java.base/java.security=ALL-UNNAMED
# --add-opens=java.base/java.net=ALL-UNNAMED
# --add-opens=java.base/java.lang=ALL-UNNAMED
# --add-opens=java.base/java.util=ALL-UNNAMED
# --add-opens=java.naming/javax.naming.spi=ALL-UNNAMED
# --add-opens=java.rmi/sun.rmi.transport.tcp=ALL-UNNAMED
# --add-exports=java.base/sun.net.www.protocol.http=ALL-UNNAMED
# --add-exports=java.base/sun.net.www.protocol.https=ALL-UNNAMED
# --add-exports=java.base/sun.net.www.protocol.jar=ALL-UNNAMED
# --add-exports=jdk.xml.dom/org.w3c.dom.html=ALL-UNNAMED
# --add-exports=jdk.naming.rmi/com.sun.jndi.url.rmi=ALL-UNNAMED
#
# comment out this vmoption when using Java9+
#

2.4修改环境变量

vim /etc/profile

export NEXUS_HOME=/alidata/server/nexus/nexus-3.21.1-01
 
export PATH=$PATH:$NEXUS_HOME/bin
source /etc/profile

2.5设置开机自启动

ln -s /alidata/server/nexus/nexus-3.21.1-01/bin/nexus /etc/init.d/nexus3 
chkconfig --add nexus3 
chkconfig nexus3 on

2.6修改 nexus3 启动时要使用的 jdk 版本

vim /alidata/server/nexus/nexus-3.21.1-01/bin

第 14 行: 
INSTALL4J_JAVA_HOME_OVERRIDE=/alidata/server/jdk1.8.0_152

2.7修改 nexus3 数据以及相关日志的存储位置 (可选):

vim nexus/nexus-3.21.1-01/bin/nexus.vmoptions

-XX:LogFile=./sonatype-work/nexus3/log/jvm.log 
-Dkaraf.data=./sonatype-work/nexus3 
-Djava.io.tmpdir=./sonatype-work/nexus3/tmp

2.8启动

bin/nexus start

2.9服务器开放Nexus私服端口

（1）firewall-cmd --zone=public --add-port=8081/tcp --permanent

（2）阿里云服务器安全组配置

3.nginx代理nexus

server {
    listen 80;
    server_name 域名;
 
    location /nexus {
        proxy_pass http://127.0.0.1:8081;
        proxy_redirect off;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        client_max_body_size 300M;
    }
}

# 重启nginx
./nginx -s reload
4.配置仓库
安装成功后有两个默认账号admin、anonymous，其中admin具有全部权限；anonymous作为匿名用户，只具有查看权限。

pepositories name属性说明

maven-central：maven中央库，默认从https://repo1.maven.org/maven2/拉取jar
maven-releases：私库发行版jar
maven-snapshots：私库快照（调试版本）jar
maven-public：仓库分组，把上面三个仓库组合在一起对外提供服务，在本地maven基础配置settings.xml中使用。
pepositories type属性说明

group(仓库组类型)：又叫组仓库，用于方便开发人员自己设定的仓库
hosted(宿主类型)：内部项目的发布仓库（内部开发人员，发布上去存放的仓库）
proxy(代理类型)：从远程中央仓库中寻找数据的仓库（可以点击对应的仓库的Configuration页签下Remote Storage Location属性的值即被代理的远程仓库的路径）
virtual(虚拟类型)：虚拟仓库（这个基本用不到，重点关注上面三个仓库的使用）
一般，访问我们使用maven-public
http://域名/nexus/repository/maven-public/

由于访问中央仓库有时候会比较慢，这里我添加一个阿里云的代理仓库，然后优先级放到默认中央库之前，阿里云的maven仓库url为http://maven.aliyun.com/nexus/content/groups/public

然后再public组里面讲这个aliyun-proxy仓库加入，排在maven-central之前即可。

创建Blob Stores

文件存储的地方，创建一个目录的话，对应文件系统的一个目录，可供仓库上传文件使用，如图所示：

5. 本地Maven使用私服
在maven的默认配置settings.xml中修改如下：

<servers>
	<server>
        <id>nexus</id>
        <username>admin</username>
        <password>123456</password>
    </server>
</servers>
 
<mirrors>
    <mirror>
        <id>nexus</id>
        <mirrorOf>*</mirrorOf>
        <url>http://域名/nexus/repository/maven-public/</url>
    </mirror>
</mirrors>
 
<profiles>
    <profile>  
      <id>nexus</id>
      <repositories>
        <repository>
          <id>Nexus</id>
          <url>http://域名/nexus/repository/maven-public/</url>
          <releases>
            <enabled>true</enabled>
			<updatePolicy>always</updatePolicy>
          </releases>
          <snapshots>
            <enabled>true</enabled>
            <updatePolicy>always</updatePolicy>
          </snapshots>
        </repository>
      </repositories>
      <activation>
        <activeByDefault>true</activeByDefault>      
        <jdk>1.8</jdk>
      </activation>
      <properties>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
        <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
      </properties>
    </profile>
</profiles>
 
<activeProfiles>
    <activeProfile>nexus</activeProfile>
</activeProfiles>

6.修改工程的pom.xml
如果要发布自己的jar到私服，就需要修改工程的pom.xml，添加如下内容，否则什么都不用做：

<distributionManagement>
    <repository>
        <id>nexus</id>
        <name>Releases</name>
        <url>http://域名/nexus/repository/maven-releases</url>
    </repository>
    <snapshotRepository>
        <id>nexus</id>
        <name>Snapshot</name>
        <url>http://域名/nexus/repository/maven-snapshots</url>
    </snapshotRepository>
</distributionManagement>

注意：上面的repository的id值一定要跟settings.xml文件中配置的server一致。上传到Nexus上，使用 mvn deploy 即可，开发的时候请使用snapshot版本，也就是version的后缀必须是-SNAPSHOT。

仓库类型, nexus最重要的概念

这时候已经搭建好了Nexus，要做操作前先登录，默认用户名admin，默认密码admin123。来看看各个Repository。点击左侧Repositories。

hosted：本地仓库，通常我们会部署自己的构件到这一类型的仓库。比如公司的第二方库。

所有我们自己jar包都在这种类型的仓库中.

proxy：代理仓库，它们被用来代理远程的公共仓库，如maven中央仓库。

如果本地nexus仓库中没有的jar包, 会从代理仓库中取, 就是这个意思, 当然maven中央仓库在nexus中只是代理仓库中的一个, 可以设定多个代理仓库, 比如阿里云, 比较快.

group：仓库组，用来合并多个hosted/proxy仓库。

这个就是检索一组仓库, 取jar包, 这个貌似有缓存的, 我在后面的上传jar包时被坑了n个小时. 就是明明组里有设定其他hosted类型仓库, 就是不去检索那个仓库, 导致我自己上传的jar包在hosted仓库中, 明明有缺不检索, pom一直报错.

下面这张图, copy的作用, 是用来配置文件里粘贴仓库地址的(例如第三方jar上传的路径) 花圈的部分, maven项目发布时. 有一些第三方的jar或者公司的jar, 如果pom.xml里的version是带snapshots的, 会自动发布到maven-snapshots目录(jar名字后会带有时间戳,代表不同快照版本)

下面是配置

pom中配置:

<repositories>
        <repository>
            <id>maven-central</id>
            <name>maven-central</name>
            <url>http://192.168.1.28:8081/repository/maven-central/</url>
            <snapshots>
                <enabled>true</enabled>
            </snapshots>
            <releases>
                <enabled>true</enabled>
            </releases>
        </repository>
    </repositories>

Snapshot包的管理

1.先修改Maven的settings.xml文件，加入认证机制

<servers>
<server>
      <id>nexus</id>
      <username>admin</username>
      <password>admin123</password>
</server>

2.修改工程的Pom文件

<distributionManagement>
        <snapshotRepository>
            <id>nexus</id>
            <name>Nexus Snapshot</name>
            <url>http://192.168.1.28:8081/repository/maven-snapshots/</url>
        </snapshotRepository>
        <site>
            <id>nexus</id>
            <name>Nexus Sites</name>
            <url>dav:http://192.168.1.28:8081/repository/maven-snapshots/</url>
        </site>
    </distributionManagement>

注意事项:
上面修改的Pom文件如截图中的名字要跟/usr/local/maven/conf/settings.xml文件中的名字一定要对应上。

3.上传到Nexus上
先配置POM文件的头部, 根据需要自己配置版本是shapshot

<groupid>com.woasis</groupid>
<artifactid>test-nexus</artifactid>
<version>1.0.0SHAPSHOT</version>
<packaging>jar</packaging>

使用mvn deploy命令运行即可（运行结果在此略过）

最后因为Snapshot是快照版本，默认他每次会把Jar加一个时间戳，做为历史备份版本。

Releases包的管理

与Snapshot大同小异，只是上传到私服上的Jar包不会自动带时间戳

与Snapshot配置不同的地方，就是工程的POM文件，加入repository配置

        <repository>
            <id>nexus</id>
            <name>Nexus Snapshot</name>
            <url>http://192.168.1.28:8081/repository/maven-releases/</url>
        </repository>

发布版记得打包的时候需要把Snapshot去掉

    <groupId>com.woasis</groupId>
    <artifactId>test-nexus</artifactId>
    <version>1.0.0</version>
    <packaging>jar</packaging>

现在就看我目前的配置文件就行, 亲测好使

本地maven库配置settings.xml

<settings>
<!-- 暂不知作用 -->
<pluginGroups>
     <pluginGroup>org.sonatype.plugins</pluginGroup>
</pluginGroups>

<!-- 必填 -->
<servers>
     <server>
          <id>nexus</id>
          <username>admin</username>
          <password>admin123</password>
     </server>
</servers>

<mirrors>
     <mirror> 
          <id>nexus</id>
          <mirrorOf>*</mirrorOf>
          <url>http://localhost:8081/repository/mygroup</url>
     </mirror>
</mirrors>

注意: 这个地址是参照我nexus建的分组地址, 我认为分组检索比较省事, 这样写就是能够让maven直接检索我的分组里的仓库, 把需要检索的仓库都扔里就好了

下图, 把需要的仓库扔仓库组里面

<!-- 这个就是说可以免去每个项目配置发布目录的意思, 但是需要最后activeProfiles激活-->
<profiles>
     <profile>
     <id>nexus</id>
     <repositories>
          <repository>
               <id>central</id>
               <url>http://central</url>
               <releases>
                    <enabled>true</enabled>
               </releases>
               <snapshots>
                    <enabled>true</enabled>
               </snapshots>
          </repository>
     </repositories>

     <pluginRepositories>
          <pluginRepository>
               <id>central</id>
               <url>http://central</url>
               <releases>
                    <enabled>true</enabled>
               </releases>
               <snapshots>
                    <enabled>true</enabled>
               </snapshots>
          </pluginRepository>
     </pluginRepositories>
     </profile>
</profiles>

<activeProfiles>
     <activeProfile>nexus</activeProfile>
</activeProfiles>


</settings>

上传第三方jar到私服

mvn:deploy在整合或者发布环境下执行，将最终版本的包拷贝到远程的repository，使得其他的开发者或者工程可以共享。

以将ojdbc14传到nexus中的thirdparty为例
我的例子: nexus3 中将ojdbc14 传到自己建设的 3rdLibs库中

一、配置settings.xml

因为nexus是需要登陆操作，当然可以通过配置免登陆，这是后话。
在maven的 settings.xml的<servers> </servers>中配置

<server>   
<id>thirdparty</id>   
<username>admin</username>
<password>admin123</password>   
</server>

如果进行deploy时返回Return code is: 401错误，则需要进行用户验证或者你已经验证的信息有误。

二、 cmd输入命令

mvn deploy:deploy-file -DgroupId=com.xy.Oracle -DartifactId=ojdbc14 -Dversion=10.2.0.4.0 -Dpackaging=jar -Dfile=E:\ojdbc14.jar -Durl=http://localhost:9090/nexus-2.2-01/content/repositories/thirdparty/ -DrepositoryId=thirdparty

亲测: 笔记本好使的cmd命令, 我自己传的一个拼音转换jar包

mvn deploy:deploy-file -DgroupId=com.xy.pinyin -DartifactId=pinyin4j -Dversion=2.5.0 -Dpackaging=jar -Dfile=E:\pinyin4j-2.5.0.jar -Durl=http://localhost:8081/repository/3rdLibs/ -DrepositoryId=nexus

DgroupId和DartifactId构成了该jar包在pom.xml的坐标，项目就是依靠这两个属性定位。自己起名字也行。
Dfile表示需要上传的jar包的绝对路径。
Durl私服上仓库的位置，打开nexus——>repositories菜单，可以看到该路径。
DrepositoryId服务器的表示id，在nexus的configuration可以看到。
Dversion表示版本信息，怎样得到一个jar包准确的版本呢？
解压该包，会发现一个叫MANIFEST.MF的文件，这个文件就有描述该包的版本信息。
比如Manifest-Version: 1.0可以知道该包的版本了。

上传成功后，在nexus界面点击3rd party仓库可以看到这包。

三、一些问题

发现问题
在敲击该命令的时候，有时候看到提示需要POM文件，但上传包是不需要pom文件的。

可能原因
最大可能是你语句打错了如多了一个空格和换行，这样语句直接截断到换行前面，cmd就找它可以认识的语句执行，比如直接执行mvn，而mvn是对项目打包，是要pom文件的。

解决办法
耐心把命令重新敲一遍。还有如果是miror中配置了nexus是检索分组的地址, 例如我的配置就是检索一组仓库,那么一定注意,一定要把三方库加入到分组中去