Pyppeteer and PuppeteerSharp Proxy: Settings and Login
The proxy goes in the launch arguments and the login goes on the page; here is the code for Python and C#.
How both libraries take a proxy
pyppeteer and PuppeteerSharp both start Chromium, so the proxy is a Chromium flag passed in the launch arguments: args in pyppeteer, Args in PuppeteerSharp's LaunchOptions. Chromium expects the flag value as a URI such as http://HOST:PORT.
The flag has no place for a username and password. Give them to the page with authenticate, which answers the proxy's login request.
Example only: replace HOST, LOGIN and PASSWORD with the values from My assets.
PuppeteerSharp: proxy flag and login
using PuppeteerSharp;
await new BrowserFetcher().DownloadAsync();
await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions
{
Headless = true,
Args = new[] { "--proxy-server=http://HOST:2222" }
});
await using var page = await browser.NewPageAsync();
await page.AuthenticateAsync(new Credentials { Username = "LOGIN", Password = "PASSWORD" });
await page.GoToAsync("https://ipinfo.io/json");
Console.WriteLine(await page.EvaluateExpressionAsync<string>("document.body.innerText"));
Example only: replace HOST, LOGIN and PASSWORD; top-level statements as in a .NET console project.
HTTP or SOCKS5
The Chromium documentation says no authentication methods are supported for SOCKSv5 in Chrome, so a SOCKS5 proxy with a login does not work through --proxy-server. Use an HTTP address with the same login: port 2222 on Proxy302.
You do not always need to buy again. A static ISP IP leased per IP also connects over HTTP on port 2222, and rotating residential and newly bought per-GB Fixed ISP take both ports on the same username and password.
--proxy-server is a flag of the browser process, so every page opened in that browser uses it. For several IPs, launch one browser per proxy, or point one browser at a rotating gateway that gives a new IP per connection.
Puppeteer's documentation says authenticate turns on request interception behind the scenes, which might affect performance. These libraries follow that API, so measure a run before you scale it.
The pyppeteer README calls the repository unmaintained and suggests playwright-python. If you are free to choose, Playwright has proxy login built into its launch options; if you must keep pyppeteer, pin your versions and test the proxy setup on every upgrade.
Buy a static ISP IP or use rotating residential traffic (no protocol to pick; use HTTP on port 2222), then copy HOST, PORT, USERNAME and PASSWORD from My assets.
Real household IPs in 195+ countries; the Premium line adds state and major-city targeting. A new IP on every new connection, or keep sticky sessions. From US$1.50/GB, US$1.35/GB at 100 GB. HTTP and SOCKS5.
Read 16 November 2026: launch() takes args, a list of additional flags for the browser process; executablePath replaces the bundled Chromium and the page warns that this is risky; Page.authenticate(credentials) takes a dict with username and password.
Read 16 November 2026: described as an unofficial Python port of puppeteer; the status note says the repository is unmaintained and has seen only minor changes for a long time, and suggests playwright-python; requires Python 3.8 or newer.
Read 16 November 2026: LaunchOptions.Args is a string array of additional arguments for the browser instance; Headless defaults to true; ExecutablePath replaces the bundled Chromium. The docs home page gives dotnet add package PuppeteerSharp.
Read 16 November 2026: Task AuthenticateAsync(Credentials credentials) on IPage, with a Credentials class that has Username and Password; passing null disables authentication.
Read 16 November 2026: provides credentials for HTTP authentication; request interception is turned on behind the scenes to implement it, which might affect performance.
Read 16 November 2026: command-line flags such as --proxy-server expect URI-formatted proxy identifiers; no authentication methods are supported for SOCKSv5 in Chrome.
Proxy302 product facts and price list
Product observation · Confirmed on:
Product facts file of the site, checked 16 November 2026: prices in US$ (1 PTC = US$1), lease terms, protocols and ports (HTTP 2222, SOCKS5 3333), what each product connects over, countries and city targeting, no free trial.
Ready to try it?
Create an account, top up once, then pick rotating residential, static ISP or datacenter IPs and have one running in your browser within minutes.