淘宝 NPM 镜像站新旧域名切换规则

正如在 《淘宝 NPM 镜像站喊你切换新域名啦》 中预告的那样：

npm.taobao.org 和 registry.npm.taobao.org 将在 2022.06.30 正式下线和停止 DNS 解析。

域名切换规则：

npm.taobao.org => npmmirror.com
registry.npm.taobao.org => registry.npmmirror.com

因此，有强依赖老域名的各位开发者请尽快更新到新域名，可能受到的影响和处理方式：

• 企业用户需要联系 网管/IT/SRE 更新防火墙白名单。
• 存量应用的 lock 文件，开发者需要自行执行 sed 等指令去替换或重新生成。
• 本地 npmrc 里面的 registry 地址（如果有，则）需要开发者自行更新。
• 开发者自己的 CL 工具 或 平台应用 里面写死的地址，需开发者自己更新并部署。
• cnpm cli / nrm 等工具，对应的社区同学已经提 PR 更新，大家重新安装最新版本即可。

NPM 镜像源的配置文件路径

.npmrc，全称 npm running cnfiguration，即 npm 运行时配置文件。简单点说，.npmrc可以设置 package.json 中依赖包的安装来源。

• 项目的 npm 配置文件路径 ./<PROJECT_DIR>/.npmrc
• 用户的 npm 配置文件路径 C:/Users/<USER_NAME>/.npmrc
• 内置的 npm 配置文件路径 ./<PATH_TO_NODEJS>/node_modules/npm/.npmrc

设置 NPM 镜像源的方法

网上有大量关于使用命令设置 npm 镜像源的教程，但本人并不推荐使用命令进行设置，更好的方法是直接在项目文件夹或 npm 的安装目录下建立.npmrc文件。.npmrc的内容如下（可根据实际情况配置自己常用的模块的镜像地址）：

Tips：
尤其是在开发公司内部的项目时，部分 Node 的依赖项可能需要配置公司的私有 NPM 镜像源，此时配置.npmrc文件可以将公司的开发环境与自己的其它开发环境进行隔离。

registry=https://registry.npmmirror.com/
disturl=https://npmmirror.com/mirrors/node/
sass-binary-site=https://npmmirror.com/mirrors/node-sass/
sharp_dist_base_url=https://npmmirror.com/mirrors/sharp-libvips/
electron_mirror=https://npmmirror.com/mirrors/electron/
puppeteer_download_host=https://npmmirror.com/mirrors/
phantomjs_cdnurl=https://npmmirror.com/mirrors/phantomjs/
sentrycli_cdnurl=https://npmmirror.com/mirrors/sentry-cli/
sqlite3_binary_site=https://npmmirror.com/mirrors/sqlite3/
python_mirror=https://npmmirror.com/mirrors/python/

如果只是想临时下载某个依赖项时使用镜像源，可在执行npm命令时使用--registry参数

npm install <依赖项的名称> --registry=https://registry.npmmirror.com

如果使用 NVM 来管理多个 Node.js 环境，则应该在安装完 NVM 后，修改安装目录下的settings.txt文件，添加以下内容：

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