前言
前端团队沉淀一套通用的UI库、工具类、脚手架,不允许在公网发布,内网npm私有库搭建需求应运而生。如何在内网环境搭建npm私有仓库并使用?主角登场了 —— Verdaccio。接下来我来教大家使用 verdaccio 在内网环境中搭建npm私有仓库。
基础环境
为了避免因为基础环境不一致而产生意料之外的问题,基础环境要尽可能保持一致。
环境依赖 | 版本 | 说明 |
Centos | 7.9 | 这里以Centos系统为例 |
Node.js | 16.19.0 | 推荐 16.x lts |
pm2 | 5.2.2 | nodejs进程守护工具 |
verdaccio | 5.19.1 | npm私有仓库 |
nvm | 0.39.1 | nodejs版本管理工具 |
下载安装工具(nvm)
nvm国内镜像下载!
# 下载并安装nvm
curl -fsSL https://gitee.com/eagle_0810/nvm/raw/master/install.sh | bash
# 重载配置
source ~/.bashrc
# 验证执行安装成功
nvm --version
# 安装nodejs
nvm install v16.19.0
# 更换npm源为淘宝镜像
npm config set registry=https://registry.npmmirror.com
安装verdaccio、pm2
npm install -g verdaccio@5.19.1 pm2@5.2.2
修改verdaccio默认配置
其他更多配置可查看verdaccio官网
https://verdaccio.org/zh-CN/docs/configuration
# 执行verdaccio验证安装成功并生成配置文件
verdaccio
# 修改配置文件
vim /root/.config/verdaccio/config.yaml
# 修改页面标题
web:
title: CloudWise-Verdaccio
# 上传npm包大小限制修改
max_body_size: 100mb
# 允许内外网其他设备访问
listen:
- 0.0.0.0:4873
# 修改web端默认语言为中文
i18n:
web: zh-CN
启动verdaccio服务
verdaccio是基于nodejs的应用,因此需要pm2守护verdaccio进程。
pm2 start verdaccio
注意:启动失败报错可执行以下命令查看pm2日志,根据日志修改报错并重新启动verdaccio服务。
pm2 logs verdaccio
验证是否部署成功
注意:开放对应端口(4873)
访问:http://ip:4873/
发布npm私有包
注意:发布私有包必须将镜像修改为私有镜像地址且私有npm包名称必须是"@{组织名}/{npm-name}"
修改镜像源地址
npm set registry http://ip:4873/
注册账号
输入以下命令后开始注册用户
npm adduser
登陆账号并验证是否登录成功
npm login
npm who am i
在项目package.json中配置包信息
如果从0开发的项目可以直接npm init
如果项目有package.json可直接手动修改
注意:私有包名称必须是"@{组织名}/{npm-name}"
例如:@cloudwise/map-common
发布、删除私有包
npm publish
npm unpublish 包名 --force
使用私有包
npm、yarn 切换回淘宝镜像,项目根目录下添加.npmrc、.yarnrc文件添加以下配置支持npm和yarn安装私有包。
# .npmrc 文件
# 指向内网私源
@{组织名}:registry=http://ip:4873
# .yarnrc 文件
# 指向内网私源
"@{组织名}:registry" "http://ip:4873"
总结
以上就是我个人搭建npm私有仓库的实践了,总的来说使用verdaccio搭建npm私有仓库还是比较简单的,如果有哪里写的不对的地方或者有关教程优化建议欢迎留言指点。