Skip to main content


Verdaccio 是一个跨平台的 Web 应用程序。 在安装之前,您需要确保系统环境已满足以下条件。


  1. Node.js v12 or higher.

  2. npm >=4.xyarn > 我们强烈建议使用最新的 Node 包管理客户端 > npm@5.x | yarn@1.x | pnpm@2.x

我们强烈建议使用最新版本的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 版本。

仍在使用 Verdaccio 4? 查看 迁移指南





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

Verdaccio must be installed globally using either of the following methods:

Using npm

npm install -g verdaccio

or using yarn

yarn global add verdaccio

or using pnpm

$> verdaccio
warn --- config file - /home/.config/verdaccio/config.yaml
warn --- http address - http://localhost:4873/ - verdaccio/3.0.0

install verdaccio

Docker 镜像

Once it has been installed, you only need to execute the CLI command:

$> verdaccio
warn --- config file - /home/.config/verdaccio/config.yaml
warn --- http address - http://localhost:4873/ - verdaccio/5.0.0

For more information about the CLI, please read the cli section.

You can set the registry by using the following command.

npm set registry http://localhost:4873/

you can pass a --registry flag when needed.

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

define in your .npmrc a registry field.


Or a publishConfig in your package.json

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

Create Your Own Private NPM Package Tutorial

If you'd like a broader explanation, don't miss the tutorial created by thedevlife on how to Create Your Own Private NPM Package using Verdaccio.

Docker Image

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

Verdaccio has an official docker image you can use, and in most cases, the default configuration is good enough. For more information about how to install the official image, read the docker section.


Verdaccio is also available as a 1-click install on Cloudron