npm nexus 私服搭建使用(本地)

前言：一个公司的每个项目可能多多少少会有一些公用的内容，模块组件等，而随着项目的增多，我们需要更多的引用这些组件，如果这些组件都是以复制粘贴的形式引入到各个项目中，当组件需要更新的时候每个项目都需要拷贝一份最新的代码，这样无疑浪费了大量的精力和时间，我们知道npm可以安装各个开发者提供的组件模块框架等，我们同样可以这么做，每新建一个项目如果需要统一的库的话，我们就可以通过npm install xxx使用公司自己的xxx库，而可以这么做的前提就是nexus的使用

一.下载&运行nexus

官网可能下载有点慢，贴出网盘的nexus压缩包
链接：https://pan.baidu.com/s/1EoaesjSZDKdLflCVlN_dOg
提取码：52jc

1.解压nexus

解压后可得到两个文件夹

image.png
打开nexus-3.34.1-01目录，再打开其下的bin目录，可以看到nexus.exe应用。

2.运行

此时不需要双击打开，在命令行中运行

nexus.exe /run

注：安装目录不要出现中文，否则可能运行错误

直至命令行出现以下内容

image.png

即可表示已成功运行

3.启动

启动后默认的地址是：http://localhost:8081
如果打开之后不是nexus配置页面或者无法打开可能是端口已被占用。lib的同级目录etc中的nexus-default.properties文件可以配置端口。或者可以通过命令行杀死当前占用端口的程序。

image.png

以上全部操作无误后即可打开http://localhost:8081/

二.初始配置

1.登录

初次进入nexus会要求用户登录，如图，默认账户为admin,初始密码会保存在下方图片中提示的目录。

image.png
打开上图描述目录的文件admin.password，拷贝密码，admin 登录的时候，就输入该密码即可（原样复制粘贴即可）；登录后，会提示让你修改密码。
image.png
修改完成后，上述的admin.password 文件就会被自动删除。
注：新密码请牢记，如果忘记密码，后续操作比较麻烦
登录且修改密码之后，整个界面会是这样
image.png

2.新建用户

可以优先在下方界面中点击Create local user按钮新建一个用户，用来对后期的权限做测试。

image.png
点击添加按钮后进入如下页面
image.png
image.png
填写完毕之后即可点击下方Create local user 按钮添加用户.

三.建仓

创建仓库按钮如图

image.png

我们需要建立的是npm仓库，因此选择以下三种，点击即可进入添加仓库页

image.png

1.创建hosted仓库类型

npm (hosted)仓库类型,私有仓库，登录以及包的上传都是使用此仓库。部署无法从公共仓库获取的构件以及自己或第三方的项目构件。
填写仓库名称后，点击当前页面下方的Create repository按钮添加仓库即可

image.png

2.创建proxy仓库类型

代理仓库去下载第三方依赖，代理公共的远程仓库

除了填写仓库名以外，proxy需要填写公共仓库的地址，
也就是在为项目npm install 的时候，如果本地没有的库则会去配置的公共仓库下载。
一般填写默认镜像地址：https://registry.npmjs.org
或
淘宝镜像地址：http://registry.npm.taobao.org/

image.png

3.创建group类型仓库

对外暴露的仓库地址。
Nexus 通过仓库组统一管理多个仓库，这样我们在项目中直接请求仓库组即可请求到仓库组管理的多个仓库。简单的说，就是你可以上传私有的项目到hosted，以及配置proxy以获取第三方的依赖（比如可以配置中央仓库的地址）。前面两个都弄好了之后，在通过group聚合给客户提供统一的访问地址。所有下载的库都是从group中获取的
创建group仓库的时候会有如下配置

image.png
将新建的两个仓库拖动至右侧红色窗口，也就是group管理的库就是这两个。
以上，三个仓库就新建好了，点击图中copy按钮即可拷贝对应仓库的地址，下面的步骤中将会使用到这些地址
image.png

四. npm相关命令

在仓库的使用中可能需要部分npm命令需要掌握。贴出部分个人使用频率较高的命令。
npm config get registry--查看本地的npm仓库镜像地址，也就是下载的第三方库来自哪里，一般都是默认的npm仓库
npm config set registry [your_npm_url]设置本地的npm源地址，在group仓库建好之后建议直接复制group仓库的地址并设置为使用group仓库的地址，例如以下是我本地的仓库地址

npm config set registry http://localhost:9592/repository/npm-group2/

npm whoami--查看当前登录的用户
npm adduser --registry=[your_npm_url]--登录/注册用户，但建议如上述手动添加用户
npm login --registry=[your_npm_url] --用户登录
npm publish --上传库

五.上传自己的库

1.配置权限

image.png

2.直接执行命令：

复制你的hosted仓库地址到下面的括号内，命令不需要括号。
npm config set registry [your_hosted_npmurl]

3.新建一个库

新建一个目录，创建index.js,代码，随便写

module.exports=123

命令行npm init -y生成一个package文件
就是一个简单的库了。
在该目录下先运行命令npm config get registry
确认当前的npm库是自己新建的库。

4.上传

执行npm publish命令
这一步容易出现很多问题，大部分是账号登录的问题和权限的问题。
首先先确认账号的问题，执行npm whoami
如果正常登录的状态会打印出你登录的用户名，没有登陆的话会出现各种各样的error，可以使用npm login --registry="[your_npm_url]"再次登录账号。只要能打印出用户名就不是登录的问题。
其次可能是权限的问题，确保这个环节的第一步权限配置已执行再确认当前登录的账号在nexus用户配置页是否配置了有关权限。（大致就是给当前的用户分配了什么样的角色，给这个角色又分配了什么样的权限，这个用户是否有被激活禁用等，新建的仓库一般不会出现这样的问题）
最后如果确认没问题了
可以尝试执行npm publish --registry="[your_npm_url]"
将你的hosted仓库地址复制到中括号内，此时便会上传成功
提示+xxx@1.0.0,这时候去查看hosted仓库内容
即可发现刚刚的包已经成功上传上去了

image.png
点击tgz文件，可以在右侧查看使用npm安装的命令
image.png

六.补充

在任意项目根目录中新建一个.npmrc文件
作用可查看这个文章
以及在任意项目中使用npm install的时候，默认就会从我们的仓库取包，如果仓库没有的包便从proxy中设置的代理仓库取包，之后便会缓存到我们的group仓库，在下次npm同一个包的时候速度就会更快以及可以节约网络占用。

再次关于仓库的简单的补充说明

npm(proxy): 可配置代理的仓库，当此仓库没有相应包时 会从配置的第三方仓库拉取 并缓存到本地proxy仓库

npm(hosted)：开发自己的包推送到此仓库，需登录才能推送

npm(group)： 可配置包含上面两种仓库，这样用户只需要配置npm(group) 这个地址即可 ，避免配置npm(proxy) 和npm(hosted) 两个地址