Dùng proxy trong Node.js: fetch, axios, got và SOCKS5 có tài khoản, mật khẩu
Trong bài này
Node.js không tự gửi request qua proxy nếu bạn không bảo nó. Cách đơn giản nhất hiện nay là ProxyAgent của undici cùng với fetch của chính undici, nhận tài khoản và mật khẩu ngay trong URL dạng http://USER:PASS@HOST:PORT. axios có tùy chọn proxy riêng, got nhận agent proxy, còn SOCKS5 chạy qua socks-proxy-agent. Mọi ví dụ dưới đây đã được chạy thử ngày 18/11/2026 với Node.js 24 qua một proxy thử nghiệm có yêu cầu mật khẩu.
Nên dùng cách nào?
| Bạn dùng | Cài gói | Ghi chú |
|---|---|---|
fetch |
undici |
Lấy cả fetch lẫn ProxyAgent từ undici |
| Không cài thêm gói | Không cần | NODE_USE_ENV_PROXY=1, vẫn đang thử nghiệm |
| axios | axios |
Tùy chọn proxy; website HTTPS cần axios 1.16.1 trở lên |
| got | got, hpagent |
got 16 chỉ chạy dạng ESM và cần Node 22 |
| Cổng SOCKS5 | socks-proxy-agent |
Dùng socks5h:// để proxy tự phân giải tên miền |
Mỗi ví dụ đọc proxy từ biến môi trường PROXY, để mật khẩu không nằm trong code. Lưu file với đuôi .mjs để dùng được import.
fetch với undici
Cài bằng npm install undici:
import { fetch, ProxyAgent } from "undici";
const proxy = new ProxyAgent(process.env.PROXY); // http://USER:PASS@HOST:PORT
const res = await fetch("https://65proxy.com/ip.json", { dispatcher: proxy });
console.log(await res.json());Kết quả cho thấy IP mà website nhìn thấy và quốc gia của IP (SG với proxy Singapore). Hai điều cần làm đúng:
- Lấy luôn
fetchtừ undici. ĐưaProxyAgentcủa undici 8 chofetchcó sẵn của Node 24 sẽ lỗiTypeError: fetch failed, vì hai phiên bản undici không khớp nhau. - Mã hoá ký tự đặc biệt trong mật khẩu:
@thành%40,:thành%3A.encodeURIComponent(password)làm việc này cho bạn.
Muốn mọi lệnh fetch trong chương trình đi qua proxy, kể cả fetch có sẵn, hãy đặt dispatcher chung một lần:
import { ProxyAgent, setGlobalDispatcher } from "undici";
setGlobalDispatcher(new ProxyAgent(process.env.PROXY));
const res = await fetch("https://65proxy.com/ip.json"); // fetch có sẵn của Node
console.log(await res.json());Không cài gói: NODE_USE_ENV_PROXY
Các bản Node.js gần đây tự đọc được biến proxy quen thuộc khi bạn bật tính năng này:
NODE_USE_ENV_PROXY=1 HTTP_PROXY="http://USER:PASS@HOST:PORT" HTTPS_PROXY="http://USER:PASS@HOST:PORT" node app.mjsTrên Windows PowerShell, đặt $env:NODE_USE_ENV_PROXY = "1" và hai biến proxy trước khi chạy node. Những điều cần biết:
- Phiên bản: áp dụng cho
fetchtừ Node 24.0, và cho cảhttp,httpstừ Node 24.5 (và 22.21). Tham số--use-env-proxycó tác dụng tương tự. - Trạng thái: tài liệu Node vẫn ghi tính năng này là đang thử nghiệm.
- Chỉ proxy HTTP: đừng điền địa chỉ SOCKS5 vào các biến này.
NO_PROXYliệt kê các trang không đi qua proxy.
axios
axios có tùy chọn proxy, tài khoản nằm trong trường auth riêng:
import axios from "axios";
const res = await axios.get("https://65proxy.com/ip.json", {
proxy: {
protocol: "http",
host: process.env.PROXY_HOST,
port: Number(process.env.PROXY_PORT),
auth: { username: process.env.PROXY_USER, password: process.env.PROXY_PASS },
},
timeout: 30000,
});
console.log(res.data);Kiểm tra phiên bản axios bằng npm ls axios. Trước bản 1.16.1, axios gửi request tới website HTTPS cho proxy mà không mở đường hầm, nên bị lỗi. Nếu phải giữ bản cũ, hoặc muốn một kiểu code cho mọi thư viện, hãy dùng agent và tắt phần xử lý proxy của axios:
import axios from "axios";
import { HttpsProxyAgent } from "https-proxy-agent";
const agent = new HttpsProxyAgent(process.env.PROXY);
const res = await axios.get("https://65proxy.com/ip.json", { httpsAgent: agent, proxy: false });
console.log(res.data);Luôn đặt proxy: false khi bạn tự truyền agent.
got
got 16 khuyên dùng gói hpagent (npm install got hpagent). Cho nó một agent cho website HTTP và một agent cho website HTTPS:
import got from "got";
import { HttpProxyAgent, HttpsProxyAgent } from "hpagent";
const proxy = process.env.PROXY;
const data = await got("https://65proxy.com/ip.json", {
agent: {
http: new HttpProxyAgent({ proxy }),
https: new HttpsProxyAgent({ proxy }),
},
timeout: { request: 30000 },
}).json();
console.log(data);Cẩn thận: hpagent và https-proxy-agent đều có class tên HttpsProxyAgent, nhưng class của hpagent nhận một object ({ proxy }), còn class kia nhận thẳng URL.
SOCKS5 với socks-proxy-agent
Để dùng cổng SOCKS5 của proxy, cài socks-proxy-agent và viết địa chỉ bằng socks5h://, để proxy tự tra tên miền:
import https from "node:https";
import { SocksProxyAgent } from "socks-proxy-agent";
const agent = new SocksProxyAgent(process.env.SOCKS_PROXY); // socks5h://USER:PASS@HOST:PORT
https.get("https://65proxy.com/ip.json", { agent }, (res) => {
res.pipe(process.stdout);
});Agent này dùng được ở chỗ khác:
- axios:
{ httpAgent: agent, httpsAgent: agent, proxy: false }. - got:
{ agent: { http: agent, https: agent } }.
Vì sao socks5h:// mà không phải socks5://: với socks5://, chính máy bạn phân giải tên miền và có thể đưa cho proxy một địa chỉ IPv6, loại mà đường 4G chỉ có IPv4 không tới được. Chi tiết trong bài proxy hay bị ngắt kết nối và phần socks5 hay socks5h. undici cũng có Socks5ProxyAgent, nhưng vẫn đang ghi là thử nghiệm.
Timeout và thử lại
Đường di động có lúc chậm và rớt ngắn, nên hãy đặt timeout cho mọi request và thử lại các request lỗi kết nối. Hàm dưới đây nghỉ 5, 10, 20 rồi 40 giây giữa các lần:
import { fetch, ProxyAgent } from "undici";
const proxy = new ProxyAgent(process.env.PROXY);
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
// undici wraps the real reason in err.cause, sometimes twice
function reason(err) {
while (err.cause) err = err.cause;
return err.message;
}
async function get(url, tries = 5) {
for (let attempt = 1; attempt <= tries; attempt++) {
try {
const res = await fetch(url, { dispatcher: proxy, signal: AbortSignal.timeout(30000) });
if (![502, 503, 504].includes(res.status)) return res;
console.log("attempt", attempt, "got", res.status);
} catch (err) {
console.log("attempt", attempt, "failed:", reason(err));
}
if (attempt < tries) await sleep(5000 * 2 ** (attempt - 1));
}
throw new Error("The proxy is still failing; check the line or contact support");
}
const res = await get("https://65proxy.com/ip.json");
console.log(await res.json());Khi nào nên dừng thử lại và cần gửi gì cho bộ phận hỗ trợ có trong bài proxy hay bị ngắt kết nối. Muốn đổi IP ngay trong script, xem đổi IP proxy bằng API.
Các lỗi hay gặp
Với undici, mọi lỗi đều hiện là TypeError: fetch failed; lý do thật nằm trong err.cause, và hàm reason() ở trên in ra lý do đó.
| Lỗi (thông báo trong cùng) | Nguyên nhân | Cách sửa |
|---|---|---|
invalid onRequestStart method |
fetch có sẵn dùng với ProxyAgent của một phiên bản undici khác |
Lấy fetch từ undici, hoặc dùng setGlobalDispatcher |
Proxy response (407) !== 200 when HTTP Tunneling |
Sai tài khoản, mật khẩu, hoặc ký tự đặc biệt chưa mã hoá | Sao chép lại thông tin đăng nhập; xem lỗi 407 |
Proxy response (502) !== 200 when HTTP Tunneling |
Proxy không tới được website, ví dụ địa chỉ chỉ có IPv6 | Xem lỗi đường hầm |
ECONNREFUSED |
Sai host hoặc cổng | Kiểm tra địa chỉ và cổng |
Thỉnh thoảng ECONNRESET hoặc socket hang up |
Kết nối nhàn rỗi bị đóng, hoặc đường truyền rớt | Thử lại, như code ở trên |
| Chỉ axios lỗi với website HTTPS | axios cũ hơn 1.16.1 | Nâng cấp, hoặc dùng HttpsProxyAgent với proxy: false |
ERR_REQUIRE_ESM |
Dùng require() với gói chỉ có ESM như got |
Dùng import trong file .mjs |
Khi script lỗi, hãy thử cùng proxy đó bằng curl: nếu curl chạy, vấn đề nằm ở code. Các lệnh curl có trong bài dùng proxy với curl.
Node.js với proxy 4G Singapore của 65Proxy
Mỗi proxy của 65Proxy có một cổng HTTP và một cổng SOCKS5 dùng chung tài khoản và mật khẩu, kèm link đổi IP và IP Singapore từ mạng 4G Singtel hoặc M1. Proxy không dùng chung với khách hàng khác.
- Bảng giá: 1 ngày $4, 7 ngày $13, 1 tháng $32, cùng các gói tháng nhiều băng thông hơn (500GB $40, 1TB $65).
- Chạy thử code trước với gói dùng thử miễn phí 1 giờ.
- Mua: mua proxy 4G Singapore, proxy được giao tự động sau khi thanh toán.
Cần trình duyệt thay vì request thường? Xem cài proxy cho Puppeteer hoặc cài proxy cho Playwright.
Câu hỏi thường gặp
fetch của Node có tự dùng HTTP_PROXY không?
Mặc định thì không. Node chỉ đọc HTTP_PROXY và HTTPS_PROXY khi bạn đặt NODE_USE_ENV_PROXY=1 hoặc thêm --use-env-proxy, và tính năng này vẫn đang thử nghiệm.
Thư viện nào chạy qua proxy nhanh nhất?
Chênh lệch giữa các thư viện rất nhỏ so với chính đường mạng. Hãy dùng thư viện dự án đang dùng; những gì thật sự ảnh hưởng tốc độ có trong bài tốc độ proxy.
Dùng cổng SOCKS5 với fetch được không?
Socks5ProxyAgent của undici làm được, nhưng vẫn là tính năng thử nghiệm. Với code chạy thật, socks-proxy-agent cùng https, axios hoặc got là cách đã ổn định hơn, hoặc đơn giản là dùng cổng HTTP với ProxyAgent.
Mỗi request dùng một proxy khác nhau thế nào?
Tạo một ProxyAgent cho mỗi proxy và truyền đúng agent làm dispatcher trong từng lệnh fetch. Hãy dùng lại các agent, đừng tạo mới cho mỗi request.