国内怎么加速下载 Node.js？常用镜像源汇总

一、区分两个概念：Node.js 安装包镜像与 npm 依赖源

在解决下载慢的问题前，首先需要厘清许多初学者容易混淆的两个不同对象：Node.js 运行时本身的安装文件与项目依赖的 npm 包。

Node.js 官方发布的所有可执行安装包（如 Windows 的 .msi、macOS 的 .pkg，以及 Linux 的预编译压缩包 .tar.gz）统一存放在 nodejs.org/dist/ 目录下。国内加速 Node.js 本身下载，本质上是加速对该 Dist 目录的访问。

而平时执行 npm install express 所下载的是代码依赖包，数据来自 npm Registry 仓库（官方地址为 registry.npmjs.org）。如果在终端里只配置了 npm config set registry ...，这仅对后续下载第三方库生效，完全不会加速 Node.js 安装包本身或 nvm install 的过程。

二、常用国内 Node.js 官方镜像源地址汇总

国内有多家大型云厂商和顶尖高校维护了对 nodejs.org/dist/ 的镜像同步。这些镜像源完整保留了官方的目录层级和文件哈希校验值，以下是当前主流且长期稳定运行的镜像源清单：

三、不同安装方式下的镜像加速配置实操

了解镜像源地址后，需要根据你当前采用的安装方式，将对应的镜像地址注入到下载流程中。以下按最常见的使用场景逐一演示。

1. 官网安装包直接下载（浏览器 / curl / wget）

如果你不需要频繁切换版本，只需在电脑上安装单个固定的 Node.js 版本，可以直接在浏览器中打开任一镜像站目录：

• 直接在浏览器访问：https://npmmirror.com/mirrors/node/
• 进入对应版本的子目录，例如长期支持版（LTS）目录 latest-v20.x/ 或具体版本号 v20.18.0/。
• Windows 用户点击下载 node-v20.18.0-x64.msi；macOS 用户点击下载 node-v20.18.0.pkg；Linux 用户下载 node-v20.18.0-linux-x64.tar.gz。

通过国内 CDN 节点下载，文件下载速度通常可以达到宽带峰值，彻底告别数十 KB/s 的龟速等待。

2. nvm (macOS / Linux) 镜像加速配置

在 Linux 或 macOS 上使用 nvm 时，它默认从官方域名下载 Node 二进制包。通过设定环境变量 NVM_NODEJS_ORG_MIRROR，即可切换下载源。

临时生效（当前终端会话）：

export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

永久生效（推荐）：

将上述环境变量追加至当前 Shell 的启动配置文件中（macOS 默认通常为 ~/.zshrc，Linux 常见为 ~/.bashrc）：

# 如果使用的是 zsh (macOS 默认)
echo 'export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node' >> ~/.zshrc
source ~/.zshrc

# 如果使用的是 bash (Linux 常见)
echo 'export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node' >> ~/.bashrc
source ~/.bashrc

执行安装与验证：

nvm install 20

3. nvm-windows 镜像加速配置

Windows 平台的 nvm-windows 内部实现与 shell 版本的 nvm 不同，它通过自身的 settings.txt 配置文件管理下载镜像。

方式 A：通过命令行直接设置（推荐）

以管理员权限或普通用户打开 PowerShell 或 CMD，分别执行以下两行命令：

nvm node_mirror https://npmmirror.com/mirrors/node/
nvm npm_mirror https://npmmirror.com/mirrors/npm/

方式 B：直接编辑 settings.txt

打开 nvm-windows 的安装目录（默认通常在 %APPDATA% vm\settings.txt 或 C: vm\settings.txt），在末尾增加或修改以下两行配置：

node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/

配置保存后，在控制台运行 nvm install 20，便会直接从国内镜像下载对应的压缩包。如果希望一并设置华为云作为备选，只需将上述地址替换为 https://repo.huaweicloud.com/nodejs/ 即可。

4. fnm (Fast Node Manager) 镜像加速配置

fnm 是基于 Rust 编写的高性能 Node 版本管理工具。fnm 原生支持 --node-dist-mirror 参数和环境变量 FNM_NODE_DIST_MIRROR。

单次执行命令：

fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

全局持久化配置：

# macOS / Linux (在 ~/.zshrc 或 ~/.bashrc 末尾添加)
export FNM_NODE_DIST_MIRROR="https://npmmirror.com/mirrors/node"

# Windows PowerShell (在 $PROFILE 中添加)
$env:FNM_NODE_DIST_MIRROR = "https://npmmirror.com/mirrors/node"

5. n 版本管理器配置

如果使用的是 npm 生态下的 n 模块，只需指定 NODE_MIRROR 环境变量：

export NODE_MIRROR=https://npmmirror.com/mirrors/node/
n lts

四、常见问题与排查指南

即使配置了镜像源，在某些网络环境或系统配置下仍可能出现报错。以下是排查高频问题的步骤与处理方案：

1. 配置了环境变量后，终端依然向 nodejs.org 发送请求

排查方法：在当前终端中执行 echo $NVM_NODEJS_ORG_MIRROR（Windows CMD 对应 echo %NVM_NODEJS_ORG_MIRROR%）。如果返回为空，说明配置尚未加载。

解决办法：确认配置文件是否保存正确；新开一个终端窗口，或者在当前终端执行 source ~/.zshrc（以实际使用的 shell 配置文件为准）。如果使用的是 VS Code 等内置终端，修改环境变量后需要彻底重启编辑器进程。

2. 提示 404 Not Found 或找不到对应版本

排查方法：官方刚刚发布的全新版本（如最新 release 几分钟内），国内镜像站可能仍在同步队列中。此外，请检查配置中镜像地址的结尾是否遗漏了 /。

解决办法：直接使用浏览器访问该镜像站网页，检索目标版本是否已同步完成。若暂未同步，可快速换用华为云（https://repo.huaweicloud.com/nodejs/）或中科大镜像作为备用通道。

3. 遇到 self-signed certificate in certificate chain 或 SSL 握手失败

排查方法：常见于企业内网、具备安全审计的代理网关或开启了本地中间人代理软件的环境。

解决办法：检查终端是否残留失效的代理变量（执行 env | grep -i proxy）。如果存在失效代理，执行 unset HTTP_PROXY HTTPS_PROXY http_proxy https_proxy 清除残留。在可信内网环境中，若因自签名证书阻断，可将镜像站地址临时降级为 http:// 协议排查连通性。

五、总结与快速配置速查卡

加速 Node.js 下载的关键，是针对具体工具正确配置 Node.js Dist 镜像地址。下表汇总了最常用的配置命令，方便快速复制：

在完成 Node.js 自身的安装之后，如果需要在后续开发中加速 npm install 安装第三方依赖库，可再行配置 npm registry：npm config set registry https://registry.npmmirror.com。两者搭配使用，即可全面打通国内 Node.js 全流程开发网络加速。