记录windows环境下用verdaccio搭建npm私有库

目的

• 在内网中搭建npm私有库，里面只放项目需要的包，并不需要同步npm上面所有的包
• 可以发布自己的包

通过上网查找，选型，最终选定了verdaccio来搭建，因为可以不用自己搞数据库，而且很方便，不需要搞麻烦的配置就可以搭建成功。

介绍

Verdaccio是一个简单的，零配置所需的本地私有npm注册表。不需要整个数据库就可以开始使用！Verdaccio开箱即用，拥有自己的小型数据库，能够代理其他注册表（例如npmjs.org），一路缓存下载的模块。

前期准备

• 一个可以上互联网的电脑
• npm（我搭建的时候用的Node版本是8.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这些东西都拷进去把~
大功告成~

参考文档

verdaccio官网
npm 私服工具verdaccio 搭建(一) （ps:欲使用sinopia搭建私服的一定要看过来）
npm 私服工具verdaccio 搭建(二) （ps:欲使用sinopia搭建私服的一定要看过来）
npm私服工具verdaccio配置文件config.yaml详解（同sinopia配置文件）
搭建离线npm私库——verdaccio
NodeJS学习：搭建私有NPM
完美解决Cannot download "https://github.com/sass/node-sass/releases/download/binding.nod的问题