搭建NPM私有仓库可安全共享内部包、提升安装速度并统一管理版本，推荐使用轻量且易扩展的Verdaccio。1. 通过npm install -g verdaccio全局安装并启动服务，默认监听4873端口。2. 配置~/.config/verdaccio/config.yaml，设置storage路径、uplinks代理npmjs.org，并定义@mycompany/*命名空间的访问与发布权限。3. 使用npm adduser --registry http://your-server:4873注册用户，完成认证。4. 在项目package.json中设置name为私有命名空间（如@mycompany/utils）并配置publishConfig.registry指向私有仓库。5. 执行npm publish发布包，其他成员通过设置registry或.npmrc文件安装。生产环境建议结合Nginx反向代理实现HTTPS和域名访问，使用PM2守护进程，并定期备份storage与配置文件。可通过插件集成LDAP/OAuth增强权限审计。Verdaccio部署简单，维护成本低，关键在于规范命名、正确配置registry及用户权限。
搭建和维护NPM私有仓库，核心目标是让团队在内部安全地发布、共享和管理JavaScript包，避免依赖外部网络或暴露源码。主流方案有Verdaccio、Sinopia、Nexus Repository等，其中Verdaccio因轻量、易用、支持插件和持续更新，成为最推荐的选择。
为什么需要私有NPM仓库
企业开发中，常会封装通用工具库、UI组件或业务模块，这些代码不适合开源到npmjs.org。使用私有仓库可以：
- 安全控制包的访问权限
- 提升安装速度，减少对公网的依赖
- 缓存公开包，降低外网请求频率
- 统一版本管理与发布流程
使用Verdaccio搭建私有仓库
Verdaccio是基于Node.js的轻量级私有NPM代理仓库，支持本地存储、用户认证、Web UI 和反向代理集成。
1. 安装与启动全局安装Verdaccio：
立即学习“Java免费学习笔记（深入）”；
npm install -g verdaccio
启动服务（默认监听4873端口）：
verdaccio2. 配置文件说明
首次运行后，会在用户目录生成配置文件 ~/.config/verdaccio/config.yaml。关键配置项包括：
- storage：包存储路径
- uplinks：代理上游仓库（如npmjs.org）
- packages：定义包访问权限
- users：用户登录信息（通过htpasswd管理）
示例配置允许以@mycompany命名空间的包私有发布：
packages:
'@mycompany/*':
access: $authenticated
publish: $authenticated
proxy: npmjs
3. 用户认证首次发布需登录。Verdaccio内置账号系统，执行：
npm adduser --registry http://your-server:4873
输入用户名、密码、邮箱完成注册。用户信息保存在htpasswd文件中。
发布与使用私有包
在项目中发布私有包前，确保package.json中name字段包含私有命名空间（如"name": "@mycompany/utils"），并设置registry：
"publishConfig": {
"registry": "http://your-server:4873/"
}
发布命令：
npm publish
其他开发者安装该包时，可全局设置registry：
npm config set registry http://your-server:4873
或在项目中单独配置.npmrc文件：
registry=http://your-server:4873
然后正常安装：
npm install @mycompany/utils
维护与进阶配置
生产环境部署建议结合反向代理（如Nginx）和进程守护（如PM2）。
1. Nginx反向代理配置域名和HTTPS：
server {
listen 80;
server_name npm.mycompany.com;
location / {
proxy_pass http://localhost:4873;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
2. 持久化与备份将Verdaccio的存储目录挂载到持久化路径，并定期备份storage和config.yaml，防止数据丢失。
可通过插件（如verdaccio-audit）记录操作日志，或集成LDAP/OAuth实现统一身份认证。
基本上就这些。Verdaccio上手快，适合中小团队快速搭建私有NPM服务。关键是配置好权限、命名空间和网络访问，后续维护成本很低。不复杂但容易忽略细节，比如包命名、registry设置和用户登录状态。
