返回

如何使用 Verdaccio 搭建本地私有 NPM 仓库?

前端

本地私有 NPM 仓库的优点是无需付费,并且下载包的速度非常快,因为它是部署在本地。不过在使用 npm install 下载非本地包时,需要在 .npmrc 文件中配置代理,否则会报错。

一、Verdaccio 简介

Verdaccio 是一个轻量级的私有 NPM 仓库,可以轻松地部署在本地。它支持多种认证方式,包括基本认证、令牌认证和 LDAP 认证。Verdaccio 还提供了丰富的 RESTful API,方便开发者进行交互。

二、安装 Verdaccio

  1. 安装 Node.js

    首先,你需要确保你的电脑上已经安装了 Node.js。你可以从 Node.js 官网下载并安装它。

  2. 安装 Verdaccio

    你可以使用以下命令安装 Verdaccio:

    npm install -g verdaccio
    

三、配置 Verdaccio

  1. 创建配置文件

    在安装完成后,你需要创建一个配置文件来配置 Verdaccio。配置文件通常位于 ~/.config/verdaccio/config.yaml。你可以使用以下命令创建它:

    verdaccio config
    
  2. 配置选项

    在配置文件中,你可以配置以下选项:

    • storage :指定仓库的存储路径。
    • auth :配置认证方式。
    • listen :指定 Verdaccio 监听的端口。
    • self_path :指定 Verdaccio 的安装路径。

四、运行 Verdaccio

  1. 启动 Verdaccio

    你可以使用以下命令启动 Verdaccio:

    verdaccio start
    
  2. 访问 Verdaccio

    Verdaccio 启动后,你就可以通过浏览器访问它了。默认情况下,Verdaccio 监听 4873 端口。你可以使用以下 URL 访问它:

    http://localhost:4873
    

五、使用 Verdaccio

  1. 创建包

    要创建一个包,你需要使用以下命令:

    npm publish
    
  2. 安装包

    要安装一个包,你需要使用以下命令:

    npm install <包名>
    

六、常见问题

  1. npm install 下载非本地包时报错

    如果在使用 npm install 下载非本地包时出现报错,你需要在 .npmrc 文件中配置代理。你可以使用以下命令创建 .npmrc 文件:

    touch .npmrc
    

    然后在 .npmrc 文件中添加以下内容:

    proxy=http://localhost:4873
    
  2. 如何更改 Verdaccio 的监听端口?

    你可以通过修改配置文件中的 listen 选项来更改 Verdaccio 的监听端口。

总结

Verdaccio 是一个轻量级、易于使用的私有 NPM 仓库。它可以帮助你轻松地管理你的私有包。如果你正在寻找一个私有 NPM 仓库解决方案,那么 Verdaccio 是一个不错的选择。