Bật hỗ trợ proxy tích hợp của Node khi khởi động

Dùng công tắc proxy môi trường của Node với ngưỡng phiên bản fetch và http/https chính xác và hiểu phạm vi khách hàng của nó.

Node có thể tự đọc các biến môi trường proxy khi hỗ trợ tích hợp của nó được bật lúc khởi động tiến trình. Các khách hàng khả dụng phụ thuộc vào phiên bản runtime:

  • fetch tích hợp hỗ trợ NODE_USE_ENV_PROXY từ Node 24.0.0, có bản backport sang 22.21.0.
  • Hỗ trợ tích hợp node:http và node:https thông qua các tác nhân toàn cục mặc định của chúng bắt đầu từ 24.5.0, cũng được backport sang 22.21.0.
  • Công tắc dòng lệnh --use-env-proxy bắt đầu từ 24.5.0 và 22.21.0.

Trên một bản phát hành tương thích, ví dụ POSIX-shell này đặt một proxy HTTP doanh nghiệp cho cả hai lược đồ đích:

export HTTP_PROXY=http://proxy.example.net:8080
export HTTPS_PROXY=http://proxy.example.net:8080
export NO_PROXY=localhost,127.0.0.1,.internal.example

node --use-env-proxy app.js

Tên HTTPS_PROXY chọn tuyến cho các đích HTTPS; URL vẫn có thể nêu tên một proxy HTTP. Điều chỉnh NO_PROXY cho các đích cần bỏ qua nó. Để kiểm tra URL công khai độc lập mà không có tài khoản proxy, một mục HTTP từ danh sách proxy HTTP có thể cung cấp cả hai giá trị proxy trong khi các đường vòng nội bộ cần thiết vẫn được giữ.

Dạng công tắc môi trường là một lựa chọn thay thế:

export NODE_USE_ENV_PROXY=1
node app.js

Đặt các biến định tuyến trước khi khởi chạy Node với một trong hai dạng. Gán cờ opt-in cho process.env sau khi khởi động không chạy lại quá trình khởi tạo khởi động.

Kiểm tra khách hàng HTTP thực sự đang được dùng

Các tác nhân toàn cục mặc định có liên quan đến các lệnh gọi http và https sử dụng chúng. Một thư viện có tác nhân hoặc bộ điều phối tùy chỉnh riêng sẽ kiểm soát vận chuyển của chính nó; ổ cắm TCP thô nằm ngoài tính năng định tuyến HTTP này. Đối với một khách hàng Undici tương thích, một bộ điều phối ProxyAgent rõ ràng là một giao diện riêng cục bộ trong khách hàng.

Nếu một ứng dụng thay thế tác nhân toàn cục, hãy kiểm tra sự thay thế đó trước khi cho rằng nó giữ nguyên hành vi proxy khi khởi động. Tương tự, cấu hình registry của npm là một thiết lập công cụ riêng và không chứng minh cách app.js định tuyến yêu cầu.

Đối với yêu cầu tin cậy TLS của doanh nghiệp, hãy cấu hình CA tin cậy phù hợp cho runtime. Bật định tuyến proxy không đòi hỏi phải tắt xác minh chứng chỉ.

Bài viết liên quan