在企业级应用开发中,常常需要处理私有包的发布和管理。搭建 npm 私有服务器是一个理想的解决方案,它不仅能保证代码的私密性,还能提供更快的下载速度和更精细的权限设置。
一、搭建 npm 私有服务器的优势
二、Verdaccio——搭建 npm 私有仓库的利器
- 轻量级:Verdaccio 采用 Node.js 编写,安装和运行起来非常快速。它不依赖于任何外部数据库,而是将数据存储在本地文件系统中。
- 简单的配置:Verdaccio 的配置非常简单,只需一个 YAML 文件即可。您可以轻松地指定用户权限、上游代理、缓存设置等。
- 缓存和代理:Verdaccio 可以作为上游 npm 注册表的代理,从而帮助减轻网络延迟和提高包的安装速度。同时,它还会缓存已经下载的包,以便在没有互联网连接的情况下也能正常工作。
- 访问控制:Verdaccio 支持基于用户和包的访问控制,您可以轻松地管理谁可以访问、发布和安装私有 npm 包。
- 插件支持:Verdaccio 支持插件,您可以扩展其功能,如添加身份验证提供程序、审计日志等。
- 首先安装 Verdaccio:
npm i -g verdaccio
- 查看 verdaccio 的基本信息:
verdaccio -h
- 启动服务器:
verdaccio
- 配置文件格式:Verdaccio 配置文件采用的是 YAML 格式,这是配置文件的一种常用格式,基本的语法结构由键值对组成,使用缩进来表示层级关系,键值对使用冒号分隔,键和值之间使用一个空格分隔。例如:
person:
name: John
age: 30
address:
street: Main St.
city: New York
- 一些重要配置项:
- storage:存储包的路径。
- web:网站相关的配置,如 title 等。
- uplinks:上游代理。当我们搭建了私服,但通过私服下载某些包时,私服可能没有。这个时候就会从上游代理中去下载这些包,然后缓存到私服里面。例如:
uplinks:
npmjs:
url: https://registry.npmjs.org/- packages:这个配置项用于对权限的控制。例如:
packages:
'@your-scope/*':
access: $authenticated
publish: $authenticated
proxy: npmjs
'**':
access: $all
publish: $authenticated
proxy: npmjs
@your-scope/ 这个作用域包,只允许认证过的用户访问和发布,对于其他的包,所有用户都能够访问,但是只有认证过的用户才能发布,从而能够对权限做一个很好的控制。- auth:设置用户身份的验证方法,默认采用的是 htpasswd 的方式。
三、镜像管理工具 nrm
- 首先安装 nrm:
npm i -g nrm
- 安装时可能会遇到错误,因为 nrm 依赖于一个名为 open 的包,因此在安装 nrm 的时候,同时安装 open 即可:
npm install -g nrm open@8.4.2
- nrm ls:列出所有可用的镜像列表。
- nrm use < registry >:切换镜像。
- nrm add < registry > < url >:添加镜像。
- nrm del < registry >:删除镜像。
评论前必须登录!
注册