2023-11-24

超简单的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

直接打开 http://localhost:4873/

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的错误。

©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容