Linux下Nexus私服搭建

发表于 2021-01-13 更新于 2024-10-28 分类于操作系统阅读次数：

本文字数： 1.4k 阅读时长 ≈ 5 分钟

背景

本篇搭建设计到的相关资源如下：

操作系统：CentOS 7.9
JDK: 1.8.0_211
Nexus私服版本：nexus-3.29.2-02

Nexus介绍

Nexus 是Maven仓库管理器，如果我们使用Maven，我们可以从Maven中央仓库下载所需要的构件（artifact），但这通常没有公司这么干，一般都是在本地架设一个Maven仓库服务器，在代理远程仓库的同时维护本地仓库，以节省带宽和时间，Nexus就可以满足这样的需要。此外，它还提供了强大的仓库管理功能，构件搜索功能，它基于REST，友好的UI是一个extjs的REST客户端，它占用较少的内存，基于简单文件系统而非数据库。这些优点使其日趋成为最流行的Maven仓库管理器。
Nexus不是Maven的核心概念，它仅仅是一种衍生出来的特殊的Maven仓库。对于Maven来说，仓库只有两种：本地仓库和远程仓库。

Nexus私服特点

搭建私服后：本地仓库没有，再去私服下载，私服没有，再去中央仓库下载

减少网络带宽流量
加速Maven构建
部署第三方构件
提高稳定性、增强控制
降低中央仓库的负载

准备

搭建过程

部署

[root@microservice ~]# mkdir /usr/local/nexus
[root@microservice ~]# tar zxf nexus-3.29.2-02-unix.tar.gz -C /usr/local/nexus/
# 启动nexus必须使用nexus用户，不可以使用权限过高的用户，比如root，否则会启动失败
[root@microservice ~]# useradd nexus
[root@microservice ~]# chown -R nexus:nexus /usr/local/nexus/
[root@microservice ~]# ls /usr/local/nexus/
nexus-3.29.2-02     # 这是应用目录
sonatype-work         # 这是工作目录，存放镜像仓库
# 运行内存和工作目录nexus-3.29.2-02/bin/nexus.vmoptions （修改对应字段即可）
# 运行监听地址和端口nexus-3.29.2-02/etc/nexus-default.properties
[root@microservice ~]# ln -s /usr/local/nexus/nexus-3.29.2-02/bin/nexus /usr/local/bin/
# 创建命令软连接
# 切换至nexus用户，并启动nexus服务，如果使用root用户，会因为权限过高而启动失败
[root@microservice ~]# su nexus
[nexus@microservice nexus]$ nexus start 
Starting nexus
[nexus@microservice ~]# netstat -anput | grep 8081
tcp        0      0 0.0.0.0:8081            0.0.0.0:*               LISTEN      4687/java

启动nexus之后，在浏览器访问http://ip:8081端口，ip就是你服务器的ip，访问之后，单击页面右上角的Sign in
初次登录会提示一个获取admin用户的默认密码路径，如下图所示：
admin初始密码

按指定的路径，cat即可，获取到初始化admin用户密码之后就可以登录了，登录后会提示重置admin用户密码。
在Configure Anonymous Access时，按需选择，如果允许匿名访问私服，则可以允许，反之选择disable。

创建角色

创建用户

设置自动启动

通过systemctl来进行管理，在/etc/systemd/system目录下见一个名为nexus.service的文件，文件内容如下

[Unit]
Description=Nexus Repository Manager
After=network.target

[Service]
Type=forking

# nexus运行的用户和组
User=nexus
Group=nexus

# 运行环境，nexus运行的依赖项，JAVA_HOME的运行环境
Environment=INSTALL4J_JAVA_HOME=/etc/java/jdk1.8.0_211
ExecStart=/usr/local/bin/nexus start
ExecStop=/usr/local/bin/nexus stop 
Restart=on-failure
# 通过systemd方式来启动服务的，需要加上文件句柄描述，不然会读取默认的systemd配置，导致全局的ulimit设置不生效
LimitNOFILE=65536

[Install]
WantedBy=multi-user.target

设置服务自启动

## 加载新的unit配置文件
sudo systemctl daemon-reload
## 设置允许服务自启动
sudo systemctl enable nexus.service
## 服务启动
sudo systemctl start nexus.service
## 服务停止
sudo systemctl stop nexus.service
## 服务启动状态
sudo systemctl status nexus.service

如果在start过程中遇到问题，systemctl status nexus.service命令查看运行结果，如果还是有问题，通过journalctl -xe查看

设置代理仓库

阿里云仓库的URL：https://maven.aliyun.com/nexus/content/groups/public/

注意事项

file descriptor警告

具体体现在/support/status状态页面的File Descriptors项目可能会显示 Recommended file descriptor limit is 65536 but count is 4096. 警告。
根据提示其实也能猜的出来，就是建议当前运行的私服建议文件句柄到65536。
这里在官网有具体的解释：https://help.sonatype.com/repomanager3/installation/system-requirements#SystemRequirements-AdequateFileHandleLimits
解决办法就是为当前nexus私服运行的用户，如：nexus，指定文件句柄：

1 2	# 使用root权限在/etc/security/limits.conf文件末尾添加： nexus - nofile 65536

修改之后，重新进入运行用户，如：nexus，并重启nexus私服

项目中配置好私服访问地址后报未授权错误（Not authorized）

具体报错如下：
Could not transfer artifact org.apache.curator:curator-recipes:pom:2.11.0 from/to nexus
(http://192.168.198.128:8081/repository/maven-public/): Not authorized

这个原因是因为，在你本地maven配置文件（setting.xml）中mirrors标签只配置了私服的镜像，而在servers标签中配置对应的用户名和密码，要么找不到，要么没有配置
检查如下：

<mirror>
    <id>nexus</id>
    <name>Nexus private</name>
    <mirrorOf>*</mirrorOf>
    <url>http://192.168.198.128:8081/repository/maven-public/</url>
</mirror>

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

解决方案：检查你的配置，是否有确实两个配置中的一个或者是否两个配置中的id是否一致。如果没有配置则配置一下，如果不匹配，则将俩id改成一致
本质就是，通过mirror中的id去寻找server中相同id的用户名和密码，完了去访问私服。
如果配错或者漏配了，自然当前配置的mirror找不到用户名和密码，自然不能访问。（前提默认你私服的配置不允许匿名访问仓库）

背景