如何在非NPM平台发布并管理Node.js私有包？

作为一个用Node.js做过不少项目，同时也熟悉Java+Maven的开发者，我完全理解你想要的那种私有包管理体验——不用把专有代码放到公共NPM，同时能像Maven私有仓库一样方便地管理、拉取依赖。结合你探索的内容和实际实践，整理出两种靠谱的方案：

一、搭建私有NPM仓库（最接近Maven私有仓库的方案） #

这是长期、规模化管理私有包的最优解，和你熟悉的Artifactory、Nexus逻辑完全一致：

• 常用工具：Verdaccio（轻量开源，一键部署）、Artifactory/Nexus（企业级，支持多仓库管理、权限控制）
• 核心配置：在项目的.npmrc文件里指定私有仓库地址，让npm优先从私有仓库拉取依赖，找不到再去公共NPM仓库，比如：

  # 全局指定私有仓库
  registry=https://your-private-registry.com/
  
  # 或者只让特定 scope 的包走私有仓库（更安全）
  @your-team:registry=https://your-private-registry.com/
  

• 发布流程：和公共NPM一样，在包目录执行npm publish，就能把包推送到私有仓库，后续其他项目直接通过包名+版本号引入即可，完全和Maven发布JAR到私有仓库的流程对齐。

二、手动tar包管理（轻量灵活的小团队方案） #

如果你的团队规模不大，或者只是临时需要管理几个私有包，你探索的tar包方案非常实用，步骤清晰且不需要额外搭建服务：

• 步骤1：创建并开发私有包
  在包目录执行npm init完成初始化，开发完功能后，确保package.json里的name、version、dependencies等信息准确无误。
• 步骤2：规范版本管理
  用npm自带的版本命令维护语义化版本，比手动改package.json更靠谱：
  • 主版本升级（不兼容API变更）：npm version major
  • 次版本升级（新增兼容功能）：npm version minor
  • 补丁版本升级（bug修复）：npm version patch
    也可以直接指定具体版本：npm version 1.2.3
• 步骤3：打包成tarball
  在包目录执行npm pack，会生成一个类似foo-bar-1.2.3.tgz的压缩包，这个包包含了所有必要的代码和依赖声明，相当于Maven里的JAR文件。
• 步骤4：存储私有包
  把生成的tgz文件上传到内部服务器、Artifactory或者其他私有存储服务，和你上传JAR到Maven私有仓库的操作一致。
• 步骤5：安装私有包
  有两种便捷方式：
  1. 本地安装：如果已经下载了tgz文件，直接执行：

     npm install --save ./path/to/foo-bar-1.2.3.tgz
     

  2. 从内部服务器拉取：直接通过URL安装，支持指定版本（只要服务器能正确返回对应版本的包）：

     npm install --save https://your-internal-repo.com/packages/foo-bar-1.2.3.tgz
     

  另外，你也可以直接在package.json的dependencies里指定私有包的URL，比如：

  {
    "dependencies": {
      "foo-bar": "https://your-internal-repo.com/packages/foo-bar-1.2.3.tgz"
    }
  }
  

  执行npm install时，npm会自动从指定URL拉取包，并且会根据包的package.json自动安装所有依赖（亲测有效，只要依赖的包能从你配置的仓库里获取到）。

方案选择建议 #

• 若团队规模大、需要完善的权限控制、版本追溯、依赖缓存，优先选私有NPM仓库；
• 若只是小团队或临时需求，手动tar包管理足够灵活，零额外服务成本。

内容的提问来源于stack exchange，提问作者Jeach