Cài proxy cho Playwright: proxy có mật khẩu trong Python và Node.js
Trong bài này
Playwright nhận proxy qua tùy chọn proxy: địa chỉ server, kèm username và password cho proxy có đăng nhập. Bạn có thể đặt một lần cho cả trình duyệt trong launch(), hoặc riêng từng phiên trong new_context(). Có một giới hạn cần biết trước: Playwright từ chối proxy 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 Playwright 1.65 điều khiển Chrome 157.
Cài proxy cho Playwright thế nào?
Tùy chọn proxy có bốn trường, giống nhau trong Python và Node.js:
| Trường | Chứa gì | Ví dụ |
|---|---|---|
server |
Địa chỉ và cổng của proxy (bắt buộc) | http://HOST:PORT |
username |
Tài khoản proxy | USER |
password |
Mật khẩu proxy | PASS |
bypass |
Các trang không đi qua proxy, cách nhau bằng dấu phẩy | .example.com, localhost |
Điền tài khoản và mật khẩu vào trường riêng, không ghi vào trong URL của server. server viết thiếu http:// sẽ được hiểu là proxy HTTP.
Có ba chỗ truyền được proxy:
launch(): mọi trang trong trình duyệt dùng chung một proxy.new_context()(newContext()trong Node.js): mỗi context, tức một phiên riêng có cookie riêng, dùng proxy riêng.launch_persistent_context(): cho hồ sơ trình duyệt lưu trên ổ đĩa.
Ví dụ Python
Cài Playwright và Chromium bằng pip install playwright, rồi playwright install chromium. Để tài khoản trong biến môi trường (PROXY_USER, PROXY_PASS) thay vì ghi trong code:
import os
from playwright.sync_api import sync_playwright
PROXY = {
"server": "http://HOST:PORT",
"username": os.environ["PROXY_USER"],
"password": os.environ["PROXY_PASS"],
}
with sync_playwright() as p:
browser = p.chromium.launch(proxy=PROXY)
page = browser.new_page()
page.goto("https://65proxy.com/ip.json")
print(page.inner_text("body"))
browser.close()Trang in ra IP mà website nhìn thấy và quốc gia của IP đó. Với proxy Singapore, country phải là SG. Bản async dùng đúng dictionary proxy như trên.
Ví dụ Node.js
Cài bằng npm install playwright, rồi npx playwright install chromium. Lưu file thành proxy.mjs và chạy node proxy.mjs:
import { chromium } from "playwright";
const browser = await chromium.launch({
proxy: {
server: "http://HOST:PORT",
username: process.env.PROXY_USER,
password: process.env.PROXY_PASS,
},
});
const page = await browser.newPage();
await page.goto("https://65proxy.com/ip.json");
console.log(await page.innerText("body"));
await browser.close();Mỗi context một proxy
Context là một phiên trình duyệt riêng, có cookie và bộ nhớ riêng. Cho mỗi context một proxy giúp một trình duyệt chạy được nhiều tài khoản hoặc nhiều việc, mỗi việc một IP:
import os
from playwright.sync_api import sync_playwright
PROXIES = [
{"server": "http://HOST1:PORT1", "username": os.environ["USER1"], "password": os.environ["PASS1"]},
{"server": "http://HOST2:PORT2", "username": os.environ["USER2"], "password": os.environ["PASS2"]},
]
with sync_playwright() as p:
browser = p.chromium.launch()
for proxy in PROXIES:
context = browser.new_context(proxy=proxy)
page = context.new_page()
page.goto("https://65proxy.com/ip.json")
print(page.inner_text("body"))
context.close()
browser.close()Bản thân trình duyệt không cần proxy cho cách này. Các hướng dẫn cũ bảo người dùng Windows khởi động với proxy giả như http://per-context; từ Playwright 1.47 không cần nữa. browser.new_page(proxy=...) cũng dùng được: nó tạo trang trong một context riêng.
Một việc cần bao nhiêu proxy, mỗi phiên song song một proxy hay ít hơn, được tính trong bài cần bao nhiêu proxy.
SOCKS5 trong Playwright
Playwright nhận proxy SOCKS5 không có mật khẩu, ví dụ socks5://HOST:PORT. Có tài khoản và mật khẩu thì launch() dừng ngay với lỗi:
Browser does not support socks5 proxy authenticationLỗi này xảy ra với cả Chromium, Firefox và WebKit. Proxy trả phí luôn có đăng nhập, nên hãy dùng cổng HTTP trong Playwright. Bạn không mất gì: hai cổng ra cùng một IP, và Playwright mở website HTTPS qua cổng HTTP bằng một đường hầm mã hoá. Khác biệt giữa hai giao thức có trong bài SOCKS5 và HTTP proxy.
Cho múi giờ và ngôn ngữ khớp với IP
IP Singapore mà trình duyệt để múi giờ Việt Nam là một điểm lệch dễ thấy. Đặt múi giờ và ngôn ngữ của context cho khớp với proxy:
context = browser.new_context(
proxy=PROXY,
timezone_id="Asia/Singapore",
locale="en-SG",
)Trong Node.js, hai tùy chọn là timezoneId và locale. Sau đó mở trang kiểm tra IP trong context đó: trang so múi giờ và ngôn ngữ của trình duyệt với quốc gia của IP. Những gì cần kiểm tra thêm 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à tuân thủ điều khoản của từng website; bài proxy cho bot và tự động hoá giải thích giới hạn nằm ở đâu.
Đổi IP giữa các phiên
Trình duyệt giữ kết nối tới proxy, nên đổi IP lúc trang đang tải sẽ làm hỏng trang. Thứ tự an toàn:
- Đóng context (hoặc trình duyệt).
- Gọi link đổi IP và đợi đến khi IP đã đổi.
- Mở context mới với cùng cài đặt proxy.
Code gọi link và đợ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 |
|---|---|---|
Browser does not support socks5 proxy authentication |
Dùng cổng SOCKS5 có mật khẩu | Dùng cổng HTTP |
net::ERR_HTTP_RESPONSE_CODE_FAILURE ở mọi trang |
Sai tài khoản hoặc mật khẩu (proxy trả 407) | Sao chép lại thông tin đăng nhập; xem lỗi 407 |
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 Timeout 30000ms 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 |
| Hộp đăng nhập của chính website không được điền | Từ Playwright 1.65, tài khoản proxy chỉ gửi cho proxy | Dùng tùy chọn riêng http_credentials cho website |
Khi một trang lỗi, hãy thử cùng proxy đó bằng curl trước: nếu curl chạy, vấn đề nằm ở cài đặt Playwright.
Playwright với proxy 4G Singapore của 65Proxy
Mỗi proxy của 65Proxy có một cổng HTTP (cổng dùng cho Playwright) 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 Playwright, 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 HTTP thường. Cách giảm có trong bài scrape website dùng JavaScript.
Câu hỏi thường gặp
Playwright có hỗ trợ SOCKS5 có mật khẩu không?
Không. Playwright dừng với lỗi "Browser does not support socks5 proxy authentication" ở mọi trình duyệt. 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?
Được, thông qua context: browser.new_context(proxy=...) cho từng phiên, hoặc browser.new_page(proxy=...), cách này tự tạo context riêng. Các trang trong cùng một context dùng chung proxy của context đó.
Request API có đi qua proxy không?
page.request và context.request dùng proxy của context. playwright.request.new_context() đứng riêng thì nhận tùy chọn proxy của nó, với cùng các trường.
Puppeteer có khác không?
Có: Puppeteer nhận địa chỉ proxy qua tham số khởi động Chrome, còn tài khoản qua page.authenticate(). Xem cài proxy cho Puppeteer.