使用verdaccio搭建公司npm私有库完整流程和踩坑记录

一. verdaccio介绍

官方的话介绍是verdaccio是一个简单的、零配置本地私有npm软件包代理注册表。

简单来说就是在我们自己的服务器上面搭建一个npm仓库，可以发布npm包上去，在项目中npm i安装依赖时会根据配置文件，优先去verdaccio私有库中查找依赖包，如果找到就下载下来，没有就从公共npm包仓库中下载。

搭建npm私有库的方案还有其他几种，有付费的，也有免费的，verdaccio就是其中的一个免费的，在经过调研和网上查阅文章后，最后决定使用verdaccio，免费，环境搭建简单，管理方便。

三. 安装verdaccio环境

3.1 所需环境

verdaccio在window,mac,liunx系统上都支持搭建使用，本文采用的liunx系统来搭建，window和mac系统搭建流程是一样的，只是verdaccio安装所在的目录不一样，其他都是一样的。

verdaccio有多种安装方式，最简单的可以通过npm命令来安装，所以需要有node环境，其他的辅助环境，后面用到了再介绍，也支持docker搭建。

3.2 开始安装

使用npm全局安装verdaccio

sudo npmiverdaccio -g

安装成功后可以先直接运行verdaccio命令启动

verdaccio

出现上图后，代表已经启动成功了，

配置文件的目录：/Users/guojiongwei/.config/verdaccio/config.yaml(按自己的实际目录)

服务所在的地址：http://localhost:4873/

打开http://localhost:4873/，可以看到私服已经启动好了。

但是此时会有两个问题

第一个问题

直接verdaccio启动，会占用命令行进程，没有办法执行其他命令，这时候可以用pm2来启动和守护进程，如果没有安装pm2，可以执行npm i pm2 -g安装，然后使用pm2启动verdaccio

pm2 start verdaccio

第二个问题

可以看到verdaccio默认地址是http://localhost:4873，只能本机访问到，要想在其他电脑上访问到，需要调整一下服务的地址

配置config.yam文件，其位置在启动成功的日志中可以看到

vi /Users/guojiongwei/.config/verdaccio/config.yaml （需要改成自己的配置文件地址）

找到listen所在配置项

根据注释可以看到listen的值默认为localhost:4873，如果项所有地址都可以访问到，需要修改成0.0.0.0:4873，注意缩进，listen前面不需要有缩进。

配置好后pm2 restart verdaccio重启服务,随后pm2 logs verdaccio查看启动日志

pm2 restart verdaccio 

pm2 logs verdaccio

可以看到地址已经变成了http://0.0.0.0:4873,其他电脑就也已经可以访问到了。

此时verdaccio环境就已经安装完成，可以进行使用了。

四. 发布包到verdaccio私有库

4.1 创建verdaccio用户

看刚才启动好的verdaccio可视化页面页面http://localhost:4873

提示让先添加用户，按照它的命令提示，进行添加用户操作

npm adduser --registry http://localhost:4873/

输入命令后会提示让输入账号密码和邮箱，输入完成后就自动登录了，此时就可以发布npm包到verdaccio私有库了。

npm publish --registry http://localhost:4873/

发布成功后，打开verdaccio可视化管理页面http://localhost:4873/，就可以看到刚发布的包了。