[Launch options](https://cdpfleet.com/docs/options) # `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](https://cdpfleet.com/docs/browsers/chrome#opt-proxy), [Microsoft Edge](https://cdpfleet.com/docs/browsers/edge#opt-proxy), [Brave](https://cdpfleet.com/docs/browsers/brave#opt-proxy), [Opera](https://cdpfleet.com/docs/browsers/opera#opt-proxy), [Naver Whale](https://cdpfleet.com/docs/browsers/whale#opt-proxy), [Yandex Browser](https://cdpfleet.com/docs/browsers/yandex#opt-proxy), [Chromium](https://cdpfleet.com/docs/browsers/chromium#opt-proxy), [Patchright](https://cdpfleet.com/docs/browsers/patchright#opt-proxy), [Rebrowser](https://cdpfleet.com/docs/browsers/rebrowser#opt-proxy), [Camoufox](https://cdpfleet.com/docs/browsers/camoufox#opt-proxy), [Firefox](https://cdpfleet.com/docs/browsers/firefox#opt-proxy), [WebKit](https://cdpfleet.com/docs/browsers/webkit#opt-proxy). ## Details - **Type:** `string | object | array` - **Default:** the free Community proxy - **Example:** `{"proxy":"http://user:pass@proxy.example.com: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](https://cdpfleet.com/docs/cases/brave-farbling) - [Case 68: CAPTCHA demo pages: what reCAPTCHA v3 scores and hCaptcha show seven browsers, and why a demo can't rank them](https://cdpfleet.com/docs/cases/captcha-scores-by-browser) - [Case 69: VPN Tunnel vs a plain residential proxy: WebRTC, HTTP/3 and two bot-protection pages](https://cdpfleet.com/docs/cases/vpn-tunnel-vs-proxy) - [Case 66: Which fingerprints stay the same across launches: canvas, WebGL, audio and fonts on seven browsers](https://cdpfleet.com/docs/cases/fingerprint-stability-across-launches) - [Case 67: Akamai and HUMAN: what gets through? Four browsers, three networks, the vendors' own sites](https://cdpfleet.com/docs/cases/akamai-and-human-what-gets-through) - [Case 65: DataDome: what gets through? Four browsers, three networks, DataDome's own site](https://cdpfleet.com/docs/cases/datadome-what-gets-through) - [Case 64: Cloudflare: what gets through? Four browsers, three networks, four public test pages](https://cdpfleet.com/docs/cases/cloudflare-what-gets-through) - [Case 62: Which bot protection is this? Detect the vendor from cookies, headers and requests](https://cdpfleet.com/docs/cases/which-bot-protection-is-this) - [Case 63: What four public bot-test pages say about five fleet browsers](https://cdpfleet.com/docs/cases/what-fingerprint-test-pages-see) - [Case 59: Block analytics and beacons, keep the page: what telemetry a scraper sends without knowing](https://cdpfleet.com/docs/cases/intercept-and-block-telemetry) - [Case 60: A multi-step checkout end to end: wait for each step, and check what you typed](https://cdpfleet.com/docs/cases/fill-a-multi-step-form) - [Case 57: Inspect and edit the cookie jar of a remote browser — and why WebKit refuses cookies on httpbin.org](https://cdpfleet.com/docs/cases/inspect-and-edit-the-cookie-jar) - [Case 53: Surviving a soft block: honour Retry-After, then move to another exit without losing the login](https://cdpfleet.com/docs/cases/soft-block-backoff) - [Case 54: The WebRTC IP leak test behind a proxy: what Chromium, Chrome, Firefox and Camoufox reveal](https://cdpfleet.com/docs/cases/webrtc-ip-leak) - [Case 47: A first free scrape on the Community plan: no proxy to bring, country and sticky exits included](https://cdpfleet.com/docs/cases/community-first-scrape) 77 more in [cases](https://cdpfleet.com/docs/cases) and [recipes](https://cdpfleet.com/docs/examples). All options: [launch options](https://cdpfleet.com/docs/options). --- Source: https://cdpfleet.com/docs/options/proxy · Markdown: https://cdpfleet.com/docs/options/proxy.md · All docs for AI tools: https://cdpfleet.com/llms.txt