- 下载 Nexus 服务器安装包
- 安装 Nexus 服务器
- 配置环境变量/启动服务器/停止服务器
- Nexus 服务器管理后台
- 登录管理后台
- Blob Stores
- Nexus 初始密码无法登录的问题
- 仓库（Repository）
- Nexus 内置的仓库
- Repository 的 Type 属性
- 创建代理仓库
- 创建本地仓库（也叫宿主仓库/私有仓库）
- 配置 Nexus 服务器
- Nexus 命令介绍
- 迁移 Nexus 服务器中的数据
- 删除 Nexus 服务器中的数据
- 升级 Nexus
- 部署工件到服务器
- 通过配置文件发布工件到 Nexus 服务器（第一种配置方式）
- 通过配置文件发布工件到 Nexus 服务器（第二种配置方式）
- 通过 Maven 命令发布工件到 Nexus 服务器
- 选择本地工件上传到 Nexus 宿主仓库
- 从 Nexus 服务器自动下载依赖工件
- settings.xml 配置私服
- 配置 profile 元素
- 配置 mirror 元素（镜像仓库配置）
- pom.xml 配置私服
- Nexus 3 和 Nexus 2 的区别
目前的版本有 2.X 和 3.X ，2.X 对 Maven 的支持更友好一点，3.X 的支持范围更广，支持 ruby 和 docker。但是 3.X 要求 JDK 的版本是1.8，而且貌似还需要做特殊配制。有人下载下来解压后，运行不起来，看 sonatype-work 里面的 logs 报的是缺某个 jar 包，所以如果没有别的需要，只是搭建单纯的 Maven 私服，建议直接使用版本 2.x。
官网地址：https://www.sonatype.com/。
我在下面也给出了直接下载的地址：
点击下载 Nexus Repository Manager OSS 3.x /点击下载 Nexus Repository Manager OSS 2.x /点击下载 Nexus Repository 3.x。
通过官网下载 nexus 服务器安装包可能因为网速的问题会导致下载失败，我已经把安装包上传到百度云盘：
链接: https://pan.baidu.com/s/11E8lMR3-j71aUbYeK__Tyg 提取码: e1fd
安装 Nexus 服务器下载安装包后，将其解压到你需要的目录下（例如：用户主目录/Applications/），我就是解压到用户主目录下的 Applications 目录下，如下图所示： 
解压后你可以看到目录 nexus-3.20.1-01-mac，在这个目录下有两个子目录 nexus-3.20.1-01 和 sonatype-work。nexus-3.20.1-01 是程序，sonatype-work 是工作目录，如果以后要备份数据，只要备份 sonatype-work 就行。
在与 nexus-3.20.1-01 目录同级的目录下创建一个指向 /Users/liaowenxiong/Applications/nexus-3.20.1-01-mac/nexus-3.20.1-01 的软链接，以方便日后的升级：
[~/Applications/nexus-3.20.1-01-mac]$ ln -s /Users/liaowenxiong/Applications/nexus-3.20.1-01-mac/nexus-3.20.1-01 /Users/liaowenxiong/Applications/nexus-3.20.1-01-mac/nexus-latest
[~/Applications/nexus-3.20.1-01-mac]$ ls
nexus-3.20.1-01 nexus-latest sonatype-work
在配置有关环境变量之前，要启动 nexus 服务器，你需要打开命令终端，切换到 ~/Applications/nexus-3.20.1-01-mac/nexus-3.20.1-01/bin 目录下，再执行启动命令，如下所示：
[~/Applications/nexus-3.20.1-01-mac/nexus-3.20.1-01/bin]$ ./nexus start
Starting nexus
[~/Applications/nexus-3.20.1-01-mac/nexus-3.20.1-01/bin]$ ./nexus status
nexus is running.
配置环境变量后则不必进入 nexus 的 bin 目录下执行启动命令。下面介绍下如何配置 nexus 的环境变量。
编辑用户主目录下 .bash_profile 文件：
[~/Applications/nexus-3.20.1-01-mac]$ vim ~/.bash_profile
在其中添加如下内容：
# 创建环境变量NEXUS_HOME
export NEXUS_HOME=/Users/liaowenxiong/Applications/nexus-3.20.1-01-mac/nexus-latest
# 在环境变量PATH的值后面追加nexus的bin目录路径
PATH=$PATH:$NEXUS_HOME/bin
执行下面的命令，使 .bash_profile 文件的配置立即生效：
[~/Applications/nexus-3.20.1-01-mac]$ source ~/.bash_profile
因为前面已经配置 nexus 的环境变量，所以可以在任意目录执行 nexus 的命令，例如，我在用户主目录下执行下面的停止服务器的命令：
[~]$ nexus stop
Shutting down nexus
Stopped.
[~]$ nexus start
Starting nexus
nexus 服务器启动后，在浏览器地址栏输入：http://localhost:8081，你可以打开 Nexus Repository 的管理后台的首页。
登录管理后台通过右侧的 Sign In 登录管理后台。对于未登录的用户，只能查询和浏览相关资源。用户登录后就能看到管理相关的菜单了。
早期版本的 Nexus 的管理后台默认登录用户名是 admin，默认登录密码 admin123，最新版的 Nexus 管理后台默认登录密码不再是 admin123，具体参见下面的章节。
Blob Stores 是用来配置资源的保存位置的，可以将不同的资源保存到服务器的不同位置上，类似于 Nexus 2 的资源保存路径。
Nexus 初始密码无法登录的问题之前版本的 nexus 系统管理后台默认的登录用户名和密码是：admin/admin123，新版的 nexus 的管理后台默认登录密码不再是 admin123。初始密码保存在 nexus 安装目录下的 sonatype-work/nexus3/admin.password 文件中，打开文件可以看到如下内容： 
上面的内容即为密码明文，而非加密后的结果，直接复制到密码输入框即可。
登录成功之后会要求修改密码，密码修改成功后，admin.password 文件会自动被删除。
仓库（Repository） Nexus 内置的仓库
上图中的 Format 列：maven2 是Java 仓库；nuget 是 .net 仓库。
Repository 的 Type 有三种：proxy、hosted、group。
proxy：代理仓库。即你可以设置代理远程的仓库，设置了代理之后，在你的 Nexus 仓库中找不到需要的工件就会到代理的远程仓库中查找
hosted：本地仓库。即本地的私有仓库。通常用来存放和管理非中央仓库或者你自己开发的工件包。这仓库有 release 和 snapshots 两种类型，自己在构建工件包的时候，就需要指定 release（正式版/发行版） 还是 snapshots（开发版）。
group：组合仓库。这种类型的仓库可以组合多个仓库，然后用户只要访问这个组合仓库，就可以同时访问被组合的其它成员仓库。一般用来给用户一个访问 Nexus 仓库的统一地址。组合仓库中可以看到成员仓库中的工件资源，但是无权删除。
实际的使用场景通常是这样的，你可以上传私有的工件到 hosted 仓库中，代理仓库中配置被代理的远程仓库的 URL 以获取第三方的依赖（比如可以配置中央仓库的地址）。本地私有仓和代理仓都弄好了之后，再通过 group 仓库进行组合，这样就可以将组合仓库的 URL 对外提供使用了。
总结： Maven 可以直接从宿主仓库（本地私有仓库）下载构件；Maven 也可以从代理仓库下载构件，而代理仓库中若没有请求的构件，则会自动地从被代理的远程仓库下载构件并缓存构件；Maven 可以从组合仓库下载构件，而组合仓库没有请求的构件，组合仓库会转向其包含的宿主仓库或者代理仓库获取请求的构件。
组合仓库的详情界面如下图所示： 
特别注意，组仓库会按从上到下的顺序访问成员仓库。
Repository Name 和 Remote storage 填写好之后，就可以直接点击下方的 Create repository 创建仓库了。 
代理仓库创建好之后就可以复制仓库的 URL，在 settings.xml 或者项目的 pom.xml 中进行私服仓库的配置，具体请参见下面的章节。
打开 /Users/liaowenxiong/Applications/nexus-3.20.1-01-mac/nexus-3.20.1-01/etc 目录下的属性文件 nexus-default.properties，打开后默认的内容如下：
## DO NOT EDIT - CUSTOMIZATIONS BELONG IN $data-dir/etc/nexus.properties
##
# Jetty section
application-port=8081
application-host=0.0.0.0
nexus-args=${jetty.etc}/jetty.xml,${jetty.etc}/jetty-http.xml,${jetty.etc}/jetty-requestlog.xml
nexus-context-path=/
# Nexus section
nexus-edition=nexus-pro-edition
nexus-features=\
nexus-pro-feature
nexus.hazelcast.discovery.isEnabled=true
application-host：是 nexus 服务器的 IP 地址，默认为 0.0.0.0，表示只要是本机上的 IP，就能连上 nexus 服务器。为了安全和屏蔽掉其他IP，建议改成 localhost 默认指向的 IP，即 127.0.0.1。
application-port：是 IP 的端口号，默认为 8081，如果端口号被占用，可以换成其他端口号。
nexus-context-path：上下文路径，默认 /，类似 Java Web 项目的虚拟目录，如果添加上下文路径，需要在访问地址后面加上下文路径，即访问地址变为：application-host:application-port/nexus-context-path。
配置后的内容如下：
## DO NOT EDIT - CUSTOMIZATIONS BELONG IN $data-dir/etc/nexus.properties
##
# Jetty section
application-port=8081
application-host=127.0.0.1
nexus-args=${jetty.etc}/jetty.xml,${jetty.etc}/jetty-http.xml,${jetty.etc}/jetty-requestlog.xml
nexus-context-path=/nexus/content # http://127.0.0.1:8081/nexus/content
# Nexus section
nexus-edition=nexus-pro-edition
nexus-features=\
nexus-pro-feature
nexus.hazelcast.discovery.isEnabled=true
配置好之后需要重启 nexus：
[/etc]$ nexus restart
Shutting down nexus
Stopped.
Restarting nexus
然后在浏览器地址栏输入：http://localhost:8081/nexus/content/
Nexus 命令介绍nexus start nexus stop nexus status nexus restart nexus run nexus run-redirect nexus force-reload
迁移 Nexus 服务器中的数据将 sonatype-work/nexus3 迁移到其它地方
删除 Nexus 服务器中的数据sonatype-work/nexus3 整个目录删除，以前缓存的数据就全部删除了。
接着你可以重启 Nexus，等几秒钟，再输入之前的访问地址，nexus3 目录又会自动重新生成，之前的登录密码作废了，你需要再重新打开 sonatype-work/nexus3/admin.password 文件，将里面的密码粘贴到密码输入框即可完成登录。
升级 Nexus下载最新版的 nexus 包，解压后仅保留 nexus-3.{new-version} 目录，并移动到 /Users/liaowenxiong/Applications/nexus-3.20.1-01-mac 目录下，然后重新创建软链接 nexus-latest，指向新版本的 nexus 目录即可：
$ cd /Users/liaowenxiong/Applications/nexus-3.20.1-01-mac
$ rm nexus-latest
$ ln -s /Users/liaowenxiong/Applications/nexus-3.20.1-01-mac/nexus-3.{new-version} /Users/liaowenxiong/Applications/nexus-3.20.1-01-mac/nexus-latest
以上升级方法适用于从 nexus-3.1.0+ 升级到 nexus3 的最新版本，官方文档为：《Upgrading Nexus Repository Manager 3.1.0 and Newer》
部署工件到服务器 通过配置文件发布工件到 Nexus 服务器（第一种配置方式）第一步：配置 settings.xml 在 settings.xml 配置 nexus 服务器的登录用户名和密码，以及连接的仓库名称。
release
admin
123456
snapshot
admin
123456
第二步：在项目的 pom.xml 文件中配置仓库的名称和访问地址
直接在 project 根节点的 distributionManagement 子节点中配置如下：
release
http://localhost:8081/nexus/content/repository/maven-releases/
snapshot
http://localhost:8081/nexus/content/repository/maven-snapshots
问题：代理仓库和组仓库能否部署工件呢？没有测试过！有时间再测试。
第三步：将项目打成指定格式的包，发布到仓库中
项目的 pom.xml 文件中可以指定项目的打包格式，如下图所示： 
第一步：在 settings.xml 文件中配置
...
lan
admin
admin123
lan
http://localhost:8081/repository/maven-releases
http://localhost:8081/repository/maven-snapshots
第二步：在 pom.xml 中配置部署（即上传，upload）工件的目标仓库
lan
lan
${lan-release-url}
lan
${lan-snapshot-url}
org.apache.maven.plugins
maven-source-plugin
org.apache.maven.plugins
maven-javadoc-plugin
第三步：命令行执行 mvn clean deploy -P lan 即可将项目打包发布到 nexus 私服，命令中的 lan 是 pom.xml 文件中的 profile 的 ID 值。
第一步：配置 settings.xml 在 settings.xml 配置 nexus 服务器的登录用户名和密码，以及连接的仓库名称。
maven-snapshots
admin
123456
第二步：在 IDEA 的 Maven 命令输入框执行部署命令
将下面的命令语句填写到 Maven 输入框中：
deploy:deploy-file -DgroupId=com.example -DartifactId=demo02 -Dversion=1.0-SNAPSHOT -Dpackaging=jar -Dfile=/Users/liaowenxiong/Documents/IdeaProjects/demo02/target/demo02-1.0-SNAPSHOT.war -Durl=http://localhost:8081/nexus/content/repository/maven-snapshots/ -DrepositoryId=maven-snapshots
输入完命令语句，按回车键会执行命令语句。执行完成后，你再到 Nexus 服务器的管理后台查看是否发布成功，如下图所示：
选项说明：
DgroupId 和 DartifactId 构成了该 jar 包在 pom.xml 的坐标，项目就是依靠这两个属性定位。可以在项目的 pom.xml 文件中查看，如下图所示： 
Dfile 表示需要上传的工件的绝对路径。
Durl 私服上仓库的位置，可以在 Nexus 服务器的管理后台查看仓库的 URL，如下图所示： 
DrepositoryId 就是服务器的名称。
Dversion 工件的版本信息。在项目的 pom.xml 中可以看到。
选择本地工件上传到 Nexus 宿主仓库
如果通过包名和jar文件名来确定工件的坐标？
如上的 jar 文件，按 Maven 工件的命名规则，应该是 artifactId+version，解压 jar 文件，看下图： 
所以上面的 c3p0-0.9.5.2.jar 的坐标是：
groupId=com.mchange.v2
artifactId=c3p0
version=0.9.5.2
无论是自己安装 Maven，还是 IDEA 自带的 Maven 默认是没有配置仓库信息，这种情况下 Maven 默认去远程的中心仓库下载所依赖的工件（也叫构件）。如果希望从自己搭建的私服下载依赖的工件，就需要明确告诉 Maven 去哪里下载，可以在三个地方进行配置，分别是：
1.Maven 的安装目录下的 conf 目录下的 settings.xml 文件，这个全局配置；
2.再一个是在 ~/.m2 目录下的 settings.xml，如果不存在该文件，可以复制 conf 目录下的 settings.xml，这个是针对当前用户的；
3.还有一个是在 pom.xml 中指定，这个只对 pom.xml 所属的项目有效。
以上三个文件的优先级是 pom.xml > ~/.m2/settings.xml > conf/settings.xml。
配置好私服的仓库信息后，当项目执行 Maven 操作时，如果本地库中没有依赖的构件，Maven 会去指定的私服仓库下载，如果指定的私服仓库也没有，私服仓库会去指定的远程仓库下载（注：私服仓库是 proxy 类型才会到指定的远程仓库下载），下载的构件会缓存在私服仓库中，这样当其它项目需要使用这些构件时，私服仓库就可以直接提供下载了。
settings.xml 配置私服如果在 settings.xml 中设置了其它的镜像仓库，需要将其注释掉，我们自己配置的私服仓库才会生效。
配置 profile 元素在 profiles 标签体中添加下面的元素：
nexus
nexus
local private nexus
http://localhost:8081/nexus/content/repository/maven-public/
true
false
nexus-snapshots
local private nexus
http://localhost:8081/nexus/content/repository/maven-snapshots/
false
true
nexus
local private nexus
http://localhost:8081/nexus/content/repository/maven-public/
true
false
nexus-snapshots
local private nexus
http://localhost:8081/nexus/content/repository/maven-snapshots/
false
true
上述的元素 id、name 可以根据自己的喜好来定义，保证 id 不重复即可，主要是仓库的 url 的配置，不要写错了，仓库的 url 可以在 nexus 服务器管理后台的 repositories 列表直接复制，如下图所示： 
仓库中主要存放两种类型的构件，第一种构件被用作其它构件的依赖，这是中央仓库中存储的大部分构件的类型；另外一种构件类型是插件。如果不配置 pluginRepositories，那么 Maven 在下载项目所需的依赖构件时，还是会直接去远程中央仓库下载需要的插件构件，所以这里一定要加上这个。
另外还要在 activeProfiles 标签体中添加下面的元素：
nexus
activeProfile 标签体中的内容就上面定义 profile 的 id。表示激活指定 id 的 profile。
还可以在 mirrors 标签体中添加 mirror 元素来配置私服。
private nexus
central
private proxy nexus repository
http://localhost:8081/nexus/content/repository/maven-aliyun/
关于 mirror 元素的配置另请参见：https://maven.apache.org/guides/mini/guide-mirror-settings.html
pom.xml 配置私服
nexus
local private nexus
http://192.168.1.68:8081/nexus/content/groups/public
true
false
nexus-snapshots
local private nexus
http://192.168.1.68:8081/nexus/content/groups/public-snapshots
false
true
nexus
local private nexus
http://192.168.1.68:8081/nexus/content/groups/public
true
false
nexus-snapshots
local private nexus
http://192.168.1.68:8081/nexus/content/groups/public-snapshots
false
true
pom.xml 文件中简单配置如下：
maven-aliyun
local private nexus
http://localhost:8081/nexus/content/repository/maven-aliyun/
Nexus 2 能够下载远程仓库资源的索引到 Nexus 服务器本地，供搜索查询使用，但是 Nexus 3 暂时还不支持。在 Nexus 3 中查询的都是已经从远程仓库下载并缓存到服务器本地的资源，对于远程仓库中没有缓存到 Nexus 本地的资源是无法查询到的。所以在 Nexus 3 搭建好后若没有被访问过，那么在 Nexus 的代理仓库是查询不到任何资源的。对于代理仓库而言，需要程序先访问 Nexus 代理仓库，然后由仓库向被代理的远程仓库发起请求，下载对应的资源并缓存到代理仓库中，然后各个项目客户端再从 Nexus 代理仓请求下载依赖的资源。
所以对于 Nexus 代理仓中没有的资源，必须项目客户端先发起请求，然后 Nexus 仓库才会去代理的远程中央仓库下载资源缓存到代理仓库中，以供其它用户直接下载使用。
