跳到主要内容
版本号:Next

安装

Verdaccio 是一个 Node.js 私有和代理 registry。 在安装之前,您需要确保系统环境已满足以下条件。

最低要求:

  1. Node.js v18 或更高版本。

  2. 你喜爱的 Node 包管理器 npmpnpm 或者 yarn(经典版和现代版)。

我们强烈建议使用最新版本的Node包管理工具,比如> npm@6.x | yarn@1.x | | yarn@2.x | pnpm@6.x。 不再支持npm@5.x或更低版本。

  1. 使用现代浏览器以访问Web界面, 支持使用 Chrome、 Firefox、 Edge和IE11 浏览器。

Verdaccio 将根据 Node. js 发布工作组 的推荐支持最新的 Node. js 版本。

快速开始

在开始之前学习基础:如何安装、配置文件的位置在哪里等等。

安装CLI

在生产环境中使用Verdaccio前,请先阅读并了解 最佳实践案例

Verdaccio 必须使用以下方法之一全局安装:

使用 npm

npm install -g verdaccio@next-7

或者使用 yarn@1.x 经典版

yarn global add verdaccio@next-7

或使用 pnpm

pnpm install -g verdaccio@next-7

安装 Verdaccio

基本用法

一旦安装完成后,你只需要执行 CLI 命令:

$> verdaccio
info -=- local storage path /Users/user/.local/share/verdaccio/storage/.verdaccio-db.json
info --- using htpasswd file: /Users/user/.config/verdaccio/htpasswd
info --- http address http://localhost:4873/
info --- version: 6.0.0-6-next.48
info --- server started

关于 CLI 的详细信息,请 阅读 cli 章节

你可以通过以下命令来设置 registry。

npm set registry http://localhost:4873/

你可以在需要时带上 --registry 参数。

npm install --registry http://localhost:4873

在你的 .npmrc 中设置一个 registry 属性。

.npmrc
registry=http://localhost:4873

或在你的 package.json 中设置 publishConfig

{
"publishConfig": {
"registry": "http://localhost:4873"
}
}

如需其他配置,请阅读 使用私有 registry 部分。

创建属于你自己的私有NPM包教程

如果你想要更详细的介绍,不要错过 thedevlife 编写的关于如何使用 Verdaccio 创建你自己的私有 NPM 包的教程。

Docker 镜像

docker run -it --rm --name verdaccio -p 4873:4873 verdaccio/verdaccio:nightly-master

Verdaccio 有官方 docker 镜像可以使用,在大多数情况下,默认配置已经足够了。 关于如何安装官方镜像的更多信息,请 阅读 docker 部分。此外,你可以在我们的 docker-examples 存储库中了解更多关于组合 Docker 镜像的信息。

Helm Chart

$ helm repo add verdaccio https://charts.verdaccio.org
$ helm repo update
$ helm install registry --set image.tag=nightly-master verdaccio/verdaccio