Skip to content

Mengonfigurasi Mirror untuk NVM

Saat menggunakan NVM untuk menginstal Node.js, Anda mungkin mengalami kecepatan unduhan yang lambat, terutama di wilayah geografis tertentu. Mengonfigurasi mirror dapat secara signifikan meningkatkan kecepatan unduhan dengan menggunakan server yang lebih dekat dengan lokasi Anda.

Mengapa Menggunakan Mirror?

  • Unduhan lebih cepat: Mirror yang terletak lebih dekat dengan Anda dapat memberikan kecepatan unduhan yang lebih baik
  • Reliabilitas yang lebih baik: Mirror alternatif dapat membantu ketika server resmi mengalami masalah
  • Melewati pembatasan jaringan: Beberapa jaringan mungkin memiliki pembatasan mengakses domain tertentu

Konfigurasi Mirror untuk Windows (nvm-windows)

NVM untuk Windows menyediakan perintah untuk mengatur mirror untuk unduhan Node.js dan npm.

Mengatur Mirror Node.js

bash
nvm node_mirror <url>

Sebagai contoh:

bash
nvm node_mirror https://npmmirror.com/mirrors/node/

Mengatur Mirror npm

bash
nvm npm_mirror <url>

Sebagai contoh:

bash
nvm npm_mirror https://npmmirror.com/mirrors/npm/

Memverifikasi Pengaturan Mirror

Pengaturan mirror disimpan dalam file settings.txt di direktori instalasi NVM Anda, biasanya di:

C:\Users\<username>\AppData\Roaming\nvm\settings.txt

Anda dapat memeriksa file ini untuk memverifikasi pengaturan mirror Anda:

root: C:\Users\<username>\AppData\Roaming\nvm
path: C:\Program Files\nodejs
node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/

Konfigurasi Mirror untuk Linux/macOS (nvm-sh)

Untuk nvm-sh di Linux dan macOS, Anda dapat mengatur mirror menggunakan variabel lingkungan di file profil shell Anda.

Mengatur Mirror Node.js

Tambahkan baris berikut ke file profil shell Anda (~/.bashrc, ~/.zshrc, dll.):

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

Mengatur Mirror npm

Tambahkan baris berikut ke file profil shell Anda:

bash
export NVM_NPM_MIRROR=https://npmmirror.com/mirrors/npm

Menerapkan Perubahan

Setelah menambahkan baris-baris ini, terapkan perubahan:

bash
source ~/.bashrc  # atau ~/.zshrc, dll.

Mirror yang Direkomendasikan

Berikut adalah beberapa mirror populer yang dapat Anda gunakan:

Mirror Global

  • Node.js Resmi: https://nodejs.org/dist
  • npm Resmi: https://registry.npmjs.org

Mirror Wilayah China

  • npmmirror (sebelumnya CNPM):

    • Node.js: https://npmmirror.com/mirrors/node/
    • npm: https://npmmirror.com/mirrors/npm/
  • Tencent Cloud:

    • Node.js: https://mirrors.cloud.tencent.com/nodejs-release/
  • Huawei Cloud:

    • Node.js: https://repo.huaweicloud.com/nodejs/
    • npm: https://repo.huaweicloud.com/repository/npm/

Mirror Wilayah Eropa

  • NodeSource:
    • Node.js: https://deb.nodesource.com/node/

Penggunaan Mirror Sementara

Jika Anda ingin menggunakan mirror hanya untuk satu instalasi tanpa mengubah konfigurasi Anda:

Untuk nvm-sh (Linux/macOS)

bash
NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node nvm install 18.16.0

Pemecahan Masalah Mirror

Timeout Koneksi Mirror

Jika Anda mengalami timeout saat terhubung ke mirror:

  1. Periksa koneksi internet Anda
  2. Coba mirror yang berbeda
  3. Verifikasi URL mirror benar dan terbaru

URL Mirror Tidak Valid

Jika NVM melaporkan URL mirror tidak valid:

  1. Pastikan URL diakhiri dengan garis miring (/) jika diperlukan
  2. Verifikasi format URL (harus http:// atau https://)
  3. Periksa apakah mirror masih beroperasi

Masalah Sinkronisasi Mirror

Mirror mungkin tidak langsung disinkronkan dengan repositori resmi. Jika Anda tidak dapat menemukan versi Node.js yang sangat baru:

  1. Coba gunakan repositori Node.js resmi
  2. Tunggu beberapa jam agar mirror disinkronkan
  3. Coba mirror yang berbeda yang mungkin diperbarui lebih sering

Memulihkan Mirror Default

Windows (nvm-windows)

Untuk memulihkan mirror default, atur kembali ke URL resmi:

bash
nvm node_mirror https://nodejs.org/dist/
nvm npm_mirror https://github.com/npm/cli/archive/

Linux/macOS (nvm-sh)

Untuk memulihkan mirror default, hapus variabel lingkungan dari file profil shell Anda dan source lagi:

bash
# Hapus baris-baris ini dari ~/.bashrc atau ~/.zshrc Anda
# export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
# export NVM_NPM_MIRROR=https://npmmirror.com/mirrors/npm

# Kemudian source file profil Anda
source ~/.bashrc  # atau ~/.zshrc, dll.

Langkah Selanjutnya

Setelah mengonfigurasi mirror, Anda dapat melanjutkan ke:

NVM - Manajer Versi Node untuk Windows, Linux, dan macOS