由于公司需要在内网环境下开发,npm包不能直接从外网中下载,需要先缓存到内网服务器中,再从内网服务器下载,开始选择的sinopia在经常报错,后来查到sinopia在近两年已经不再维护,而verdaccio是sinopia的一种新的实现形式,并且目前一直在维护中,故重新选择更稳定的verdaccio来搭建内网环境。
1.安装node环境
1.1 源码安装
下载最新的node环境,下载地址:https://nodejs.org/en/download/
选择对应平台的binary文件下载
wgethttps://nodejs.org/dist/v10.15.3/node-v10.15.3-linux-x64.tar.xz
sudo mv node-v10.15.3-linux-x64.tar.xz /opt/
cd /opt
sudo tarxvJf node-v10.15.3-linux-x64.tar.xz
sudo ln -fsnode-v10.15.3-linux-x64 node
立即生效:export PATH=$PATH:/opt/node/bin
#为了方便执行命令,配置环境变量:
sudo vi /etc/rc.local
加入PATH=$PATH:/opt/node/bin
启动rc.local服务:sudo chmod a+x /etc/rc.d/rc.local; sudo systemctl enable rc-local.service
1.2 yum安装
sudo su
curl -sL https://rpm.nodesource.com/setup_10.x | bash -
yum install -y nodejs
npm install package_name #安装包,可加-g、--unsafe-perm等参数。
如果国内npm下载太慢可以使用淘宝的镜像:npm set registryhttps://registry.npm.taobao.org/
2.安装verdaccio
verdaccio的GitHub地址:https://github.com/verdaccio/verdaccio
npm install -g verdaccio
如果遇到 警告或错误:Warning “root” does not have permission to access the dev dir ,使用 sudo 仍然抛出这样的权限异常,可在 npm 的参数中增加: –unsafe-perm
如果采用源码安装方式,由于系统目录没有权限,安装如果遇到权限问题可参考:https://docs.npmjs.com/getting-started/fixing-npm-permissions
如果采用yum安装的nodejs,使用npm install -g verdaccio即可。
启动verdaccio
(建议用root用户启动并在/root目录生成配置文件,因为服务器上的其他程序也是用root安装的。)
verdaccio #第一次启动时会创建配置文件~/.config/verdaccio/config.yaml
编辑config.yaml文件,注意yaml格式:
vim ~/.config/verdaccio/config.yaml(配置说明:https://verdaccio.org/docs/en/configuration)
storage: ./storage #默认数据目录,可以不修改。使用pm2启动后,数据目录变成/root/.local/share/verdaccio/storage/。
npmjs:
url:https://registry.npmjs.org/默认源改为淘宝的https://registry.npm.taobao.org/
文件末尾添加listen: 0.0.0.0:10010
3.pm2守护verdaccio进程
#使用verdaccio命令虽然可以正常启动和使用verdaccio,但不建议用这种方式启动verdaccio,我们可以用pm2来使用pm2对verdaccio进程进行托管启动。
安装pm2并使用pm2启动verdaccio,使用pm2托管的进程可以保证进程永远是活着的,推荐使用此种方式启动verdaccio。
#安装pm2:
sudo npm install -g pm2使用pm2启动verdaccio
设置开机启动
sudo pm2 startup #注意执行完该命令后提示执行命令“sudo env PATH=$PATH:/usr/bin/usr/lib/node_modules/pm2/bin/pm2 startup systemd -u a --hp /home/a”。如果是root用户登录执行pm2 startup,没有这段提示。
注意:因为服务器上的其他程序比如gitlab是root安装的,建议也使用root用户启动pm2,此时verdaccio的配置文件在/root/.config/verdaccio/config.yaml,数据目录在/root/.config/verdaccio/storage
pm2 start verdaccio
#查看pm2 守护下的进程verdaccio的实时日志:通过这个命令我们可以从下图中看到所有verdaccio的所有信息,打开 out log path查看进程输出日志,出现错误时候也可以打开error log来查看错误日志。
pm2 show verdaccio
pm2 save #保存pm2状态,也即启动pm2时启动verdaccio
4. 使用私有源
4.1 使用私有源安装包
#当前npm 服务指向私有源
npm set registry http://192.168.10.100:10010
然后执行npm install即可从私有源安装包
4.2 在私有源上创建用户
#添加用户,并输入用户名和密码
npm adduser --registryhttp://192.168.10.100:10010#密码保存在~/.config/verdaccio/htpasswd
然后在verdaccion启动页面尝试登录即可,默认登录后有发布包的权限。(这里可以通过修改config.yaml配置文件来对权限进行设置)
4.3 向私有源发布包
npm login #登录,输入用户名、密码和邮箱
#简单创建一个npm包
$ mkdir publishtest
$ cd publishtest
$ npm init
$ vi index.js
$ npm publish
#发布包:
npm publish
发布后就可以在其他模块里面使用 npm install [package name] 来安装了, 而私有npm 里面不包含的包,例如你要安装一个vue ,webpack 这样的包,找不到的话,会被代理到 npm.js 官网去下载,并且会帮你缓存在 ./storage 文件夹里面. 再次下载,就能体验飞一般的速度了。