[Launch options](https://cdpfleet.com/docs/options)

# `proxy_rules`

Send specific destination hosts through specific proxies.

**Use it for:** Scrapers that want an expensive exit only where it matters: residential for the target site, a cheaper proxy for images, CDNs and APIs, or a different country per host.

**Browsers:** [Google Chrome](https://cdpfleet.com/docs/browsers/chrome#opt-proxy_rules), [Microsoft Edge](https://cdpfleet.com/docs/browsers/edge#opt-proxy_rules), [Brave](https://cdpfleet.com/docs/browsers/brave#opt-proxy_rules), [Opera](https://cdpfleet.com/docs/browsers/opera#opt-proxy_rules), [Naver Whale](https://cdpfleet.com/docs/browsers/whale#opt-proxy_rules), [Yandex Browser](https://cdpfleet.com/docs/browsers/yandex#opt-proxy_rules), [Chromium](https://cdpfleet.com/docs/browsers/chromium#opt-proxy_rules), [Patchright](https://cdpfleet.com/docs/browsers/patchright#opt-proxy_rules), [Rebrowser](https://cdpfleet.com/docs/browsers/rebrowser#opt-proxy_rules), [Camoufox](https://cdpfleet.com/docs/browsers/camoufox#opt-proxy_rules), [Firefox](https://cdpfleet.com/docs/browsers/firefox#opt-proxy_rules), [WebKit](https://cdpfleet.com/docs/browsers/webkit#opt-proxy_rules).

## Details

-   **Type:** `array`
-   **Default:** none
-   **Example:** `{"proxy_rules":[{"name":"dc-assets","hosts":["*.cloudfront.net","static.example.com"],"proxy":["http://u:p@dc1.example:4444","http://u:p@dc2.example:4444"]}]}`

A list of `{ "name": "…", "hosts": [...], "proxy": "…" | [...] }` rules. Requests to a host matching a rule use that rule's proxy (round-robin when it is a list); every other host uses `proxy`. Host patterns support `*` wildcards, e.g. `*.cdn.example.com` or `static.*`. The optional `name` (up to 64 characters) labels the rule's traffic on your dashboard's Proxy traffic page and in its CSV export.

Needs `proxy` to be set as the default route. Rules route through a proxy only; routing a host with no proxy (direct from our servers) is not available. The first matching rule wins — keep rules from overlapping so traffic is attributed to the right one.

## Used in

-   [Case 51: Cut residential spend: the page on Tier 1, the images on Tier 4, in one session](https://cdpfleet.com/docs/cases/resi-tiers-mix)
-   [Case 7: Different sites, different proxies, one browser: proxy\_rules](https://cdpfleet.com/docs/cases/per-host-proxy-rules)
-   [Proxy pool with per-host rules](https://cdpfleet.com/docs/examples#proxy-pool)
-   [Residential IPs for one strict host, your own proxy for the rest](https://cdpfleet.com/docs/examples#resi-for-one-host)

All options: [launch options](https://cdpfleet.com/docs/options).

---
Source: https://cdpfleet.com/docs/options/proxy_rules · Markdown: https://cdpfleet.com/docs/options/proxy_rules.md · All docs for AI tools: https://cdpfleet.com/llms.txt