Skip to content
Esc

Articles

What is a proxy? A plain-English guide for beginners: how it works, the types, and what it's forWhat is a 4G proxy? How mobile proxies work, pros, cons and when to use oneRotating proxies explained: rotation types and how to change a proxy IP with a linkSOCKS5 vs HTTP proxies: what's the difference and which should you use?Proxy vs VPN: what's the difference, and when should you use each?Static vs rotating proxies: how they differ, pros and cons, and when to use eachDedicated vs shared proxies: how they differ, and what "dedicated" means for a 4G proxyIPv4 vs IPv6 proxies: how they differ, why IPv6 proxies are cheap, and when they don't workHow do websites detect proxies? 8 signals anti-bot systems look atProxy glossary A to Z: 35 terms you'll meet when buying and using proxies, explained simplyProxy vs antidetect browser: how they differ, and do you need a proxy if you have antidetect?What is a residential proxy? How it works, pros and cons, and when to use oneWhat is a datacenter proxy? Pros and cons, why it's cheap, and when it's still the right choiceHow to find your IP address on a computer or phone: public IP, local IP, and your IP behind a proxyWhy do you keep getting CAPTCHAs? 9 common triggers, and where your IP fits inreCAPTCHA vs hCaptcha vs Cloudflare Turnstile: how each one decides who gets challengedWhat is botting? Good bots, bad bots, and where your own automation fitsHow to get a Singapore IP address: VPN, proxy, cloud server or SIM, and how to check itProxies for Facebook: managing several accounts more reliably with 4G IPsProxies for TikTok and TikTok Shop: when you need a Singapore IP and how to use it properlyProxies for advertising: checking and managing ads aimed at SingaporeProxies for e-commerce sellers: see marketplaces like a buyer, track competitors, keep store logins steadyProxies for web scraping: which type to choose, how to rotate, and how to play fairDo you need a proxy to buy tickets on ThaiTicketMajor, Ticketmelon or SISTIC?Scraping Google and Bing search results with a proxy, and when to use the API insteadHow to scrape without getting blocked: pace, sessions and clean IPsProxies for price monitoring: tracking competitor and retail prices across regionsScraping anti-bot and anti-proxy websites (Cloudflare, Akamai, DataDome): what works, and the limitsIs web scraping legal? Robots.txt, terms, personal data and copyright (Vietnam, Singapore and beyond)What are 4G proxies used for? 10 jobs mobile proxies do well, and the ones to avoid4G proxies for testing apps and websites as a Singapore mobile user: QA, ads, payments, bot rulesProxies for Instagram: managing brand and client accounts steadily with 4G IPsUsing a proxy to check flight and hotel prices as a Singapore user: when it helps and what to knowResearching the Singapore market with a proxy: see search, ads, marketplaces and competitors as a local userProxies for LinkedIn: managing B2B accounts and reaching the Singapore market the right wayProxies for X (Twitter): managing brand and client accounts steadily and within the rulesProxies for airdrops: why farming wallets through proxies gets disqualified, and how to join airdrops safelyProxies for seeding, bought likes and fake reviews: why they get caught, the risks, and lasting ways to growProxies for flash sales and limited drops: what a proxy can and can't do, and how to shop sales properlyProxies for large-scale, multi-country scraping: choosing proxy types, system design and real costsProxies for Netflix, YouTube and foreign streaming: why they usually fail, cost a lot, and what to do insteadSelling to Singapore from Vietnam: choosing channels, GST, shipping, payments and the tools you needSelling on TikTok Shop Singapore from abroad: seller requirements, workable routes and what a proxy can doThe Singapore online shopping market: who shops, where, how they pay and the big sale seasonsA workflow for agencies managing client accounts with proxies and antidetect: inventory, access, offboardingLocal SEO in Singapore: checking Google and Google Maps rankings as a Singapore user, the right wayProxies for Google Ads: when you need one, the official tools to use first, and the policy lines to knowRoblox lagging, high ping: does a proxy help, and the fixes that really reduce Roblox lagMultiple Roblox accounts (alts): what the rules allow and forbid, whether you need a proxy, and IP bansLag and high ping on Singapore game servers: do proxies or VPNs lower ping, and what actually helpsDiscord proxy: what it can and can't do, how to set it up, and managing communities the right wayShopee and Lazada Singapore proxies: see what Singapore buyers see, run your shop, track competitorsProxies for online business (MMO): which jobs need one, which type to pick and what to avoidProxy for bots and automation: one identity per IP, a polite pace, and what to do when a CAPTCHA appearsHow to set up a proxy on Windows, macOS, iPhone and Android (with a username and password)How to add a proxy to GoLogin, AdsPower, Hidemyacc, GenLogin and MultiloginRotate a proxy IP automatically with an API: curl, Python and Node.js examplesHow to check a proxy: IP, country, carrier, speed and DNS and WebRTC leaksCommon proxy errors and how to fix them: 407, timeouts, ERR_PROXY_CONNECTION_FAILEDScraping JavaScript-rendered sites with a headless browser and a proxy403, 429 and 503 errors when scraping: causes and how to handle them properly (with Python code)Using a proxy with Scrapy: authenticated setup, polite throttling, error fixes and rotating between runsUsing a proxy with curl and wget: HTTP, SOCKS5, authentication, environment variables and debuggingUsing a proxy in Python: requests, httpx and aiohttp with HTTP, SOCKS5 and authenticationSetting up a proxy in Chrome and Edge: a browser-only proxy without changing the whole computerSingapore proxy for Telegram: set up SOCKS5 on desktop, iPhone and Android, and how it differs from MTProtoSlow 4G proxy? How to measure speed and latency properly, and what really makes a proxy fasterUsing proxies safely: protect your proxy password, rotation link, accounts and dataUsing Proxifier for software without proxy support: SOCKS5 setup, per-app rules and DNSRoblox proxies for developers: calling Roblox APIs from HttpService, Open Cloud, and a safe self-hosted relayProtecting your Roblox account: cookie theft, "free Robux", malicious extensions, and how to stay safeHow to set up a proxy in AdsPower: HTTP or SOCKS5, where to paste it, checking the Singapore IP and rotatingHow to add a proxy to GoLogin: HTTP or SOCKS5, where to enter it, checking the Singapore IP and rotatingHow to add a proxy to GenLogin: HTTP or SOCKS5, where to paste it, checking the Singapore IP and rotatingHow to add a proxy to Hidemium: HTTP or SOCKS5, where to enter it, checking the Singapore IP and rotatingHow to add a proxy to BitBrowser: HTTP or SOCKS5, where to enter it, checking the Singapore IP and rotatingCAPTCHA keeps appearing or loops forever: 8 fixes, in the order to try themProxy keeps disconnecting? Why 4G proxies drop connections and how to handle itPlaywright proxy: set up an authenticated proxy in Python and Node.jsPuppeteer proxy: --proxy-server, page.authenticate and a proxy per browser contextUsing a proxy in Node.js: fetch, axios, got and SOCKS5 with a username and passwordMobile vs residential vs datacenter proxies: comparing 4G, home and server IPs, and how to chooseSingapore proxies: when you need a Singapore IP and which type to chooseClean proxies and blacklists: what a clean IP means, and why "never blocked" is a myth4G rotating proxies: how mobile IP rotation works, what clean rotation means and how to choose oneHow to tell a real 4G proxy from a fake: check the carrier, IP type, latency and rotationFree vs paid proxies: the real risks of free proxies, and when paying is worth itDedicated 4G proxies, not shared: why a proxy only you use matters, and how to check it yourselfHow many proxies do I need? Working out the number for accounts, teams and scrapingStatic IP proxies for allowlists, APIs and remote access: 5 options and how to choose the right oneVietnam or Singapore proxy? Choosing which country's IP fits your workSingtel, M1 and StarHub proxies: which Singapore carrier a 4G proxy runs on, and how to check itClean proxy and CAPTCHA: how IP reputation decides how many challenges you seeThe real cost of a dirty proxy: CAPTCHAs, retries, wasted bandwidth and blocked accountsSingapore SOCKS5 proxy: when to use it, how to set it up, and how to check it5G proxy vs 4G proxy: what changes, what doesn't, and whether 5G is worth paying more forCheap 4G proxies: $4 gets you 200GB, and how to compare mobile proxy prices properly before you buyRefer a friend and earn 10% on every proxy order: how the 65Proxy referral program worksWhy choose 65Proxy? 8 reasons you can verify, and when you should go elsewhereHow to buy a 4G proxy at 65Proxy: sign up, top up, pay, connect and rotate, step by stepWhere to buy a reliable proxy? 12 things to check before paying any providerTesting a 4G proxy in a 1-hour trial: a minute-by-minute checklistBuy proxies with USDT: paying for a Singapore 4G proxy over TRC20 or BEP20, step by step4G proxy with 500GB: what the plan includes, how far 500GB goes, and how bandwidth is countedGuides to 4G mobile proxies

Puppeteer proxy: --proxy-server, page.authenticate and a proxy per browser context

Setup and use 4 min read

In this article
  1. 01 How do you set a proxy in Puppeteer?
  2. 02 Basic example
  3. 03 page.authenticate on every page
  4. 04 A different proxy per browser context
  5. 05 SOCKS5 and Puppeteer
  6. 06 Time zone and language
  7. 07 Rotating the IP between sessions
  8. 08 Common errors
  9. 09 Puppeteer with 65Proxy's Singapore 4G proxies
  10. 10 Frequently asked questions

Puppeteer sets a proxy in two parts: the address goes into Chrome's --proxy-server launch flag, and the username and password go into page.authenticate() on each page. For a different proxy per session, use browser.createBrowserContext({ proxyServer }). Chrome can't use SOCKS5 with a password, so use the proxy's HTTP port. Every example below was tested on 18 November 2026 with Puppeteer 25.18 and Chrome 157.

How do you set a proxy in Puppeteer?

Part Where it goes Example
Proxy address and port --proxy-server in launch({ args }) --proxy-server=http://HOST:PORT
Username and password page.authenticate() on each page { username: "USER", password: "PASS" }
Proxy per session browser.createBrowserContext() { proxyServer: "http://HOST:PORT" }

Don't write the login into the flag as --proxy-server=http://USER:PASS@HOST:PORT: Chrome doesn't use credentials in its proxy settings, and pages fail to load.

Basic example

Install with npm install puppeteer, which also downloads a matching Chrome. Save the file as proxy.mjs and run node proxy.mjs:

JavaScript
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();

The page prints the IP the site sees and its country (SG for a Singapore proxy). If you drive a Chrome that's already installed, use puppeteer-core and pass its executablePath; the proxy code stays the same.

page.authenticate on every page

page.authenticate() belongs to one page. Call it on every page you create, before goto():

  • Forget it and the page fails with net::ERR_INVALID_AUTH_CREDENTIALS.
  • Give a wrong password and goto() doesn't throw: it returns a response with status 407. That's why the example checks res.status().
  • Performance: Puppeteer's documentation notes that page.authenticate() turns on request interception behind the scenes, which can slow pages a little.

Chrome sometimes reuses a login it already has for other pages, but don't rely on that: a page that skips authenticate() may fail later.

A different proxy per browser context

A browser context is a separate session with its own cookies. Since Puppeteer 22, browser.createBrowserContext() takes a proxyServer, so one browser can run several proxies:

JavaScript
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();

Older code calls this createIncognitoBrowserContext; it was renamed in Puppeteer 22. The option proxyBypassList takes a list of sites that skip the proxy. How many proxies you need for parallel sessions is in how many proxies do you need.

SOCKS5 and Puppeteer

Chrome supports SOCKS5 proxies only without a password, and page.authenticate() can't help: SOCKS5 has no login prompt for it to answer. Use the HTTP port of the same proxy. It reaches the same IP, and HTTPS sites still travel through an encrypted tunnel. More in SOCKS5 vs HTTP proxies.

Time zone and language

A Singapore IP with a browser on another country's time zone is an easy mismatch to spot. Set both per page:

JavaScript
await page.emulateTimezone("Asia/Singapore");
await page.setExtraHTTPHeaders({ "Accept-Language": "en-SG,en;q=0.9" });

Then open our IP checker in that page to compare. The full list of checks is in how to check a proxy.

A proxy changes the IP, not the fact that a script drives the browser. Keep a reasonable pace and respect each site's terms; proxies for bots and automation covers where the line is.

Rotating the IP between sessions

Chrome keeps its connections to the proxy open, so rotating while pages load breaks them. Close the context, call the rotation link, wait for the new IP, then open a new context and call page.authenticate() again. The code that waits for the new IP is in rotating the IP with an API. Each 65Proxy proxy rotates at most once every 5 minutes.

Common errors

Error Cause Fix
net::ERR_INVALID_AUTH_CREDENTIALS No page.authenticate() on this page, or it ran after goto() Call it first, on every page
Response status 407 Wrong username or password Copy the login again; see 407 errors
net::ERR_PROXY_CONNECTION_FAILED Wrong host or port, or the proxy can't be reached Check the address; see can't reach the proxy
net::ERR_TUNNEL_CONNECTION_FAILED on one site The proxy can't reach that site, for example an IPv6-only address See tunnel errors
Navigation timeout of 30000 ms exceeded now and then A slow moment or short drop on the 4G line Raise the timeout and retry; see proxy keeps disconnecting

If the proxy works in curl but not in Puppeteer, the problem is in the Puppeteer settings, most often a page without authenticate().

Puppeteer with 65Proxy's Singapore 4G proxies

Every 65Proxy proxy has an HTTP port for Puppeteer and a SOCKS5 port, one username and password, a rotation link, and a Singapore IP from the Singtel or M1 4G network. It is not shared with other customers.

A browser downloads images, fonts and scripts, so it uses much more bandwidth than plain requests. If you don't need a browser, the HTTP clients in using a proxy in Node.js are lighter.

Frequently asked questions

Can I put the username and password in --proxy-server?

No. Chrome doesn't use credentials written into its proxy settings. Pass the address in --proxy-server and the login through page.authenticate().

Does Puppeteer support SOCKS5 with a password?

No, because Chrome doesn't. Use the HTTP port of the same proxy.

Can each page use a different proxy?

Each browser context can, with createBrowserContext({ proxyServer }). Pages inside one context share its proxy.

Should I use Playwright instead?

If you're starting fresh, Playwright's single proxy option (address, username and password together) is simpler. See Playwright proxy setup.