Sinopia搭建
1.安裝NodeJS及NPM
在Node.js中文網選擇對應的系統進行下載并安裝,安裝完成后即可在終端上使用npm命令
安裝完node后建議設置npm鏡像以加速后面的過程(或使用科學上網工具),設置淘寶npm鏡像如下:
npm config set registry https://registry.npm.taobao.org --global
npm config set disturl https://npm.taobao.org/dist --global
2.安裝Sinopia
npm install -g sinopia
3.啟動Sinopia
在終端輸入sinopia
即可啟動Sinopia服務

此時在瀏覽器輸入http://localhost:4873 ,可以查看服務是否啟動成功。

4.Sinopia配置
Sinopia的特點是,你在哪個目錄運行,它的就會在對應的目錄下創建自己的文件。目錄下默認有兩個文件:
config.yaml :sinopia配置文件
storage ,用戶npm install時如果私有npm倉庫中沒有所需要的包,會從備用第三方庫中拉取并緩存到該目錄。下一次安裝同樣的包時就可以直接從私有npm倉庫中拉取
htpasswd :添加用戶之后自動創建
在第三步中可以得知sinopia配置文件路徑。
config.yaml配置文件
我們需要對自動創建對配置文件進行一點修改:修改如下:
#
# This is the default config file. It allows all users to do anything,
# so don't use it on production systems.
#
# Look here for more config file examples:
# https://github.com/rlidwka/sinopia/tree/master/conf
#
# path to a directory with all packages
storage: ./storage //npm包存放的路徑
auth:
htpasswd:
file: ./htpasswd //保存用戶的賬號密碼等信息
# Maximum amount of users allowed to register, defaults to "+inf".
# You can set this to -1 to disable registration.
max_users: 1000 //默認為1000,改為-1為禁止注冊,這樣就只能通過修改htpasswd來注冊用戶
# a list of other known repositories we can talk to
uplinks:
npmjs:
url: http://registry.npm.taobao.org/ //默認為npm的官網,由于國情,修改 url 讓sinopia使用 淘寶的npm鏡像地址
packages: //配置權限管理
'@*/*':
# scoped packages
access: $all
publish: $authenticated
'*':
# allow all users (including non-authenticated users) to read and
# publish all packages
#
# you can specify usernames/groupnames (depending on your auth plugin)
# and three keywords: "$all", "$anonymous", "$authenticated"
access: $all
# allow all known users to publish packages
# (anyone can register by default, remember?)
publish: $authenticated
# if package is not available locally, proxy requests to 'npmjs' registry
proxy: npmjs
# log settings
logs:
- {type: stdout, format: pretty, level: http}
#- {type: file, path: sinopia.log, level: info}
# you can specify listen address (or simply a port)
listen: 0.0.0.0:4873 ////默認沒有,只能在本機訪問,添加后可以通過外網訪問。
5.通過pm2啟動sinopia
直接在終端通過sinopia命令啟動服務時,如果關閉終端服務就被關閉了,所以一般會借助pm2工具進行進程守護管理。
pm2安裝方式:
nam install -g pm2
通過pm2啟動sinopia
pm2 start `which sinopia
如果需要停止sinopia服務,只需使用以下命令即可:
pm2 stop `which sinopia
Sinopia的使用
在使用sinopia之前,強烈推薦使用nrm來管理自己的npm代理,nrm可以快速修改,切換,增加npm鏡像地址。
ps.我最終搭建的地址為http://10.10.13.15:4873 請自行修改為自己的服務器ip地址
npm install -g nrm # 安裝nrm
nrm add sinopia http://10.10.13.15:4873 # 添加新搭建的npm私有倉庫地址
nrm use sinopia
nrm的其他命令:
$ nrm --help # 查看nrm命令幫助
$ nrm list # 列出可用的 npm 鏡像地址
$ nrm use taobao # 使用`淘寶npm`鏡像地址
npm 下載包
切換為新搭建的私有倉庫后,npm的使用方式沒有任何改變,仍是使用npm install xxx
安裝我們所需要的包。如果私有倉庫中沒有所需要的包,會從備用的鏡像中下載并緩存到本地,下一次在進行安裝時會直接從私有倉庫中獲取。
npm 發布包
要在私有npm倉庫中發布包首先需要注冊或登陸賬號。
如果還沒有賬號,通過輸入命令 npm adduser
,然后依次輸入用戶名,密碼,郵箱用戶即可創建完畢。
如果已有賬號,通過輸入命令 npm login
,然后依次輸入用戶名,密碼,郵箱用戶即可登陸。
然后進入你要上傳的代碼目錄,執行初始化。
$ npm init
這個過程中要輸入項目名,版本號,作者,開源協議等信息,自動生成package.json文件。
這里可以在這里填寫相關信息或者直接回車跳過,因為后續可以直接修改package.json文件。
此外,通過在目錄內新建README文件,可添加包的使用說明和用例代碼。README文件支持markdown,書寫十分方便。
然后執行發布命令就可以發布包到私有npm倉庫了。
npm publish
可以通過瀏覽器訪問http://10.10.13.15:4873 可以看到我們發布的私有包。
