使用sinopia搭建私有库

使用sinopia的优势

• 配置简单
• 不需要数据库,sinopia内置一个数据库了
• 开启即用
• 当源为sinopia时,本地不存在要安装的包时,会自动去npm把包缓存到本地

1.安装sinopia

npm i sinopia -g

使用上述命令,全局安装sinopia即可

2 在命令行中启动sinopia

sinopia 

image.png

启动成功会出现上图所示
config.yaml文件是sinopia的配置文件

#
# 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: -1  //默认为1000，改为-1，禁止注册

# 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  ////默认没有，只能在本机访问，添加后可以通过外网访问。

3. 换源测试

到这一步sinopia已经安装好了,切换本地npm源即可使用

在config.yaml中的配置listen为sinopia监听的地址和端口,所以sinopia源的地址是 本机ip:4873
我本机ip是192.168.1.41
所以我的sinopia源的地址 "http://192.168.1.41:4873"

1. 使用命令切换源

npm config set registry http://192.168.1.41:4873  //全局切换
npm --registry http://192.168.1.41:4873 install express //临时切换

2. 使用nrm进行切换
   nrm是一款管理npm源的包
   常用命令有:

nrm add sinopia http://192.168.1.41:4873   //添加源  sinopia 为源名称  http://192.168.1.41:4873 为源地址
nrm ls //显示所有源列表
nrm use sinopia //使用名称为sinopia的源
nrm del sinopia //删除名为sinopia的源

4. 遇到的问题

通过以上步骤,安装基本的包已经没有问题了.
但是,当安装的包中有scoped packages,如:@angular/http时,就不起作用了

image.png
这是在安装@angular/http这个包时出的问题,sinopia会提示404.
这个时候需要引入scoped packages的概念,下图是npm官方的定义
image.png
上面安装的包就是这类的包,常见的有@angular @type等
sionpia安装scoped packages时需要在config.yaml中更改配置,如下所示
image.png
这是给scoped packages添加代理源,但是更改完这里之后还是不能正常安装scoped packages,这是sinopia本身的bug导致的,sinopia每次向npmjs请求安装某个包时,请求地址都是转码后再向npm请求的,所以会将@转码为 %40,但是npm不能识别%40,所以导致404的错误.
这个时候只需要修改sinopia中的转码的地方就可以了.
转码的文件是up-storage.js, 不是config.yaml所在目录,是在全局安装包的目录下,修改up-storage.js中的encode为
image.png
修改配置和代码后,重启sinopia,再安装@angular/http,就会提示安装成功
image.png
image.png

5. 部署

1. 使用pm2守护(没有成功过,有待研究...)
2. 使用nohup进行部署

到此,使用sinopia搭建私有仓库完成

引用:使用Sinopia搭建私有的npm仓库 by Pines_Cheng