离线环境下Node.js LTS 22.14.0的npm依赖安装问题求助

一、离线批量安装依赖（无需手动按顺序） #

1. 强制使用缓存完全离线安装 #

--prefer-cache仍会触发联网检查，需搭配--offline及其他禁用联网的参数：

• 先将所有tgz包加入npm缓存：

  npm cache add *.tgz
  

• 安装目标包时，强制仅从缓存读取，禁用所有联网操作：

  npm install -g packageA.tgz --offline --no-update-notifier --no-audit
  

  这组参数会彻底阻止npm发起任何网络请求，完全依赖本地缓存解析依赖。

2. 搭建本地目录仓库（适合大量包） #

如果有数百个包，手动维护缓存效率低，可创建本地目录作为npm源：

• 创建本地仓库目录，比如./local-npm-repo
• 将所有tgz包解压到该目录，每个包对应包名@版本号格式的子目录（例如lodash@4.17.21/）
• 配置npm使用该本地目录作为源：

  npm config set registry file:///absolute/path/to/local-npm-repo
  

• 之后直接正常安装目标包，npm会自动从本地目录解析依赖树：

  npm install -g packageA
  

二、将tgz包导入GitLab npm仓库 #

1. 创建GitLab访问令牌 #

登录GitLab服务器，进入用户设置→访问令牌，创建一个拥有write_package_registry权限的令牌，保存好令牌内容。

2. 配置npm关联GitLab仓库 #

替换命令中的占位符（YOUR_GROUP、PROJECT_ID、YOUR_TOKEN、GITLAB_SERVER）后执行：

# 配置特定scope的仓库（如果包带scope）
npm config set @YOUR_GROUP:registry https://GITLAB_SERVER/api/v4/projects/PROJECT_ID/packages/npm/
# 设置认证令牌
npm config set //GITLAB_SERVER/api/v4/projects/PROJECT_ID/packages/npm/:_authToken YOUR_TOKEN

3. 上传tgz包 #

• 单个包上传：

  npm publish packageA.tgz --registry https://GITLAB_SERVER/api/v4/projects/PROJECT_ID/packages/npm/
  

• 批量上传所有tgz包，可使用shell脚本：

  for file in *.tgz; do
    npm publish "$file" --registry https://GITLAB_SERVER/api/v4/projects/PROJECT_ID/packages/npm/
  done
  

4. 使用GitLab仓库安装包 #

上传完成后，配置npm默认使用GitLab仓库（或安装时指定）：

# 设置全局默认源
npm config set registry https://GITLAB_SERVER/api/v4/packages/npm/
# 或仅针对特定scope
npm config set @YOUR_GROUP:registry https://GITLAB_SERVER/api/v4/projects/PROJECT_ID/packages/npm/

之后即可正常执行npm install -g packageA，npm会自动从GitLab仓库拉取依赖。

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