Verdaccio 常见问题解决方案

Verdaccio 常见问题解决方案

verdaccio 📦🔐 A lightweight Node.js private proxy registry 项目地址: https://gitcode.com/gh_mirrors/ve/verdaccio

项目基础介绍

Verdaccio 是一个轻量级的 Node.js 私有代理注册表。它不需要复杂的数据库配置，开箱即用，自带小型数据库，并且能够代理其他注册表（如 npmjs.org），在下载模块时进行缓存。Verdaccio 支持通过社区制作的插件扩展其存储能力，例如连接到 Amazon S3 或 Google Cloud Storage 等服务。

新手使用注意事项及解决方案

1. 安装 Node.js 版本问题

问题描述：Verdaccio 要求 Node.js 的最低版本为 v18。如果用户安装的 Node.js 版本低于 v18，可能会导致 Verdaccio 无法正常运行。

解决方案：

1. 检查当前 Node.js 版本：

   node -v
   

2. 如果版本低于 v18，建议使用 Node.js 版本管理工具（如 nvm）升级或切换到 v18 或更高版本。

   nvm install 18
   nvm use 18
   

3. 重新安装 Verdaccio：

   npm install -g verdaccio@next
   

2. 配置文件路径问题

问题描述：Verdaccio 的配置文件通常位于用户主目录下的 .config/verdaccio/config.yaml。新手用户可能会找不到配置文件，或者配置文件路径不正确。

解决方案：

1. 确认配置文件路径：

   ls ~/.config/verdaccio/config.yaml
   

2. 如果文件不存在，可以手动创建配置文件：

   mkdir -p ~/.config/verdaccio
   touch ~/.config/verdaccio/config.yaml
   

3. 编辑配置文件，添加基本配置：

   storage: ./storage
   auth:
     htpasswd:
       file: ./htpasswd
   uplinks:
     npmjs:
       url: https://registry.npmjs.org/
   packages:
     '@*/*':
       access: $all
       publish: $authenticated
       proxy: npmjs
     '**':
       proxy: npmjs
   logs:
     - {type: stdout, format: pretty, level: http}
   

3. 端口冲突问题

问题描述：Verdaccio 默认运行在 4873 端口。如果该端口已被其他服务占用，Verdaccio 将无法启动。

解决方案：

1. 检查端口占用情况：

   lsof -i :4873
   

2. 如果端口被占用，可以选择终止占用端口的进程，或者修改 Verdaccio 的配置文件以使用其他端口。
3. 修改配置文件中的 listen 字段：

   listen:
     - 0.0.0.0:5000
   

4. 重启 Verdaccio：

   verdaccio
   

通过以上步骤，新手用户可以更好地理解和解决在使用 Verdaccio 过程中可能遇到的问题。

verdaccio 📦🔐 A lightweight Node.js private proxy registry 项目地址: https://gitcode.com/gh_mirrors/ve/verdaccio