Cấu hình Proxy cho npm không nên bắt đầu bằng việc cài thử một gói ngẫu nhiên. Hãy kiểm tra registry và đọc thông tin gói trước, rồi mới cân nhắc thao tác làm thay đổi dự án. Cách làm này giúp tách lỗi mạng khỏi lỗi phụ thuộc hoặc script cài đặt.
Nếu cần tuyến kết nối cho ứng dụng phát triển được phép, có thể tham khảo Proxy dân cư ProxySmart. Hãy xác nhận endpoint, giao thức và phương thức xác thực thực tế trước khi dùng; một proxy hoạt động trong trình duyệt chưa chứng minh npm đã nhận đúng thiết lập.
1. Xác định môi trường npm đang dùng
Ghi lại phiên bản Node.js, npm, hệ điều hành và nơi chạy lệnh: terminal, IDE, container hay CI. Các môi trường có thể dùng cấu hình và biến khác nhau. Hướng dẫn này đối chiếu tài liệu npm CLI v12; máy dùng phiên bản khác cần kiểm tra trợ giúp tương ứng, không nâng cấp chỉ để sao chép ví dụ.
Không lấy kết quả từ trình duyệt, Git hay một ứng dụng Node.js khác làm kết luận cho npm. Nếu dự án tải phụ thuộc qua Git HTTPS, còn cần xem cấu hình Proxy cho Git HTTPS; đó là luồng riêng, không tự được kiểm chứng bởi một lần npm ping.
Chọn một thư mục thử được phép, không chứa bí mật của khách hàng. Với máy công ty, kiểm tra chính sách kết nối trước khi thay proxy; không dùng bài hướng dẫn để bỏ qua registry hoặc tuyến mạng bắt buộc của tổ chức.
2. Phân biệt registry với proxy
Registry là nơi npm hỏi thông tin và lấy gói; proxy là một chặng trung gian của kết nối. Thay registry không đồng nghĩa với cấu hình proxy. Không chuyển dự án sang một registry lạ chỉ vì registry hiện tại đang gặp lỗi kết nối.
Trong npm, proxy dành cho yêu cầu HTTP, https-proxy dành cho HTTPS; noproxy xác định miền bỏ qua proxy. Xem định nghĩa tại tài liệu cấu hình npm. Tên https-proxy không có nghĩa endpoint được cấp bắt buộc mang tiền tố HTTPS.
Các ví dụ dùng http://proxy.example:8080 và https://registry.example/ là địa chỉ giữ chỗ. Phải thay bằng thông tin được phép. HTTPS tới registry không tự bảo vệ thông tin xác thực trên chặng HTTP tới proxy; không coi hai chặng này là cùng một lớp mã hóa.
3. Đọc cấu hình trước khi thay đổi
File .npmrc có phạm vi dự án, người dùng, toàn cục và cấu hình tích hợp. Một file trong dự án không thay thế mọi nguồn cấu hình, nhất là khi có biến môi trường hoặc cờ dòng lệnh.
Trước khi xem đầu ra, nhớ rằng URL proxy cũ có thể chứa mật khẩu. Chỉ đọc tại máy và che bí mật trước khi nhờ hỗ trợ. npm config get cho phép hỏi các khóa cụ thể thay vì gửi toàn bộ cấu hình.
npm config get registry
npm config get proxy
npm config get https-proxy
npm config get noproxyGiá trị rỗng hoặc null chưa đủ chứng minh đang kết nối trực tiếp; còn cần kiểm tra môi trường và ngoại lệ mạng. Không xóa hàng loạt .npmrc, không đặt cấu hình toàn cục mặc định để thử. Nếu phải lưu lâu dài, chọn phạm vi nhỏ và ghi lại giá trị cũ.
4. Thử registry bằng npm ping
npm ping kiểm tra registry được chỉ định, không phải ICMP ping tới host proxy. Ví dụ sau truyền cấu hình cho lần gọi, không lưu endpoint vào .npmrc. Không chạy nguyên mẫu với tên miền giữ chỗ.
npm ping --registry=https://registry.example/ --https-proxy=http://proxy.example:8080 --proxy=http://proxy.example:8080Lệnh tạo yêu cầu mạng và có thể ghi log. Nếu endpoint cần xác thực mà môi trường chưa được chuẩn bị, phép thử có thể thất bại. Không khắc phục bằng cách ghép mật khẩu vào đối số; dùng cơ chế quản lý bí mật đã được tổ chức chấp thuận.
Kết quả thành công không tự chứng minh lưu lượng đi qua proxy: ngoại lệ noproxy có thể áp dụng. Đối chiếu tuyến thực tế bằng phương tiện được quản trị viên cho phép. Không tự thêm miền vào danh sách bỏ qua để né chính sách, cũng không xóa ngoại lệ nội bộ một cách mò mẫm.
5. Đọc metadata bằng npm view
Sau bước kiểm tra registry, chọn tên một gói đã được duyệt tại chính registry đó. approved-package dưới đây chỉ là tên minh họa, không phải khuyến nghị cài đặt hay tên gói được xác nhận tồn tại.
npm view approved-package version --registry=https://registry.example/ --https-proxy=http://proxy.example:8080 --proxy=http://proxy.example:8080npm view với tên gói registry như ví dụ đọc trường metadata, không cài gói vào dự án. Nó vẫn có thể dùng mạng, cache và log; vì vậy không nên gọi đây là kiểm tra hoàn toàn không ghi dữ liệu.
Đọc được phiên bản mới chỉ xác nhận bước metadata. Tarball, registry riêng cho từng scope hoặc phụ thuộc từ Git có thể cần kiểm tra tiếp. Bài dùng Proxy với cURL và Python hỗ trợ đối chiếu khái niệm, nhưng cấu hình các công cụ không mặc nhiên đồng bộ.
6. Tách kiểm tra mạng khỏi cài gói
npm install có thể thay đổi node_modules, manifest hoặc lockfile tùy cách dùng. Đây không còn là phép kiểm tra kết nối nhỏ. Chỉ thực hiện khi đã xác nhận tên gói, nguồn, phiên bản và kế hoạch khôi phục dự án.
Quá trình cài đặt cũng có thể chạy lifecycle script của npm, tùy phiên bản và chính sách script. Không phê duyệt mọi script để xử lý lỗi mạng. Script có thể gọi công cụ hoặc tải tài nguyên riêng, nên ping thành công không bảo đảm toàn bộ cài đặt thành công.
Npm token dùng xác thực registry, không phải mật khẩu proxy. Không đặt token vào URL proxy, câu lệnh hay file được commit. Với CI, dùng kho bí mật của nền tảng theo quyền tối thiểu; không sao chép nguyên cấu hình cá nhân lên máy chạy chung.
7. Khoanh vùng lỗi 407, TLS và timeout
407: kiểm tra xác thực proxy
Xem lại tài khoản proxy, endpoint và IP được phép. Không thay npm token để xử lý một lỗi do proxy trả về. Tham khảo lỗi Proxy Authentication Required 407 để phân biệt đúng lớp xác thực trước khi thay đổi.
TLS: giữ xác minh chứng chỉ
Không đặt strict-ssl=false để bỏ cảnh báo. Kiểm tra hostname, thời gian hệ thống và chuỗi chứng chỉ. Nếu doanh nghiệp kiểm tra TLS, chỉ dùng CA được quản trị viên xác nhận; không tải chứng chỉ từ hướng dẫn không rõ nguồn.
Timeout, 404 hoặc lỗi phụ thuộc
Ghi thời điểm, bước thất bại và mã lỗi đã che dữ liệu. Timeout có thể cần kiểm tra tuyến mạng; 404 cần xem tên gói, registry hoặc quyền truy cập. Lỗi xung đột phụ thuộc không tự biến mất khi đổi IP; đừng dùng proxy để che nguyên nhân khác.
8. Checklist áp dụng cho dự án
- Đúng phiên bản npm, registry và môi trường thực thi.
- Endpoint, giao thức, xác thực và noproxy đúng chính sách.
- Ping và metadata đã kiểm tra, chưa nhầm với cài đặt hoàn chỉnh.
- TLS còn bật; bí mật không nằm trong lệnh hoặc repository.
- Phạm vi cấu hình và quy trình hoàn tác đã được ghi lại.
Khi trao đổi về gói Proxy dân cư cho công cụ phát triển, hãy nêu nhu cầu npm, loại registry và cách xác thực dự kiến. Chọn cấu hình sau khi kiểm tra luồng thực tế, không dựa riêng vào việc trình duyệt hiển thị một IP mới.