Linux搭建Verdaccio私有npm仓库指南

本文详细介绍了在Linux系统中搭建轻量级私有npm仓库Verdaccio的三种主流方式——全局npm安装、npx临时运行和Docker容器化部署，并涵盖关键配置环节：通过htpasswd实现用户认证、精细化控制私有包（如@myorg/*）的访问与发布权限，以及借助systemd配置开机自启与后台稳定运行，为开发者提供了一套开箱即用、安全可靠且易于维护的私有包管理解决方案。

如果您希望在Linux系统中搭建一个私有的npm仓库，Verdaccio是一个轻量级且易于配置的选择。以下是完成Verdaccio安装与基础配置的具体步骤：

一、使用Node.js和npm全局安装Verdaccio

Verdaccio以npm包形式发布，可直接通过npm进行全局安装。该方式适用于已安装Node.js（v14或更高版本）及配套npm的Linux环境。

1、确认Node.js和npm版本是否满足要求：执行 node -v 和 npm -v，确保输出版本号不低于v14.0.0和v6.0.0。

2、执行全局安装命令：sudo npm install -g verdaccio。

3、验证安装是否成功：verdaccio --version，应输出类似“5.27.0”的版本号。

二、通过npx临时运行Verdaccio服务

npx允许不全局安装即可运行Verdaccio，适合快速测试或临时部署场景，避免污染系统全局npm环境。

1、在任意空目录下创建配置文件夹：mkdir -p ~/verdaccio-conf && cd ~/verdaccio-conf。

2、生成默认配置文件：npx verdaccio --init，按提示保存为config.yaml。

3、启动服务：npx verdaccio --config config.yaml，服务默认监听localhost:4873。

三、使用Docker容器化部署Verdaccio

Docker方式能完全隔离运行时依赖，便于复现环境、统一管理配置与数据卷，适合生产环境长期运行。

1、拉取官方镜像：docker pull verdaccio/verdaccio:latest。

2、创建本地配置目录并复制默认配置：mkdir -p ~/verdaccio/conf && docker run --rm -it -v $(pwd)/conf:/verdaccio/conf verdaccio/verdaccio:latest cat /verdaccio/conf/default.yaml > ~/verdaccio/conf/config.yaml。

3、启动容器并映射端口与卷：docker run -d --name verdaccio -p 4873:4873 -v ~/verdaccio/conf:/verdaccio/conf -v ~/verdaccio/storage:/verdaccio/storage verdaccio/verdaccio:latest。

四、配置Verdaccio用户认证与私有包权限

默认配置允许匿名发布，需手动修改config.yaml启用htpasswd认证并限制publish权限，防止未授权上传。

1、编辑config.yaml文件，定位到auth段，取消注释并修改为：auth: htpasswd: file: ./htpasswd。

2、生成初始管理员账户：htpasswd -c ./htpasswd admin，按提示输入密码。

3、在packages段中限定私有命名空间权限：'@myorg/*': allow: $authenticated publish: $authenticated。

五、设置systemd服务实现开机自启

将Verdaccio注册为systemd服务，可实现后台常驻、自动重启与日志集成，适用于生产环境稳定性要求。

1、创建服务定义文件：sudo tee /etc/systemd/system/verdaccio.service 。

2、写入服务配置内容（注意替换实际路径）：[Unit] Description=Verdaccio npm registry After=network.target [Service] Type=simple User=verdaccio WorkingDirectory=/opt/verdaccio ExecStart=/usr/bin/verdaccio --config /opt/verdaccio/config.yaml Restart=on-failure [Install] WantedBy=multi-user.target。

3、启用并启动服务：sudo systemctl daemon-reload && sudo systemctl enable verdaccio && sudo systemctl start verdaccio。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。