Nexus配置npm私有仓库
对于前端项目的运行,我们一般要使用npm来管理依赖Node.js的依赖,安装依赖一般要指定镜像的下载地址如:npm config set registry https://registry.npmmirror.com
,但这种方式比较依赖网络,每次都要从远程拉取,对于企业内网开发,这种直连公共仓库方式往往不适用,本文介绍了使用Nexus配置私有npm仓库来拉取依赖过程。
私有npm仓库解决的问题
- 私有存储空间:安全存储内部npm包
- 代理缓存:缓存后的依赖可离线使用,减少重复下载
- 统一管理:集中控制所有依赖来源,可给多个项目使用
一、 Nexus介绍
Nexus简介
Nexus(由Sonatype开发)是一款强大的私有仓库管理平台,用于统一管理二进制构件(如软件包、依赖库、容器镜像等),支持多种技术栈(如Maven、npm、Docker、NuGet等)。它通过本地化存储和代理远程仓库,显著提升团队开发效率与安全性。
Nexus核心概念
Nexus的核心是仓库(Repository),分为三类:
- Hosted(本地仓库):用于存储团队私有构件(如自研npm包、内部Docker镜像)。
- Proxy(代理仓库):代理并缓存远程公共仓库(如npmjs.org、Docker Hub),首次下载后缓存到本地,后续请求直接读取缓存。示例:配置npm-proxy代理淘宝镜像,加速依赖下载。
- Group(仓库组):聚合多个Hosted和Proxy仓库,提供统一访问入口。示例:npm-public组合npm-proxy(开源依赖)和npm-hosted(私有包),用户只需配置一个地址
二、配置过程
1. 前置条件
- Nexus服务已部署好
- 开放Nexus服务器对
registry.npmmirror.com
:443的出站访问
2.本地仓库创建(hosted类型)
创建hosted类型的npm仓库,找到设置页面
选择npm(hosted)类型,hosted表示本机私有
填写新建的仓库信息
这里blob store(文件存储配置)选择了默认的,deployment policy选择Allow redeploy
,Allow Redeploy(允许重新部署)允许用户多次上传相同版本的构件,新上传的构件会覆盖已有的构件。
3.代理仓库创建(proxy类型)
创建一个proxy类型的仓库,当依赖下载时,请求到达 Nexus -> 检查本地缓存 -> 若有缓存则直接返回 → 若无则从配置的镜像仓库下载并缓存。
这里镜像拉取地址选择了:https://registry.npmmirror.com
淘宝镜像源
4.仓库组创建(group类型)
创建仓库时选择npm-gruop类型,并把刚才常见的成员将npm-local
和npm-proxy
加入组
回到浏览页面,可以看到刚刚创建的3个仓库
点击拷贝url我们就能拿到需要配置的url仓库地址:http://xxx.xxx.xxx.xxx:8081/repository/npm-public/
三、验证测试
在拉取依赖时,配置替换为我们Nexus镜像仓库地址:npm config set registry http://xxx.xxx.xxx.xxx:8081/repository/npm-public/
四、常见问题
发布时遇到401未授权错误
此时需要开启npm的Bearer Token认证机制,配置如下