nvm-mirror-and-auth

nvm Mirror and Authentication

Configure nvm to download Node.js binaries from custom mirrors in restricted network environments.

Workflow

1. Set the mirror URL via environment variable:

   # 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
   

1. Configure authentication headers if the mirror requires auth:

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

2. Validate mirror connectivity:

   # Test the mirror URL
   curl -I "$NVM_NODEJS_ORG_MIRROR/v20.11.0/"
   
   # Verify node downloads successfully
   nvm install 20 && node -v
   

Note: Installation steps are in nvm-install. This skill handles only mirror and auth configuration.

Example file map

• examples/mirror.md - Mirror URL configuration
• examples/mirror-auth-header.md - Authentication header setup

Keywords

node mirror, NVM_NODEJS_ORG_MIRROR, auth header, restricted network, corporate proxy, private mirror