proxy
Upstream proxy for the browser.
Use it for: Every session that needs a particular exit: your own proxy for the IP and country you choose, a list as a pool to spread requests across IPs, or a cdpfleet-resi token for residential IPs billed per GB.
Browsers: Google Chrome, Microsoft Edge, Brave, Opera, Naver Whale, Yandex Browser, Chromium, Patchright, Rebrowser, Camoufox, Firefox, WebKit.
Details
- Type:
string | object | array - Default: the free Community proxy
- Example:
{"proxy":"http://user:[email protected]:8080"}
A proxy URL (http://user:pass@host:port, https://…, socks5://user:pass@host:port; no scheme means http://), an object { "server": "http://host:port", "username": "…", "password": "…" }, or a list of proxies used round-robin as a pool. SOCKS5 with authentication works on every browser.
Optional: without a proxy (and without vpn) the free Community proxy is used — shared, slower and capped (503 community_capacity_full when busy), so bring your own or use the residential proxy for work that matters. Sessions never browse from our servers' own IPs. An unparseable proxy returns 400.
Used in
- Case 83: Brave's fingerprint randomisation per site, per context and per launch, and what public fingerprint pages make of it
- Case 68: CAPTCHA demo pages: what reCAPTCHA v3 scores and hCaptcha show seven browsers, and why a demo can't rank them
- Case 69: VPN Tunnel vs a plain residential proxy: WebRTC, HTTP/3 and two bot-protection pages
- Case 66: Which fingerprints stay the same across launches: canvas, WebGL, audio and fonts on seven browsers
- Case 67: Akamai and HUMAN: what gets through? Four browsers, three networks, the vendors' own sites
- Case 65: DataDome: what gets through? Four browsers, three networks, DataDome's own site
- Case 64: Cloudflare: what gets through? Four browsers, three networks, four public test pages
- Case 62: Which bot protection is this? Detect the vendor from cookies, headers and requests
- Case 63: What four public bot-test pages say about five fleet browsers
- Case 59: Block analytics and beacons, keep the page: what telemetry a scraper sends without knowing
- Case 60: A multi-step checkout end to end: wait for each step, and check what you typed
- Case 57: Inspect and edit the cookie jar of a remote browser — and why WebKit refuses cookies on httpbin.org
- Case 53: Surviving a soft block: honour Retry-After, then move to another exit without losing the login
- Case 54: The WebRTC IP leak test behind a proxy: what Chromium, Chrome, Firefox and Camoufox reveal
- Case 47: A first free scrape on the Community plan: no proxy to bring, country and sticky exits included
All options: launch options.