1. 程式人生 > >記錄windows環境下用verdaccio搭建npm私有庫

記錄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源
    nrm ls
    名稱前有* 的是當前用npm下載包的時候的地址,比如截圖裡面,當我npm install以後,就會從http://localhost:4873/上面下載包,而不是從npm網站上面下載
  • $ nrm use 源名稱
    設定當前npm源
    nrm use
    這裡我就把npm源換成了npmjs,當然咱們安裝node以後,npm預設就是從這裡下載。
  • $ nrm add 名稱 地址
    建立新的源
    nrm add
  • $ nrm del 名稱
    刪除源
    nrm del
  • 這些記不住都沒關係,直接$ nrm全都可以檢視
    $nrm

4 釋出包

$ npm publish --registry http://localhost:4873
這裡我隨便新建一個資料夾,通過npm init新建一個專案,然後在這個目錄下,npm publish --registry http://localhost:4873
npm init
此時,檔案裡面有了package.json
package.json
npm publish
釋出成功

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快取再下載啊~
放到內網的話,就把這些東西都拷進去把~
大功告成~

參考文件

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的問題