Skip to content

Cấu hình gương cho NVM

Khi sử dụng NVM để cài đặt Node.js, bạn có thể gặp tốc độ tải xuống chậm, đặc biệt là ở một số khu vực địa lý. Cấu hình gương có thể cải thiện đáng kể tốc độ tải xuống bằng cách sử dụng các máy chủ gần vị trí của bạn hơn.

Tại sao sử dụng gương?

  • Tải xuống nhanh hơn: Các gương nằm gần bạn có thể cung cấp tốc độ tải xuống tốt hơn
  • Độ tin cậy được cải thiện: Các gương thay thế có thể giúp khi các máy chủ chính thức gặp sự cố
  • Bỏ qua các hạn chế mạng: Một số mạng có thể có hạn chế truy cập một số miền

Cấu hình gương cho Windows (nvm-windows)

NVM for Windows cung cấp các lệnh để đặt gương cho cả tải xuống Node.js và npm.

Đặt gương Node.js

bash
nvm node_mirror <url>

Ví dụ:

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

Đặt gương npm

bash
nvm npm_mirror <url>

Ví dụ:

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

Xác minh cài đặt gương

Các cài đặt gương được lưu trong tệp settings.txt trong thư mục cài đặt NVM của bạn, thường tại:

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

Bạn có thể kiểm tra tệp này để xác minh cài đặt gương của mình:

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/

Cấu hình gương cho Linux/macOS (nvm-sh)

Đối với nvm-sh trên Linux và macOS, bạn có thể đặt gương bằng cách sử dụng biến môi trường trong tệp profile shell của bạn.

Đặt gương Node.js

Thêm dòng sau vào tệp profile shell của bạn (~/.bashrc, ~/.zshrc, v.v.):

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

Đặt gương npm

Thêm dòng sau vào tệp profile shell của bạn:

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

Áp dụng các thay đổi

Sau khi thêm các dòng này, áp dụng các thay đổi:

bash
source ~/.bashrc  # hoặc ~/.zshrc, v.v.

Gương được khuyến nghị

Dưới đây là một số gương phổ biến bạn có thể sử dụng:

Gương toàn cầu

  • Node.js chính thức: https://nodejs.org/dist
  • npm chính thức: https://registry.npmjs.org

Gương khu vực Trung Quốc

  • npmmirror (trước đây là 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/

Gương khu vực Châu Âu

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

Sử dụng gương tạm thời

Nếu bạn muốn sử dụng gương chỉ cho một lần cài đặt mà không thay đổi cấu hình của mình:

Đối với nvm-sh (Linux/macOS)

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

Khắc phục sự cố gương

Gương kết nối timeout

Nếu bạn gặp timeout khi kết nối với gương:

  1. Kiểm tra kết nối internet của bạn
  2. Thử một gương khác
  3. Xác minh URL gương là chính xác và cập nhật

URL gương không hợp lệ

Nếu NVM báo cáo URL gương không hợp lệ:

  1. Đảm bảo URL kết thúc bằng dấu gạch chéo (/) nếu được yêu cầu
  2. Xác minh định dạng URL (nên là http:// hoặc https://)
  3. Kiểm tra xem gương có còn hoạt động không

Vấn đề đồng bộ hóa gương

Gương có thể không được đồng bộ hóa ngay lập tức với các kho lưu trữ chính thức. Nếu bạn không thể tìm thấy phiên bản Node.js rất gần đây:

  1. Thử sử dụng kho lưu trữ Node.js chính thức
  2. Đợi vài giờ để gương đồng bộ hóa
  3. Thử một gương khác có thể được cập nhật thường xuyên hơn

Khôi phục gương mặc định

Windows (nvm-windows)

Để khôi phục gương mặc định, đặt chúng trở lại URL chính thức:

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

Linux/macOS (nvm-sh)

Để khôi phục gương mặc định, xóa các biến môi trường khỏi tệp profile shell của bạn và source lại:

bash
# Xóa các dòng này khỏi ~/.bashrc hoặc ~/.zshrc của bạn
# export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
# export NVM_NPM_MIRROR=https://npmmirror.com/mirrors/npm

# Sau đó source tệp profile của bạn
source ~/.bashrc  # hoặc ~/.zshrc, v.v.

Các bước tiếp theo

Sau khi cấu hình gương, bạn có thể tiếp tục:

NVM - Trình quản lý phiên bản Node cho Windows, Linux và macOS