FoxyProxy Setup Guide: Browser Proxy Switching Made Easy

FoxyProxy is a long-established browser extension for managing proxy configurations in Firefox and Chrome. It provides a straightforward interface for adding proxy servers, creating URL-based switching rules, and toggling between proxy profiles. While similar to SwitchyOmega in purpose, FoxyProxy has a simpler interface that many users prefer for basic proxy management tasks.

Installation

Firefox

Visit Firefox Add-ons (addons.mozilla.org)
Search “FoxyProxy Standard” (full version) or “FoxyProxy Basic” (simplified)
Click “Add to Firefox” and approve permissions
The fox icon appears in your toolbar

Chrome

Visit Chrome Web Store
Search “FoxyProxy”
Install “FoxyProxy Standard”
The fox icon appears in your extensions bar

Version Differences

Feature	FoxyProxy Basic	FoxyProxy Standard
Manual proxy switching	Yes	Yes
URL pattern matching	No	Yes
Auto-switch by rules	No	Yes
PAC file support	No	Yes
Import/Export	Limited	Full
Price	Free	Free

For most users, FoxyProxy Standard is recommended for its auto-switching capabilities.

Adding Proxy Servers

Step-by-Step Configuration

Click the FoxyProxy icon → “Options”
Click “Add New Proxy” (or “Add” in newer versions)
Fill in the proxy details:

Proxy Type:     HTTP / HTTPS / SOCKS5 / SOCKS4
Title:          US Residential Proxy
IP Address:     gate.provider.com
Port:           8080
Username:       user-country-us
Password:       your_password

Click “Save”

Example Proxy Configurations

Profile 1: Residential Scraping
  Type: HTTP
  Host: residential.provider.com
  Port: 8080
  User: user-country-us-session-abc123
  Pass: password123

Profile 2: UK Market Research
  Type: HTTP
  Host: gate.provider.com
  Port: 8080
  User: user-country-gb
  Pass: password123

Profile 3: SOCKS5 Tunnel
  Type: SOCKS5
  Host: socks.provider.com
  Port: 1080
  User: sockuser
  Pass: sockpass

Profile 4: Local Development Proxy
  Type: HTTP
  Host: 127.0.0.1
  Port: 8888
  User: (none)
  Pass: (none)

URL Pattern Matching (Auto-Switch)

FoxyProxy Standard lets you define URL patterns that automatically activate specific proxies.

Setting Up Patterns

Open FoxyProxy Options
Click on a proxy profile
Go to the “Patterns” tab
Add URL patterns:

Pattern Examples:

Name:           Amazon US
Pattern:        *amazon.com*
Pattern Type:   Wildcard
Include/Exclude: Include (use this proxy)

Name:           Amazon UK
Pattern:        *amazon.co.uk*
Pattern Type:   Wildcard
Include/Exclude: Include

Name:           Internal Sites
Pattern:        *internal.company.com*
Pattern Type:   Wildcard
Include/Exclude: Exclude (bypass proxy)

Pattern Types

Type	Syntax	Example	Matches
Wildcard	`text`	`amazon`	Any URL containing “amazon”
Regex	`/pattern/`	`/https?://.*\.gov/`	Any .gov URL
Wildcard host	`*.example.com`	`*.google.com`	All Google subdomains

Pattern Priority

Patterns are evaluated in order from top to bottom. The first matching pattern determines which proxy is used:

Priority Order (evaluated top to bottom):

1. *.internal.company.com → [No Proxy / Direct]
2. *.amazon.com           → US Residential
3. *.amazon.co.uk         → UK Residential
4. *.google.com           → Datacenter Proxy
5. (default)              → No Proxy / Direct

Move higher-priority patterns to the top of the list.

Switching Modes

FoxyProxy offers several operating modes accessible from the toolbar icon:

Mode 1: Disable FoxyProxy

All traffic goes direct — FoxyProxy is completely inactive.

Mode 2: Use Specific Proxy for All URLs

All traffic routes through a single selected proxy, ignoring all URL patterns.

Mode 3: Use Proxies Based on Patterns

FoxyProxy evaluates each URL against defined patterns and routes through the matching proxy. Unmatched URLs go direct.

Mode 4: Use Specific Proxy for All URLs (HTTPS Only)

Only HTTPS traffic goes through the proxy; HTTP traffic goes direct.

Quick Toggle

Click the FoxyProxy toolbar icon to cycle between modes or select a specific proxy. The icon color indicates the active mode:

Icon Colors (Firefox):
  Blue   → Active proxy (pattern-based)
  Green  → Active proxy (specific proxy for all)
  Gray   → Disabled (direct connection)
  Red    → Error / configuration issue

Import and Export

Exporting Settings

FoxyProxy Options → Settings tab
Click “Export Settings”
Save the JSON file

Importing Settings

FoxyProxy Options → Settings tab
Click “Import Settings”
Select your JSON backup file

Sharing Configurations

Export your FoxyProxy settings and share the JSON file with team members for consistent proxy setups across workstations.

Integration with Proxy Services

Residential Proxy Setup

Provider: Bright Data / Oxylabs / Smartproxy

Proxy Type:  HTTP
Server:      gate.provider.com (or brd.superproxy.io, etc.)
Port:        8080 (varies by provider)
Username:    customer-zone-residential-country-us
Password:    your_api_key

Pattern:     * (all URLs)

Multiple Geo-Locations

Create separate profiles for each country:

Profile: US Exit
  Server: gate.provider.com:8080
  User: user-country-us
  Pattern: *.com (US sites)

Profile: UK Exit
  Server: gate.provider.com:8080
  User: user-country-gb
  Pattern: *.co.uk (UK sites)

Profile: DE Exit
  Server: gate.provider.com:8080
  User: user-country-de
  Pattern: *.de (German sites)

SOCKS5 with DNS Resolution

When using SOCKS5 proxies, enable “Send DNS through SOCKS5 proxy” (if available) to prevent DNS leaks. This ensures domain name resolution happens on the proxy side, not locally.

Troubleshooting

Problem	Cause	Solution
Proxy not connecting	Wrong host/port	Test with `curl -x proxy:port https://httpbin.org/ip`
Authentication failures	Wrong credentials	Verify username/password; check for special characters
Slow browsing	All traffic proxied	Use patterns to proxy only specific sites
Pattern not matching	Wrong pattern syntax	Test with wildcard `site.com` first
HTTPS certificate errors	Proxy MITM or misconfiguration	Ensure proxy supports CONNECT method
Extension conflicts	Multiple proxy extensions	Disable SwitchyOmega or other proxy managers

Verification Steps

1. Enable proxy in FoxyProxy
2. Visit https://httpbin.org/ip
   → Should show proxy IP, not your real IP

3. Visit https://ipinfo.io
   → Should show proxy location

4. Visit a pattern-matched site
   → Verify correct proxy is being used

5. Visit a non-matched site
   → Should use direct connection (if configured)

FoxyProxy vs SwitchyOmega

Feature	FoxyProxy	SwitchyOmega
Browser support	Firefox + Chrome	Chrome + Firefox
Interface	Simpler	More polished
Pattern matching	Wildcard + Regex	Wildcard + Regex + CIDR
PAC script support	Yes	Yes
Auto-switch	Yes (Standard version)	Yes
Rule lists	Basic	Advanced (GFWList, etc.)
Quick switching	Toolbar menu	Toolbar + keyboard
History	Longer-established	Newer, more active
Open source	Yes	Yes

Both are excellent choices. FoxyProxy is slightly simpler for basic proxy management, while SwitchyOmega offers more advanced rule management.

Frequently Asked Questions

Can FoxyProxy handle proxy authentication automatically?

Yes. Enter your username and password when configuring the proxy profile. FoxyProxy sends the Proxy-Authorization header automatically without showing browser authentication popups.

Does FoxyProxy work per-tab or browser-wide?

FoxyProxy applies proxy settings browser-wide — all tabs use the same proxy configuration at any given time. To use different proxies simultaneously, use separate browser profiles or different browsers.

Can I use FoxyProxy with SOCKS5 proxies?

Yes. Select “SOCKS5” as the proxy type when adding a new proxy. FoxyProxy supports SOCKS4, SOCKS5, HTTP, and HTTPS proxy types. For DNS leak prevention, look for the “Proxy DNS” or “Send DNS through SOCKS proxy” option in the settings.

Is FoxyProxy secure?

FoxyProxy is open-source and has been available for over a decade. It manages proxy settings only and does not intercept or modify your traffic. Download only from official browser extension stores to avoid counterfeit versions.

How do I use FoxyProxy for web scraping?

FoxyProxy is primarily useful for manual browser testing of proxy configurations — verifying that your proxies work correctly and checking what content looks like from different locations. For automated web scraping, configure proxies directly in your code (Python requests, Playwright, etc.) rather than relying on a browser extension.

Conclusion

FoxyProxy provides reliable, straightforward proxy management for Firefox and Chrome users. Its pattern-matching auto-switch feature makes it easy to route specific websites through specific proxies while keeping other traffic direct. For basic proxy switching needs, FoxyProxy Standard offers everything most users require in a clean, intuitive interface.

For more advanced proxy management, see our SwitchyOmega guide or learn about PAC files for programmatic proxy routing.