How to Configure a Proxy in FoxyProxy for Firefox

By /

How to Configure a Proxy in FoxyProxy for Firefox

FoxyProxy is one of the longest-running and most trusted proxy management extensions for Firefox. It simplifies proxy switching and adds powerful features like URL pattern-based proxy routing, making it easy to direct different traffic through different proxy servers without manual reconfiguration.

This guide covers how to install, configure, and use FoxyProxy in Firefox, including proxy profiles, pattern-based routing, bulk import, and troubleshooting.

Why Use FoxyProxy Instead of Firefox’s Built-In Proxy Settings

While Firefox has excellent built-in proxy support, FoxyProxy adds several advantages:

  • Quick switching — Change proxies with a single click from the toolbar
  • Multiple profiles — Save unlimited proxy configurations
  • Pattern-based routing — Automatically route specific URLs through designated proxies
  • Bulk import — Load multiple proxies from a text file
  • Visual indicator — The toolbar icon shows which proxy is currently active
  • No settings digging — Avoid navigating through Firefox’s connection settings every time

Installing FoxyProxy

FoxyProxy Standard vs. FoxyProxy Basic

FoxyProxy comes in two versions:

  • FoxyProxy Standard — Full-featured version with pattern-based routing and all advanced features
  • FoxyProxy Basic — Simplified version with quick switching only, no pattern matching

For this guide, we recommend FoxyProxy Standard for its full capabilities.

Installation Steps

  1. Open Firefox and go to Firefox Add-ons (AMO).
  2. Search for “FoxyProxy Standard”.
  3. Click Add to Firefox.
  4. Click Add in the permissions dialog.
  5. The FoxyProxy icon (a fox) appears in the Firefox toolbar.

Step 1: Add a Proxy Server

Open FoxyProxy Options

  1. Click the FoxyProxy icon in the toolbar.
  2. Click Options to open the settings page.

Add a New Proxy

  1. Click the Proxies tab.
  2. Click Add.
  3. Fill in the proxy details:

Title: A descriptive name (e.g., “US Mobile Proxy”)

Proxy Type:

  • HTTP — For standard HTTP proxies
  • HTTPS — For encrypted proxy connections
  • SOCKS4 — For SOCKS version 4
  • SOCKS5 — For SOCKS version 5

Hostname: Your proxy server address (e.g., proxy.example.com)

Port: The proxy port number (e.g., 8080)

Username: Your proxy username (if authentication is required)

Password: Your proxy password (if authentication is required)

  1. Click Save.

Add Multiple Proxies

Repeat the process for each proxy server you want to manage. Each proxy gets its own profile with a unique name and color.

Step 2: Switch Between Proxies

Manual Switching

  1. Click the FoxyProxy icon in the toolbar.
  2. A dropdown appears showing all your saved proxies.
  3. Click the proxy you want to activate.
  4. The icon changes color to indicate the active proxy.

Available Modes

FoxyProxy offers several switching modes:

  • Proxy by Patterns — Uses your URL pattern rules to decide which proxy to use (auto-switch)
  • [Proxy Name] — Forces all traffic through the selected proxy
  • Disable — Turns off FoxyProxy, reverting to Firefox’s default connection settings

Keyboard Shortcuts

You can assign keyboard shortcuts to FoxyProxy actions:

  1. Go to about:addons in Firefox.
  2. Click Manage Extension Shortcuts (gear icon).
  3. Assign shortcuts for FoxyProxy toggle or switching.

Step 3: Configure Pattern-Based Proxy Routing

Pattern-based routing is FoxyProxy’s signature feature. It automatically directs traffic to different proxies based on URL patterns.

Create a Pattern

  1. Open FoxyProxy Options.
  2. Click the Proxies tab.
  3. Click on the proxy you want to assign a pattern to.
  4. Scroll down to the Patterns section.
  5. Click Add.
  6. Configure the pattern:

Title: Descriptive name (e.g., “Target Site”)

Pattern: The URL pattern to match:

  • Wildcard: target-site.com — Matches any URL containing “target-site.com”
  • Regular Expression: ^https://.\.target-site\.com/. — More precise matching

Type:

  • Inclusive — URLs matching this pattern will use this proxy
  • Exclusive — URLs matching this pattern will NOT use this proxy (direct connection)
  1. Click Save.

Example Patterns

PatternTypeDescription
google.comInclusiveRoute all Google traffic through proxy
.localExclusiveKeep local network traffic direct
api.example.com/v2/InclusiveProxy only v2 API calls
cdn.ExclusiveKeep CDN traffic direct for speed

Activate Pattern Mode

  1. Click the FoxyProxy icon.
  2. Select Proxy by Patterns.
  3. FoxyProxy now automatically routes traffic based on your pattern rules.

Pattern Priority

When multiple proxies have patterns that could match the same URL, FoxyProxy uses the proxy order to determine priority. The first matching pattern wins.

To reorder proxies:

  1. Open FoxyProxy Options.
  2. In the Proxies tab, drag and drop proxies to reorder them.
  3. Click Save.

Step 4: Bulk Import Proxies

If you have many proxies to add, FoxyProxy supports bulk import.

Import from Text File

  1. Open FoxyProxy Options.
  2. Click the Import tab.
  3. Prepare a text file with your proxies in one of these formats:
# Format: host:port
proxy1.example.com:8080
proxy2.example.com:8080
proxy3.example.com:8080

# Format: host:port:username:password
proxy1.example.com:8080:user1:pass1
proxy2.example.com:8080:user2:pass2
  1. Select the proxy type (HTTP, HTTPS, SOCKS5).
  2. Paste the content or upload the file.
  3. Click Import.

Export Proxies

  1. Open FoxyProxy Options.
  2. Click the Export button.
  3. Save the JSON file for backup or transfer to another browser.

Step 5: Configure DNS Resolution

When using SOCKS5 proxies, DNS resolution is important for privacy:

  1. Open FoxyProxy Options.
  2. Select a SOCKS5 proxy profile.
  3. Enable Send DNS through SOCKS5 proxy (or “Proxy DNS”).
  4. Save the settings.

This ensures DNS queries are resolved by the proxy server, preventing your ISP from seeing which domains you visit.

Additionally, configure Firefox’s built-in DNS settings:

  1. Go to about:config in Firefox.
  2. Set network.proxy.socks_remote_dns to true.

Using FoxyProxy for Common Tasks

Web Scraping

FoxyProxy makes it easy to manage proxies for web scraping projects:

  1. Import your proxy list via bulk import.
  2. Create patterns for your target domains.
  3. Activate “Proxy by Patterns” mode.
  4. Only scraping traffic goes through the proxy while regular browsing stays direct.

Privacy and Anonymity

Route all traffic through a privacy-focused proxy:

  1. Add your mobile proxy as a profile.
  2. Select it as the active proxy (not pattern mode).
  3. All Firefox traffic now routes through the proxy.
  4. Verify by visiting whatismyipaddress.com.

Development and Testing

Test web applications from different regions:

  1. Create proxy profiles for each region (US, UK, Asia, etc.).
  2. Switch between profiles to verify geo-dependent features.
  3. Use pattern mode to proxy only your application’s domain.

Security Research

FoxyProxy is commonly used alongside security testing tools:

  1. Create a proxy profile pointing to Burp Suite (typically 127.0.0.1:8080).
  2. Set patterns to proxy only the target application.
  3. Intercept and analyze traffic in Burp Suite.

FoxyProxy vs. Proxy SwitchyOmega

FeatureFoxyProxySwitchyOmega
BrowserFirefox (primary)Chrome (primary)
Pattern routingYesYes (Auto Switch)
Bulk importYesLimited
SOCKS5 DNSYesYes
AuthenticationYesYes
PAC scriptsNo (uses patterns)Yes
InterfaceSimplerMore options
Open sourceYesYes

Both extensions are excellent. FoxyProxy is the natural choice for Firefox users, while SwitchyOmega is designed primarily for Chrome.

Troubleshooting FoxyProxy

Proxy Not Working

  1. Verify the proxy details (hostname, port, protocol) are correct.
  2. Ensure FoxyProxy is active — check the toolbar icon. A disabled icon means FoxyProxy is off.
  3. Check that you have selected the correct proxy or enabled “Proxy by Patterns” mode.
  4. Test the proxy directly in Firefox’s built-in settings to rule out proxy server issues.

Pattern Not Matching

  1. Check the pattern syntax — wildcards use * while regex requires the regex option to be enabled.
  2. Test your pattern against the full URL, not just the domain.
  3. Verify the pattern is set to Inclusive, not Exclusive.
  4. Check proxy priority order — a higher-priority proxy pattern may be matching first.

Authentication Errors

  1. Double-check username and password.
  2. Ensure special characters are entered correctly (no URL encoding needed in FoxyProxy fields).
  3. Some proxies use IP-based authentication — verify your IP is whitelisted with your provider.
  4. Try the proxy with a different tool (like curl) to confirm credentials work.

Firefox Shows “The proxy server is refusing connections”

  1. The proxy server may be offline. Test it from another application.
  2. Check if a firewall is blocking outbound connections to the proxy port.
  3. Verify the port number is correct.
  4. Try switching to a Direct connection to confirm the issue is proxy-related.

FoxyProxy Conflicts with Firefox Settings

FoxyProxy overrides Firefox’s built-in proxy settings when active. If you experience issues:

  1. Disable FoxyProxy and configure the proxy in Firefox’s connection settings to verify it works.
  2. If it works in Firefox settings but not FoxyProxy, the extension configuration may be incorrect.
  3. Reinstall FoxyProxy if persistent issues occur.

For more information on the proxy protocols and terms referenced in this guide, visit our proxy glossary.

Conclusion

FoxyProxy is the go-to proxy management extension for Firefox users. Its pattern-based routing, bulk import, and quick-switching capabilities make it far more convenient than manually changing Firefox’s proxy settings. Whether you need a simple single-proxy setup or complex multi-proxy routing, FoxyProxy handles it with an intuitive interface. Install it, add your proxies, and enjoy effortless proxy management in Firefox.

Related Reading

Scroll to Top