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