Network & Proxy
Configure proxy routing, DNS and WebRTC leak prevention, GeoIP alignment, and per-context network isolation.
New to this section? Start with Proxy Configuration.
Use This Section When You Need To
- You need IP, timezone, locale, and language signals to align.
- You want to prevent DNS, WebRTC, or localhost leak paths.
- You need per-context or selective proxy routing in multi-account workloads.
Recommended Reading Order
- Proxy Configuration - Proxy configuration for Puppeteer and Playwright: —proxy-server syntax, SOCKS5 and socks5h remote DNS, credentials, and headless launch checks.
- Proxy and Geolocation - Align proxy routing and geographic signals (timezone, locale, languages) for stable location identity.
- WebRTC Leak Prevention - Disable WebRTC loopback candidates: no Chrome flag exists. BotBrowser drops 127.0.0.1 and ::1 before page JavaScript runs, plus ICE and SDP controls.
- Per-Context Proxy - Assign different proxies to different BrowserContexts for multi-identity and multi-region automation.
All Guides
| Guide | Description |
|---|---|
| Proxy Configuration | Proxy configuration for Puppeteer and Playwright: —proxy-server syntax, SOCKS5 and socks5h remote DNS, credentials, and headless launch checks. |
| QUIC Proxy Routing | QUIC proxy routing in BotBrowser: route HTTPS and HTTP/3 traffic through an authenticated CONNECT or MASQUE CONNECT-UDP proxy, per BrowserContext. |
| Proxy and Geolocation | Align proxy routing and geographic signals (timezone, locale, languages) for stable location identity. |
| Dynamic Proxy Switching | Switch proxies per BrowserContext at runtime so separate accounts, regions, and workflows keep independent network identity without a restart. |
| WebRTC Leak Prevention | Disable WebRTC loopback candidates: no Chrome flag exists. BotBrowser drops 127.0.0.1 and ::1 before page JavaScript runs, plus ICE and SDP controls. |
| DNS Leak Prevention | DNS leak prevention: control whether domain resolution runs through local DNS or the proxy path, and verify which resolver a page can observe. |
| Custom HTTP Headers | Configure custom browser request headers for all outgoing traffic while keeping header profiles consistent across sessions. |
| Port Protection | Block remote pages from scanning localhost and internal service ports, protecting local tools and private network surfaces during sessions. |
| UDP over SOCKS5 | Route UDP protocols like QUIC and STUN through SOCKS5 to prevent IP leaks and keep network identity consistent. |
| PAC-Like Request Callback | Use standard PAC routing plus BotBrowser’s trusted request callback for enterprise network policy workflows. |
| Per-Context Proxy | Assign different proxies to different BrowserContexts for multi-identity and multi-region automation. |
| Proxy Selective Routing | Configure selective proxy routing with regex rules so BotBrowser can keep direct and proxied request paths aligned with network identity requirements. |
| GeoIP Database | BotBrowser GeoIP lookup behavior: update boundaries, cache rules, and how proxy location connects to timezone, locale, and identity. |
| IPv4-Only Proxy Compatibility | IPv4-only proxy compatibility: check proxy endpoint and destination support, DNS settings, and container options when a tunnel request is rejected. |
Updated