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 可以看到我们发布的私有包。