超简单的npm私有库搭建——verdaccio
目的
在内网中搭建npm私有库,里面只放项目需要的包,并不需要同步npm上面所有的包
可以发布自己的包
通过上网查找,选型,最终选定了verdaccio来搭建,因为可以不用自己搞数据库,而且很方便,不需要搞麻烦的配置就可以搭建成功。
介绍
Verdaccio是一个简单的,零配置所需的本地私有npm注册表。不需要整个数据库就可以开始使用!Verdaccio开箱即用,拥有自己的小型数据库,能够代理其他注册表(例如npmjs.org),一路缓存下载的模块。
前期准备
一个可以上互联网的电脑
npm(我搭建的时候用的Node版本是14.12.0,npm版本是6.4.1)
nrm(非必须,但是有了这个会省事儿很多)
pm2(非必需,这篇文章里面没有涉及,可以在参考文章的第二篇文章里面找到)
搭建过程
1 安装verdaccio
$ npm install --global verdaccio 我当前用的版本是verdaccio 3.8.6
1.1 verdaccio目录结构
安装后的文件在:C:\Users\(用户名)\AppData\Roaming\verdaccio下
1.2 配置文件
#设置NPM包的存放目录
storage: ./storage
#配置WEB UI界面
web :
title : ‘搭建私有NPM’
#logo : logo.png
#设置用户验证的文件。
auth:
htpasswd:
file: ./htpasswd
max_users: 1000 #默认为1000,改为-1,禁止注册
#设置其它的npm注册源(registry)
uplinks:
npmjs:
url: https://registry.npmjs.org/
#配置权限管理
packages:
‘@/’:
#表示哪一类用户可以对匹配的项目进行安装 【$all 表示所有人都可以执行对应的操作,$authenticated 表示只有通过验证的人可以执行对应操作,$anonymous 表示只有匿名者可以进行对应操作(通常无用)】
access: $all
#表示哪一类用户可以对匹配的项目进行发布
publish: $authenticated
‘*’:
#表示哪一类用户可以对匹配的项目进行安装
access: $all
#表示哪一类用户可以对匹配的项目进行发布
publish: $authenticated
# 如果一个npm包不存在,它会去询问设置的代理。
proxy: npmjs
#日志输出设置
logs:
-{type: stdout, format: pretty, level: http}
#-{type: file, path: verdaccio.log, level: info}
#修改监听的端口
listen: 0.0.0.0:4873
修改完了配置,到verdaccio目录下通过$ verdaccio -c config.yaml更新一下
2 启动
$ verdaccio
3 创建用户
$ npm adduser --registry http://localhost:4873 然后我们在http://localhost:4873/上面直接点Login就可以登陆了
这里,如果我们已经装了nrm ,可以简便上面这句操作:我们直接利用nrm把镜像源切换到我们的http://localhost:4873/上面,然后$ npm adduser就可以了
nrm操作方法
$ npm install -g nrm 全局安装nrm
$ nrm ls 用来查看npm源
名称前有* 的是当前用npm下载包的时候的地址,比如截图里面,当我npm install以后,就会从http://localhost:4873/上面下载包,而不是从npm网站上面下载
$ nrm use 源名称 设置当前npm源
这里我就把npm源换成了npmjs,当然咱们安装node以后,npm默认就是从这里下载。
$ nrm add 名称 地址 创建新的源
$ nrm del 名称 删除源
这些记不住都没关系,直接$ nrm全都可以查看
4 发布包
$ npm publish --registry http://localhost:4873 这里我随便新建一个文件夹,通过npm init新建一个项目,然后在这个目录下,npm publish --registry http://localhost:4873
此时,文件里面有了package.json
5 同步项目所需要的包到verdaccio中
一直写到这里,这一步才是我最想要的,因为我的目的就是为了把我需要用到的包放到内网,直接从内网下载。 我们如何把包放到搭好的verdaccio里面呢?这里我画了一个简单的流程
流程也许不对,我也不知道没有对应的包是从uplinks上面下载到storage里面,再从storage下载到项目中,还是从uplinks下载到项目中,同时也下载到storage里面。 不管是那种方式,总之就是verdaccio里面没有对应的包的话,就会找到uplinks,然后从uplinks对应的网站下载一份到verdaccio里面,以后再下载同样的包的话,verdaccio里面有就直接从verdaccio里面下载,而不会去从uplinks里面再下载了。
刚才我们已经npm init了一个新项目了。我们把package.json里面写上我们需要的包,下载看一下。
我们可以看到下载包的情况 不成功的话,会有500错误
完成以后,我们会看见storage里面我们需要的包都下好了。
node-sass的坑:
node-sass我用4.10.0的话,会报关于python.exe的错误,然后就失败了,我把package.json里面"node-sass":"^4.9.3" 改成了"node-sass":"4.9.3",只用4.9.3版本就好了; 部署到内网以后,4.9.3还是出了问题,它回去npmjs.org上面找win32-x64-57\binding.node,解决方法是从有外网的电脑里面把C:\Users\Acer\AppData\Roaming\npm-cache\node-sass\4.9.3里的win32-x64-57_binding.node拷出来,放到需要npm install的电脑里面,然后新建系统变量SASS_BINARY_PATH,变量值C:\Users(用用户名)\AppData\Roaming\npm-cache\node-sass\4.7.2\win32-x64-59_binding.node,再从服务器npm install下载node-sass包就好了。
然后大家可以把网断掉,删掉node_modules重新下载一次。 下载之前记得$ npm cache clear -f清一下npm缓存再下载啊!!!!!!!!!!!!!!!!!
把vardaccio放到内网
放到内网的话,就把verdaccio这些东西都拷进去把~ 大功告成~
注意:要放到内网的话,下载包的时候一定要先$ npm cache clear -f清一下npm缓存在下!!!!!!!!!不然很可能storage里面的包不全,会报error: internal erver error和 uplink is offline的错误。