如何离线安装 npm 包
通过 npm pack 生成 .tgz 压缩包,再使用 npm install 进行本地安装。此方法适用于无法连接外网的服务器或内网环境,能够确保依赖包的完整性。

具体操作分为两步:首先在联网机器上进入目标项目目录,执行 npm pack 命令,该命令会将当前包及其元数据打包为一个以 .tgz 结尾的文件。然后将生成的文件传输到离线机器,在需要安装该包的项目目录下运行 npm install ./package-name-1.0.0.tgz。如果包有子依赖,需确保这些子依赖也已打包或存在于离线环境的缓存中。
cd /path/to/package npm pack # 输出: my-package-1.0.0.tgz # 在离线机器上 cd /path/to/project npm install /path/to/my-package-1.0.0.tgz
执行后,node_modules 中将出现该包,且 package.json 中的版本字段会更新为指向本地文件的路径。若需固定版本号,可在安装时指定 @version,但通常直接安装 tgz 文件即可满足需求。
如何处理带有子依赖的包离线安装
对于包含子依赖的包,仅打包主包会导致运行时缺失依赖。应使用 npm pack --all-versions 或手动收集所有依赖的 tgz 文件,并在离线环境中一次性安装。

当包依赖其他内部模块或第三方库时,npm pack 默认只打包当前包本身,不包含其 dependencies 和 devDependencies。因此,需要在联网机器上预先下载所有相关依赖的 tgz 文件。可以使用 npm view 获取每个依赖的下载地址,或使用脚本批量生成。在离线机器上,将所有 tgz 文件放在同一目录,然后执行 npm install *.tgz,npm 会自动解析并安装所有依赖。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
# 联网机器上,假设依赖为 lodash 和 express npm pack lodash npm pack express # 离线机器上 cd /path/to/offline_dir npm install *.tgz
这种方式确保了所有依赖都被正确安装,避免了因缺少子依赖而导致的启动错误。注意,如果依赖之间存在版本冲突,可能需要手动调整 package.json 中的版本范围,以确保兼容性。
离线安装后如何验证包的正确性
安装完成后,通过运行项目的测试套件或检查 node_modules 中的文件结构来验证包是否正确安装。重点检查入口文件和依赖链是否完整。
在离线环境中安装完包后,首要任务是确认包能否被正常引用。可以编写一个简单的脚本来 require 该包,观察是否有报错。例如,创建一个 test.js 文件,内容如下:
const pkg = require('my-package');
console.log(pkg.version); // 应输出安装的版本号
如果控制台输出了预期的版本号,说明包已成功安装并可访问。此外,检查 node_modules/my-package 目录下的 index.js 或 main 指定的入口文件是否存在,以及其引用的子依赖是否也在 node_modules 中。若发现缺失,需重新补充对应的 tgz 文件并再次安装。此步骤是确保离线部署稳定性的关键。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










