公司对于搭建本地私有npm库有如下要求：
- 私有包托管在内部服务器中
- 项目中使用了公共仓库上的公共包，也使用了内部服务器上的私有包
- 希望下载的时候，公共包走公共仓库，私有包走内部服务器的私有仓库
- 服务器硬盘有限，希望只缓存下载过的包，而不是全部同步
- 对于下载，发布npm包有对应的权限管理，安装方便，配置简单，依赖少
sinopia
sinopia是一个零配置带缓存的npm包管理工具，符合上述要求
安装过程及遇到的问题解决
安装环境：
ubuntu 16.04LTS
node 7.8.0
npm 4.2.0
安装配置node及npm
从官网下载https://nodejs.org/en/download/current/ 下载最新二进制压缩包node-v7.8.0-linux-x64.tar.xz
放到当前用户下面的目录，并解压
$ tar xvJf node-v7.8.0-linux-x64.tar.xz
进入bin目录
$ cd bin
$ ./node -v
v7.8.0
说明nodejs已经安装成功，为了方便执行命令，需要配置环境变量
$ sudo vi /etc/profile
在文件底部插入，保存
PATH=$PATH:/{prefix}/node-v7.8.0-linux-x64/bin
使之生效
$ source /etc/profile
这样就可以在所有位置输入命令，验证node及npm安装成功
$ node -v
v7.8.0
$ npm -v
v4.2.0
可以先配置下npm的源地址
$ npm set registry https://registry.npm.taobao.org/ # 推荐淘宝npm镜像
安装配置sinopia
$ npm install -g sinopia
安装完成，启动
$ sinopia
warn --- config file - /home/{user}/.config/sinopia/config.yaml
warn --- http address - http://localhost:4873/
上面信息第一行是生成的配置文件，第二行是默认地址，浏览器打开可看到
配置文件能完成如下等功能：
- 设置包存放路径
- 设置用户信息文件路径及数量
- 设置上游地址
- 设置包发布、安装权限
- 设置监听地址
配置文件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: /home/{user}/.local/share/sinopia/storage # 库存路径，需要考虑磁盘空间
web: # 自定义web项，即浏览器访问页面
# web interface is disabled by default in 0.x, will be enabled soon in 1.x
# when all its issues will be fixed
#
# set this to `true` if you want to experiment with web ui now;
# this has a lot of issues, e.g. no auth yet, so use at your own risk
#enable: true
title: Sinopia
# logo: logo.png
# template: custom.hbs
auth:
htpasswd:
file: ./htpasswd # 添加用户（npm adduser）后自动创建，保存用户信息，可以初始化用户
# Maximum amount of users allowed to register, defaults to "+inf".
# You can set this to -1 to disable registration.
#max_users: 1000 # 设置为-1不能npm adduser
# a list of other known repositories we can talk to
uplinks: # 可以配置多个上游地址，后面packages中的proxy指定用哪个
npmjs:
url: https://registry.npm.taobao.org/ # 更改此上游地址
# amount of time to wait for repository to respond
# before giving up and use the local cached copy
#timeout: 30s # 请求上游地址超时时间
# maximum time in which data is considered up to date
#
# default is 2 minutes, so server won't request the same data from
# uplink if a similar request was made less than 2 minutes ago
#maxage: 2m # 包过期时间
# if two subsequent requests fail, no further requests will be sent to
# this uplink for five minutes
#max_fails: 2 # 容许依赖请求最大失败数
#fail_timeout: 5m # 依赖请求超时时间
packages: # 包的权限管理，$all为所有人，$authenticated为通过验证人
# 分布和安装两种权限，值可以特指某几人
'@*/*': # 跟package.json中的name属性进行匹配
# 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}
listen: 0.0.0.0:4873 # 设置监听地址，0.0.0.0匹配本机地址
# if you use nginx with custom path, use this to override links
#url_prefix: https://dev.company.local/sinopia/
# Configure HTTPS, it is required if you use "https" protocol above.
#https:
# key: path/to/server.key
# cert: path/to/server.crt
# you can specify proxy used with all requests in wget-like manner here
# (or set up ENV variables with the same name)
#http_proxy: http://something.local/ # 设置代理服务器
#https_proxy: https://something.local/
#no_proxy: localhost,127.0.0.1
# maximum size of uploaded json document
# increase it if you have "request entity too large" errors
#max_body_size: 1mb # http请求body大小
修改uplinks及listen值，同上，重启sinopia
如果想引用别的配置文件，请通过sinopia -c <配置文件>指定
最后更改npm源地址为私有库地址
$ npm set registry http://{服务器ip}:4873/ # 内网测试可行（外网暂无条件测试）
用pm2托管sinopia
上面方式启动sinopia只是暂时的，退出命令行就没有了，因此需要一个长期开启sinopia方案，通过pm2托管，可以让sinopia进程永远活着，就算意外挂了也可自动重启。
安装pm2
$ npm install -g pm2
安装完后，使用pm2启动sinopia
$ pm2 start sinopia
[PM2] Spawning PM2 daemon with pm2_home=/home/{user}/.pm2
[PM2] PM2 Successfully daemonized
...
[PM2] Done.
pm2提供开机自启动功能
$ pm2 startup ubuntu # 或centos，看具体环境
将图片红圈内容复制运行
最后保存配置信息
$ pm2 save
到此为止，居于sinopia的npm私有库搭建完成了，当下次启动linux时，npm私有库已经自动运行了
客户端操作
nrm的使用
nrm是个方便的npm源管理工具，来做快速registry切换，可选
$ npm install -g nrm
$ nrm ls
npm ---- https://registry.npmjs.org/
cnpm --- http://r.cnpmjs.org/
taobao - https://registry.npm.taobao.org/
nj ----- https://registry.nodejitsu.com/
rednpm - http://registry.mirror.cqupt.edu.cn/
npmMirror https://skimdb.npmjs.com/registry/
edunpm - http://registry.enpmjs.org/
加入新创建的私有库地址，并切换
$ nrm add xgnpm http://{ip}:{port}/
$ nrm use xgnpm
创建npm用户
在发布包之前，一般需要创建用户
$ npm adduser # 注册，根据提示创建完成
$ npm login
创建用户后，默认会在配置文件同级目录生成htpasswd，保存用户信息
发布
简单创建一个npm包
$ mkdir publishtest
$ cd publishtest
$ npm init
$ vi index.js
$ ls
index.js package.json
$ npm publish
打开浏览器，发现这个包已经上传至服务器
再看看这个包的实际路径
若要取消发布，执行
$ npm unpublish
升级
要升级包，只需更改package.json的version属性，version要比原来的大才行
安装
安装会先找本地有无该包，没有的话从上游地址下载，然后保存到storage中，下次安装直接从本地获取
$ npm install publishtest01
会生成node_modules，里面就是刚才发布的包
补充：windows下安装sinopia
windows环境中基本与linux下相同，但可能会遇到几个问题
- 需要安装python2.7
下载安装python2.7，配置环境变量PATH，npm config set python python2.7 - MSBuild版本不对
安装Visual Studio Express 2013 for Windows Desktop可以解决 - 安装sinopia时出现错误
crypt3跟fs-ext模块安装错误可以忽略，windows不支持 - windows下pm2无效，用nssm来开启服务
下载nssm，解压，命令行运行nssm install sinopia，跳出对话框，输入配置
- path: node
- startup directory: C:\Users\Administrator\AppData\Roaming\npm\node_modules\sinopia
- arguments: C:\Users\Administrator\AppData\Roaming\npm\node_modules\sinopia\lib\cli.js -c C:\Users\Administrator.config\sinopia\config.yaml
然后按install service按钮，最后在命令行运行sc start sinopia，服务自动开启
