本地私服仓库nexus3.3.1使用手册

私服架构

私服是指私有服务器，是架设在局域网的一种特殊的远程仓库，目的是代理远程仓库及部署第三方构建。有了私服之后，当 Maven 需要下载构件时，直接请求私服，私服上存在则下载到本地仓库；否则，私服请求外部的远程仓库，将构件下载到私服，再提供给本地仓库下载。

软件环境

Nexus3.3.1、maven3.5.0、JDK1.8

Maven和JDK的环境配置略，自行百度。

Nexus3安装

下载：wget https://sonatype-download.global.ssl.fastly.net/nexus/3/nexus-3.3.1-01-unix.tar.gz

解压：tar -xvf nexus-3.3.1-01-unix.tar.gz nexus

配置： vi nexus/nexus-3.3.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

vi nexus/nexus-3.3.1-01/bin/nexus.rc

run_as_user=root #使用root运行

vi nexus/nexus-3.3.1-01/bin/nexus.vmoptions

-Xms1200M
-Xmx1200M
-XX:MaxDirectMemorySize=2G
-XX:+UnlockDiagnosticVMOptions
-XX:+UnsyncloadClass
-XX:+LogVMOutput 
-XX:LogFile=../sonatype-work/nexus3/log/jvm.log
-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
-Djava.io.tmpdir=../sonatype-work/nexus3/tmp
-Dkaraf.startLocalConsole=false

启动：Nexus start

访问地址：http://192.168.1.129:8081/nexus

配置仓库

私服仓库

安装成功后有两个默认账号admin、anonymous，其中admin具有全部权限默认密码admin123；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://192.168.1.129:8081/nexus/repository/maven-public/

本地仓库

自行安装Maven，此处略过，修改settings.xml相关配置。

修改本地仓库路径：

 <!--自定义路径-->
<localRepository>E:\MavenPro\vQuantor</localRepository>

Servers中添加以下验证：

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

Mirrors中添加仓库地址：

<mirror>
      <id>nexus</id>
      <mirrorOf>*</mirrorOf>
      <url>http://192.168.1.129:8081/nexus/repository/maven-public/</url>
</mirror>

第三方Jar上传到Nexus

mvn deploy:deploy-file -DgroupId=com.alibaba -DartifactId=dubbo -Dversion=2.8.4 -Dpackaging=jar -DrepositoryId=nexus -Dfile=D:\dubbo-2.8.4.jar -Durl=http://192.168.1.129:8081/nexus/repository/maven-releases

Maven 如果报错(都没问题)

右键 Maven-update project

上传第三方插件

发布到私服仓库

如何上传至内网私服？比如Dubbox，Maven中央仓库或者阿里云的库都是不存在的，还有就是公司内部的一些插件，总不能开放出去吧？

这个问题，也是花了不少的时间研究。nexus3版本以后，突然就没了第三方jar上传入口，也是醉了，这么好的功能居然被阉割了。抱着试试看的态度，搜遍了互联网，然并卵，只有一下命令可以解决。

以下是windows下bat命令脚本，以dubbxo为例

@TITLE   第三方JAR包上传 BY 科帮网

call mvn deploy:deploy-file^
 -DgroupId=com.alibaba^
 -DartifactId=dubbo^
 -Dversion=2.8.4^
 -Dpackaging=jar^
 -DgeneratePom=true^
 -DrepositoryId=nexus^
 -Dfile=D:\maven\dubbo-2.8.4.jar^
 -Durl=http://192.168.1.129:8081/nexus/repository/maven-releases

@pause

脚本中call的意思是，执行完毕后不要关闭窗口，对于失败信息，我们可以进行检查；

^符号是为了命令换行用的，如果不加命令会依次执行，导致无法正常执行；Durl就是私服仓库地址(发布版)。

参数file表示需要安装的第三方jar包在本地的路径；

参数groupId用于定义该jar包安装后的groupId；

参数artifactId用于定义该jar包安装后的artifactId；

参数version用于定义该jar包安装后的版本；

参数packaging用于定义该jar包安装后的打包类型。

比如，以上脚本我可以把D:mavendubbo-2.8.4.jar上传到远程私服仓库。

之后我们在Maven项目中我们就可以根据定义好的groupId、artifactId、version和packaging类型来添加这里定义好的dubbo-2.8.4.ja的引用了。

发布到本地仓库

脚本如下：

@TITLE   第三方JAR包上传 BY 科帮网

call mvn install:install-file^
 -DgroupId=com.alibaba^
 -DartifactId=dubbo^
 -Dversion=2.8.4^
 -Dpackaging=jar^
 -DgeneratePom=true^
 -DrepositoryId=nexus^
 -Dfile=D:\maven\dubbo-2.8.4.jar^

@pause

修改admin密码

日了狗了真是，可能我英文不好，也许是UI看不懂，修改密码竟然在这里：

首先输入正确原始密码，然后输入两次新密码即可。

定义角色用户

由于admin用户拥有Nexus的全部权限，不可能开放给所有人。所以就需要新增一个可以浏览仓库内容、搜索、上传部署构件，但是不能对Nexus进行任何配置的角色。

定义角色:

定义用户：

Maven项目打包

生成war包

mvn clean package   -Dmaven.test.skip=true -Dmaven.javadoc.skip=true

生成jar包

mvn  jar:jar -Dmaven.test.skip=true -Dmaven.javadoc.skip=true

在使用eclipse时候，项目初始导入，一定不要提交target / .project /.classpath /.settings等与代码无关的文件。

如果是同步项目，开发中不要提交以上无关代码。

如果已经提交到SVN了，再忽略是不会起作用的。

解决办法：

window-->preferences-->team-->Ignored Resource-->Add Pattern-->新建一个把以上忽略掉即可-->ok。

扩展阅读

Nexus介绍

Nexus是一个强大的Maven仓库管理器，它极大地简化了本地内部仓库的维护和外部仓库的访问。

如果使用了公共的Maven仓库服务器，可以从Maven中央仓库下载所需要的构件（Artifact），但这通常不是一个好的做法。

正常做法是在本地架设一个Maven仓库服务器，即利用Nexus私服可以只在一个地方就能够完全控制访问和部署在你所维护仓库中的每个Artifact。

• Nexus在代理远程仓库的同时维护本地仓库，以降低中央仓库的负荷,节省外网带宽和时间，Nexus私服就可以满足这样的需要。
• Nexus是一套“开箱即用”的系统不需要数据库，它使用文件系统加Lucene来组织数据。
• Nexus使用ExtJS来开发界面，利用Restlet来提供完整的REST APIs，通过m2eclipse与Eclipse集成使用。
• Nexus支持WebDAV与LDAP安全身份认证。
• Nexus还提供了强大的仓库管理功能，构件搜索功能，它基于REST，友好的UI是一个extjs的REST客户端，它占用较少的内存，基于简单文件系统而非数据库。

为什么要构建Nexus私服？

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

在本地构建nexus私服的好处

1）加速构建；
2）节省带宽；
3）节省中央maven仓库的带宽；
4）稳定（应付一旦中央服务器出问题的情况）；
5）控制和审计；
6）能够部署第三方构件；
7）可以建立本地内部仓库；
8）可以建立公共仓库
这些优点使得Nexus日趋成为最流行的Maven仓库管理器。