SuperAPI AI 工具集

nvm-mirror-and-auth

部署与运维

查看项目

更新于 10-16 07:52

技能介绍

用途

nvm-mirror-and-auth 用于在受限网络环境(如企业内网、代理环境)或需要认证的私有镜像场景下,配置 nvm 从自定义镜像下载 Node.js 二进制文件。当默认的官方下载源不可达或需要走内部镜像时,可通过本技能提供的环境变量完成配置。

主要能力

  • 通过环境变量 NVM_NODEJS_ORG_MIRROR 指定自定义 Node.js 二进制镜像地址,例如国内淘宝镜像 https://npmmirror.com/mirrors/node。
  • 通过环境变量 NVM_AUTH_HEADER 为需要认证的私有镜像设置认证请求头,例如 Authorization: Bearer <token>。
  • 提供镜像连通性验证方法:使用 curl 测试镜像 URL,以及安装后通过 node -v 确认下载成功。

使用方式

设置镜像地址:

# Use a custom mirror (e.g., Taobao mirror for China)
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

# Then install as normal
nvm install 20

配置认证头(当镜像需要认证时):

# Set auth header for private mirror access
export NVM_AUTH_HEADER="Authorization: Bearer <token>"
nvm install 20

验证镜像连通性:

# Test the mirror URL
curl -I "$NVM_NODEJS_ORG_MIRROR/v20.11.0/"

# Verify node downloads successfully
nvm install 20 && node -v

示例文件包括 examples/mirror.md(镜像 URL 配置)和 examples/mirror-auth-header.md(认证头设置)。

适用场景

  • 企业内网或代理环境下无法访问官方 Node.js 下载源。
  • 使用国内镜像加速 Node.js 版本安装。
  • 访问需要认证的私有 Node.js 二进制镜像。

限制

本技能仅处理镜像与认证配置,不包含 nvm 本身的安装步骤,安装步骤属于 nvm-install 技能。