Cài proxy cho Puppeteer: --proxy-server, page.authenticate và proxy riêng cho từng context
Trong bài này
Puppeteer cài proxy theo hai phần: địa chỉ proxy nằm trong tham số khởi động --proxy-server của Chrome, còn tài khoản và mật khẩu đưa vào page.authenticate() trên từng trang. Muốn mỗi phiên một proxy, dùng browser.createBrowserContext({ proxyServer }). Chrome không dùng được SOCKS5 có mật khẩu, nên hãy dùng cổng HTTP của proxy. Mọi ví dụ dưới đây đã được chạy thử ngày 18/11/2026 với Puppeteer 25.18 và Chrome 157.
Cài proxy cho Puppeteer thế nào?
| Phần | Đặt ở đâu | Ví dụ |
|---|---|---|
| Địa chỉ và cổng proxy | --proxy-server trong launch({ args }) |
--proxy-server=http://HOST:PORT |
| Tài khoản và mật khẩu | page.authenticate() trên từng trang |
{ username: "USER", password: "PASS" } |
| Proxy riêng cho từng phiên | browser.createBrowserContext() |
{ proxyServer: "http://HOST:PORT" } |
Đừng ghi tài khoản vào tham số dạng --proxy-server=http://USER:PASS@HOST:PORT: Chrome không dùng thông tin đăng nhập nằm trong cài đặt proxy, và trang sẽ không tải được.
Ví dụ cơ bản
Cài bằng npm install puppeteer, lệnh này tải luôn một bản Chrome đi kèm. Lưu file thành proxy.mjs và chạy node proxy.mjs:
import puppeteer from "puppeteer";
const browser = await puppeteer.launch({
args: ["--proxy-server=http://HOST:PORT"],
});
const page = await browser.newPage();
await page.authenticate({
username: process.env.PROXY_USER,
password: process.env.PROXY_PASS,
});
const res = await page.goto("https://65proxy.com/ip.json");
if (res.status() === 407) throw new Error("Wrong proxy username or password");
console.log(await page.evaluate(() => document.body.innerText));
await browser.close();Trang in ra IP mà website nhìn thấy và quốc gia của IP (SG với proxy Singapore). Nếu điều khiển Chrome đã cài sẵn trên máy, dùng puppeteer-core và truyền executablePath; phần proxy giữ nguyên.
page.authenticate trên mọi trang
page.authenticate() chỉ thuộc về một trang. Hãy gọi nó trên mọi trang bạn tạo, trước goto():
- Quên gọi thì trang lỗi
net::ERR_INVALID_AUTH_CREDENTIALS. - Sai mật khẩu thì
goto()không báo lỗi mà trả về phản hồi mã 407. Vì vậy ví dụ trên kiểm trares.status(). - Hiệu năng: tài liệu Puppeteer ghi rằng
page.authenticate()bật chặn request (request interception) phía sau, có thể làm trang chậm đi một chút.
Chrome đôi khi dùng lại thông tin đăng nhập đã có cho các trang khác, nhưng đừng dựa vào đó: một trang bỏ qua authenticate() có thể lỗi lúc khác.
Mỗi browser context một proxy
Browser context là một phiên riêng có cookie riêng. Từ Puppeteer 22, browser.createBrowserContext() nhận proxyServer, nên một trình duyệt chạy được nhiều proxy:
import puppeteer from "puppeteer";
const proxies = [
{ server: "http://HOST1:PORT1", username: process.env.USER1, password: process.env.PASS1 },
{ server: "http://HOST2:PORT2", username: process.env.USER2, password: process.env.PASS2 },
];
const browser = await puppeteer.launch();
for (const proxy of proxies) {
const context = await browser.createBrowserContext({ proxyServer: proxy.server });
const page = await context.newPage();
await page.authenticate({ username: proxy.username, password: proxy.password });
await page.goto("https://65proxy.com/ip.json");
console.log(await page.evaluate(() => document.body.innerText));
await context.close();
}
await browser.close();Code cũ gọi hàm này là createIncognitoBrowserContext; nó được đổi tên ở Puppeteer 22. Tùy chọn proxyBypassList nhận danh sách các trang không đi qua proxy. Cần bao nhiêu proxy cho các phiên song song thì xem cần bao nhiêu proxy.
SOCKS5 và Puppeteer
Chrome chỉ hỗ trợ proxy SOCKS5 không có mật khẩu, và page.authenticate() không giúp được: SOCKS5 không có bước hỏi đăng nhập để nó trả lời. Hãy dùng cổng HTTP của cùng proxy. Cổng này ra cùng IP, và website HTTPS vẫn đi qua đường hầm mã hoá. Xem thêm SOCKS5 và HTTP proxy.
Múi giờ và ngôn ngữ
IP Singapore mà trình duyệt để múi giờ nước khác là điểm lệch dễ thấy. Đặt cả hai trên từng trang:
await page.emulateTimezone("Asia/Singapore");
await page.setExtraHTTPHeaders({ "Accept-Language": "en-SG,en;q=0.9" });Sau đó mở trang kiểm tra IP trong trang đó để so. Danh sách kiểm tra đầy đủ có trong bài cách kiểm tra proxy.
Proxy đổi IP, chứ không che được việc một script đang điều khiển trình duyệt. Hãy giữ tốc độ vừa phải và tôn trọng điều khoản của từng website; bài proxy cho bot và tự động hoá nói rõ giới hạn nằm ở đâu.
Đổi IP giữa các phiên
Chrome giữ kết nối tới proxy, nên đổi IP lúc trang đang tải sẽ làm hỏng trang. Hãy đóng context, gọi link đổi IP, đợi IP mới, rồi mở context mới và gọi lại page.authenticate(). Code đợi IP mới có trong bài đổi IP proxy bằng API. Mỗi proxy của 65Proxy đổi IP được tối đa một lần mỗi 5 phút.
Các lỗi hay gặp
| Lỗi | Nguyên nhân | Cách sửa |
|---|---|---|
net::ERR_INVALID_AUTH_CREDENTIALS |
Trang này chưa gọi page.authenticate(), hoặc gọi sau goto() |
Gọi trước, trên mọi trang |
Phản hồi mã 407 |
Sai tài khoản hoặc mật khẩu | Sao chép lại thông tin đăng nhập; xem lỗi 407 |
net::ERR_PROXY_CONNECTION_FAILED |
Sai host hoặc cổng, hoặc không tới được proxy | Kiểm tra địa chỉ; xem không kết nối được tới proxy |
net::ERR_TUNNEL_CONNECTION_FAILED ở một website |
Proxy không tới được website đó, ví dụ địa chỉ chỉ có IPv6 | Xem lỗi đường hầm |
Thỉnh thoảng Navigation timeout of 30000 ms exceeded |
Đường 4G chậm hoặc rớt ngắn | Tăng timeout và thử lại; xem proxy hay bị ngắt kết nối |
Nếu proxy chạy trong curl mà không chạy trong Puppeteer, vấn đề nằm ở cài đặt Puppeteer, thường nhất là một trang chưa gọi authenticate().
Puppeteer với proxy 4G Singapore của 65Proxy
Mỗi proxy của 65Proxy có một cổng HTTP cho Puppeteer 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ử script trước với gói dùng thử miễn phí 1 giờ.
- Mua: mua proxy 4G Singapore cho Puppeteer, proxy được giao tự động sau khi thanh toán.
Trình duyệt tải cả ảnh, font và script nên tốn băng thông hơn nhiều so với request thường. Nếu không cần trình duyệt, các thư viện HTTP trong bài dùng proxy trong Node.js nhẹ hơn.
Câu hỏi thường gặp
Ghi tài khoản và mật khẩu vào --proxy-server được không?
Không. Chrome không dùng thông tin đăng nhập ghi trong cài đặt proxy. Đặt địa chỉ ở --proxy-server và tài khoản qua page.authenticate().
Puppeteer có hỗ trợ SOCKS5 có mật khẩu không?
Không, vì Chrome không hỗ trợ. Hãy dùng cổng HTTP của cùng proxy.
Mỗi trang dùng một proxy khác nhau được không?
Mỗi browser context thì được, bằng createBrowserContext({ proxyServer }). Các trang trong cùng một context dùng chung proxy của context đó.
Có nên dùng Playwright thay thế không?
Nếu bắt đầu từ đầu, tùy chọn proxy duy nhất của Playwright (địa chỉ, tài khoản và mật khẩu một chỗ) đơn giản hơn. Xem cài proxy cho Playwright.