IP Patterns

What Are They?

IP patterns are only available in FoxyProxy Plus.

IP patterns are very similar to URL patterns. They are used to select which FoxyProxy proxy configuration is used to load URLs. A proxy configuration is a FoxyProxy notion that encompasses:

  • Host:port, PAC URL, or "direct" (no proxy)
  • URL and IP patterns
  • Name and description

Like URL patterns, IP patterns can be white or black. They can also use wildcards, regular expressions, or specify exact/precise IP addresses. Examples are below.

Rules of Matching

FoxyProxy Plus does not automatically sense when your local IP address changes. You must press Ctrl+F3 (Cmd+F3 on OS/X) or select "Refresh local IP addresses" from FoxyProxy's menu for FoxyProxy Plus to re-read your local IP addresses.

IP patterns are tested against your local ("LAN") IP addresses. When a white pattern matches your current local IP address, the corresponding proxy configuration is tested for matching URL patterns as you navigate the web.

Matching

If FoxyProxy Plus is set to Use proxies based on their pre-defined patterns and priorities, matching working this way. For those with short attention spans, the summary is:

  • FoxyProxy Plus does not automatically sense when your local IP address changes. You must press Ctrl+F3 (Cmd+F3 on OS/X) for FoxyProxy Plus to re-read your local IP addresses.
  • Testing of local IP address(es) against IP patterns only occurs at Firefox startup, everytime you press Ctrl+F3 (Cmd+F3 on OS/X), and whenever you add/remove IP address patterns.
  • Proxies with non-matching whitelist patterns (or matching blacklist patterns) are not considered for use again until you press Ctrl+F3 or restart Firefox.
  • Loading URLs are compared against URL patterns as usual, with the exclusion of any proxy configuration that failed the IP address pattern tests. All proxy configurations that have IP patterns matching the current local IP address are included in the URL patterns tests as you navigate the web.
  • Proxy configurations disabled due to non-matching IP patterns are highlighted in grey in the main FoxyProxy Plus dialog

And in more detail:

  1. When Firefox first starts and everytime you press Ctrl+F3 (Cmd+F3 on OS/X), FoxyProxy Plus acquires all local IP addresses; for example, 192.168.1.2, 10.100.0.5, 172.16.1.4, etc). Most PCs only have a single local IP address, but if you have multiple ethernet NICs or a simultaneous internet connection and a VPN connection, you'll have multiple IP addresses.
  2. FoxyProxy Plus tests local IP addresses against IP address patterns at Firefox startup, everytime you press Ctrl+F3 (Cmd+F3 on OS/X), and whenever you add/remove IP address patterns.
  3. A local IP address matches a whitelist pattern for a proxy IF AND ONLY IF there isn't a blacklist pattern for that same proxy which doesn't also match that IP. In other words, if a whitelist and blacklist pattern both match a local IP address, the blacklist "wins" and the local IP address is not regarded as matched.
  4. All proxy configurations that have IP patterns matching the current local IP address are included in the URL patterns tests as you navigate the web.
  5. Loading URLs are compared against URL patterns as usual, with the exclusion of any proxy configuration that failed the IP address pattern tests.
  6. Local IP addresses that don't match any whitelist IP pattern are loaded by the Default proxy configuration. The Default proxy configuration may or may not be configured to use your direct internet connection; this is up to you.

FoxyProxy Plus does not automatically sense when your local IP address changes. You must press Ctrl+F3 (Cmd+F3 on OS/X) for FoxyProxy Plus to re-read your local IP addresses

If FoxyProxy is set to Use proxy "xyz" for all URLs, FoxyProxy matching working this way:

  1. All URLS are loaded through proxy "xyz" regardless of IP pattern and URL pattern blacklists or whitelists.

Examples

Wildcards

IP Pattern: 192.168.0.1

Some Matches
Some Non-Matches
192.168.0.1192.168.0.2, 192.168.1.4, 75.222.8.188

IP Pattern: 192.168.0.*

Some Matches
Some Non-Matches
192.168.0.1, 192.168.0.2192.168.1.1, 10.0.0.2, 75.222.8.188

IP Pattern: 75.220.*.*

Some Matches
Some Non-Matches
75.220.215.151, 75.220.216.974.220.215.151, 192.168.1.3, 10.100.0.6, 75.222.8.188

IP Pattern: 172.*.*.*

Some Matches
Some Non-Matches
172.16.1.10, 172.22.0.266.249.72.234, 75.220.215.157

IP Pattern: 10.*.*.*

Some Matches
Some Non-Matches
10.100.0.8, 10.9.8.7192.168.1.3, 64.233.167.99, 75.220.215.157

IP Pattern: *

Some Matches
Some Non-Matches
Matches all IP addressesNone