企业内部搭建私有 npm 镜像首选 verdaccio，通过 docker 快速部署，配置上游镜像、权限认证与存储持久化；结合 nginx 反向代理、多实例共享存储、定时备份及 prometheus 监控实现生产就绪；统一通过 .npmrc、ci 配置和一键脚本推动团队接入。
企业内部搭建私有 npm 镜像，核心目标是实现依赖加速、安全可控、离线可用和合规管理。不推荐直接复刻官方 registry，而是选用成熟方案快速落地——Verdaccio 是目前最轻量、易维护、社区活跃的首选。
选型与部署：用 Verdaccio 快速启动
Verdaccio 基于 Node.js，无需数据库即可运行，支持插件扩展，适合中小到大型团队。推荐使用 Docker 部署，避免环境差异：
- 拉取镜像并启动（挂载配置与存储）：
docker run -d -p 4873:4873 \<br> -v $(pwd)/verdaccio/conf:/verdaccio/conf \<br> -v $(pwd)/verdaccio/storage:/verdaccio/storage \<br> --name verdaccio verdaccio/verdaccio
- 关键配置文件 conf.yaml 示例：
设置上游为https://registry.npmmirror.com（新淘宝源），启用缓存；
关闭匿名发布，强制登录；
指定 storage 路径为挂载卷，确保包持久化。
权限与安全：控制谁可以读、写、删
默认配置下所有用户可读，但发布需认证。企业级使用必须加固：
- 启用内置 htpasswd 认证：
生成用户文件：npm install -g htpasswd→htpasswd -c ./htpasswd admin - 在 conf.yaml 中配置：
auth:<br> htpasswd:<br> file: ./htpasswd<br> max_users: 1000
- 按作用域（scope）划分权限，例如：
packages:<br> '@mycompany/*':<br> access: $authenticated<br> publish: admin<br> '**':<br> access: $all<br> publish: $authenticated
生产就绪：高可用与运维保障
单节点够用，但关键业务建议加一层防护：
- 用 Nginx 做反向代理 + HTTPS 终止，添加 basic auth 或 IP 白名单作为前置网关
- 多实例共享同一 NAS 或对象存储（如 MinIO）作为 backend，配合 Nginx 负载均衡
- 每日定时备份：
tar -czf verdaccio-backup-$(date +%F).tgz storage/ conf/，存至内网备份服务器 - 监控基础指标：用 Prometheus 抓取 Verdaccio 内置的
/metrics端点，关注 4xx/5xx 错误率、存储使用率、同步延迟
团队接入：统一配置，避免手动出错
让所有开发者自动使用私有源，而不是靠口头提醒：
- 在项目根目录放 .npmrc 文件：
registry=https://npm.internal.company.com/<br>always-auth=true
- CI/CD 流水线中全局配置（如 GitLab CI）：
before_script:<br> - npm config set registry https://npm.internal.company.com<br> - npm config set //npm.internal.company.com/:_authToken $NPM_TOKEN
- 提供一键脚本供新成员初始化：
curl -sL https://npm.internal.company.com/setup.sh | bash，自动写入 .npmrc 并测试连通性
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
