内网npm私有仓库搭建以及使用教程

前言

前端团队沉淀一套通用的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私有仓库还是比较简单的，如果有哪里写的不对的地方或者有关教程优化建议欢迎留言指点。

本网站所收集的部分公开资料来源于AI生成和互联网，转载的目的在于传递更多信息及用于网络分享，并不代表本站赞同其观点和对其真实性负责，也不构成任何其他建议。