WordPress Plugins
Free Tools
Claude Skills
Resources
Pricing Support My Account Cart
Support / GuardPress / Country Blocking + Cloudflare Real IP

Country Blocking and the Cloudflare Real-IP Gotcha

GuardPress Geographic Access Rules let you block all traffic from the countries you choose. Countries are looked up on your own server, in a country database stored on your site or in Cloudflare’s country information when your site is behind Cloudflare, so visitor IP addresses are never sent to an outside service. Behind Cloudflare (or any reverse proxy) there is one thing to get right: GuardPress has to see the real visitor IP, not the proxy’s. GuardPress 1.6.30+ auto-detects Cloudflare and handles this out of the box; this page covers setup, how the lookup works, how to verify it, and what to do when auto-detection isn’t enough.

The one-line summary

Enable GuardPress → IP Management → Geographic Access Rules, add the countries you want to block, save, and check that the status line says the country database is installed. If your site is behind Cloudflare, GuardPress trusts Cloudflare’s real-IP and country headers automatically when the connection arrives from a published Cloudflare edge range, with no extra config. Country rules require GuardPress Pro 1.6.54 or later.

Quick Setup

The whole configuration lives on a single admin page:

Open IP Management

In WP Admin, go to GuardPress → IP Management. Scroll past the Whitelist and Blacklist sections to the Geographic Access Rules card.

GuardPress admin submenu in the WordPress sidebar showing Dashboard, Firewall, Malware Scanner, Outdated Software, Database, File Monitor, Audit Log, Backups, IP Management (highlighted), Migration, Settings, and License entries

Enable geographic rules

Tick the Enable geographic access rules checkbox. The country selector and the country database status line appear below it.

Geographic Access Rules card with Enable geographic access rules ticked. A green status box reads Country database installed, data from October 1, 2026, updated monthly, with the DB-IP.com credit. Below it are the Test an IP box, the country dropdown with an Add button, the message No countries restricted yet, and the Save Geographic Rules button

Add the countries you want to block

Pick a country from the dropdown and click Add. Repeat for every country to block. Each selection appears as a removable pill below the dropdown.

Geographic Access Rules card with North Korea and Russia added as removable country pills. The Test an IP box shows 8.8.8.8 looked up as United States (US), above the Save Geographic Rules button

Save the rules

Click Save Geographic Rules. The first time you save with the rules turned on, GuardPress downloads the country database to your site, and the save message tells you whether it is installed. The change takes effect on the next request, and an audit log entry is written (GuardPress → Audit Log, action geo_rules_updated) so you have a record of when the policy changed and how many countries are on the list.

Check the status line and test an IP

The status line above the country dropdown should read Country database installed with the date of the data. If your site is behind Cloudflare it also says that visitors are matched by Cloudflare’s country information first. Use the Test an IP box below it to look up any address (for example 8.8.8.8) in the country database and see which country GuardPress resolves it to.

Blocklist only, not allowlist

Country rules are a single blocklist: any country on the list is blocked, everyone else is allowed. There is no opposite mode (“only allow these countries”). If you need allow-list-style behaviour, the closest workaround is to add every country except your allowed set to the blocklist. It’s tedious but works, and the list covers the full ISO 3166-1 alpha-2 country space.

How GuardPress Looks Up Country From IP

Every lookup happens on your own server. GuardPress uses the first of these sources that can answer:

  1. Cloudflare’s country information: when the request reached your site through a Cloudflare edge (the same check that decides whether to trust CF-Connecting-IP), GuardPress reads the country Cloudflare attached to the request in the CF-IPCountry header.
  2. The country database on your site: otherwise, the visitor’s IP is looked up in a country database file stored in your uploads folder (uploads/guardpress/geo/).

The resolved country code is compared against the blocklist you saved. If it matches, GuardPress emits a 403 Access Denied page (or a JSON / XML-RPC equivalent if the request is API-shaped; see Firewall overview for the per-context block response format).

Blocking the Tor network (sites behind Cloudflare)

Cloudflare marks requests that arrive from the Tor network with the code T1 instead of a country. The country dropdown includes Tor network (sites behind Cloudflare); add it to the blocklist like any country to block Tor visitors. Sites that aren’t behind Cloudflare can’t tell Tor traffic apart through the country database, so this entry has no effect there.

The Cloudflare Gotcha

Here’s the part that bites people. When a visitor in (say) Vietnam loads your site:

The same applies to every IP-based rule: brute-force lockouts, the whitelist, the blacklist and rate limiting all need the real visitor IP, or they end up acting on Cloudflare’s addresses instead.

Cloudflare publishes a header, CF-Connecting-IP, which carries the real visitor IP through the proxy. The fix is for GuardPress to read THAT header instead of REMOTE_ADDR when the request actually came through Cloudflare. The hard part is doing it safely: any plugin that blindly trusts a forwarded header gets spoofed instantly by anyone sending the request with a fake header.

How GuardPress Resolves the Real IP

GuardPress uses a three-layer trust check before honouring any forwarded header. The layers are evaluated in order, and the first match wins:

  1. Loopback — if REMOTE_ADDR is 127.0.0.1 or ::1, the request came from the local machine (typically a reverse proxy on the same host: CloudPanel, nginx-fronted Apache, Docker bridge networks, LiteSpeed proxy). External attackers can’t spoof loopback because the TCP/IP stack rejects packets with a loopback source IP on non-loopback interfaces. Forwarded headers are trusted.
  2. Known CDN ranges (Cloudflare) — if REMOTE_ADDR matches one of the 22 baked-in Cloudflare IPv4 + IPv6 CIDRs, the connection is provably from Cloudflare’s edge network. CF-Connecting-IP is trusted. This is the layer that fixes the gotcha automatically, added in 1.6.30.
  3. Admin allowlist — if you’ve manually pasted IPs / CIDRs into GuardPress → Settings → Network / Proxies → Trusted Proxies, any connection from one of those addresses gets its forwarded header honoured. Use this for non-Cloudflare reverse proxies (Sucuri, custom load balancers, etc.).

When at least one layer matches, GuardPress walks the following headers in order and uses the first that contains a valid IP:

  1. HTTP_CF_CONNECTING_IP (Cloudflare’s real-visitor header)
  2. HTTP_X_FORWARDED_FOR (standard reverse-proxy header — read from the right, skipping your trusted proxies, so the first untrusted address is used)
  3. HTTP_X_REAL_IP (nginx convention)

If REMOTE_ADDR doesn’t match any of the three trust layers, GuardPress falls back to REMOTE_ADDR verbatim. This is the safe default for direct-attached hosts with no reverse proxy — it stops attackers from setting CF-Connecting-IP in a direct request and forging their IP.

Why this is safe

REMOTE_ADDR is set by the TCP layer when the connection is established. It is the IP address that completed the TCP three-way handshake with your server. It cannot be spoofed at this layer — if an attacker faked the source IP, the SYN-ACK response would go to the faked address, not them. So a REMOTE_ADDR match against a published Cloudflare edge range is cryptographic-grade evidence that the connection actually came through Cloudflare, which is what justifies trusting Cloudflare’s header without further admin configuration.

Verifying the Auto-Detection Worked

Before relying on country blocking in production, confirm GuardPress is seeing real visitor IPs and not Cloudflare edge IPs.

The quick check: the status line and Test an IP

On GuardPress → IP Management, the Geographic Access Rules status line says whether the country database is installed and, when GuardPress recognises a Cloudflare request, that visitors are matched by Cloudflare’s country information first. The Test an IP box looks an address up in the country database, which is a fast way to confirm a specific visitor’s IP resolves to the country you expect.

The end-to-end check: trigger a block and look at the audit log

Add a country you can simulate (or your own country if you can VPN somewhere else) to the blocklist. Hit the site from a matching IP. Then go to GuardPress → Audit Log and look for entries with action = firewall_block. The log entry includes the IP that was blocked:

The forensic check: dump REMOTE_ADDR + headers from a test request

Drop a temporary one-liner into your theme’s functions.php (or into a must-use plugin if you have one):

add_action( 'init', function() {
    if ( ! current_user_can( 'manage_options' ) ) return;
    if ( ! isset( $_GET['gp_ip_check'] ) ) return;
    echo '<pre>';
    echo 'REMOTE_ADDR: ' . esc_html( $_SERVER['REMOTE_ADDR'] ?? '(none)' ) . "\n";
    echo 'CF-Connecting-IP: ' . esc_html( $_SERVER['HTTP_CF_CONNECTING_IP'] ?? '(none)' ) . "\n";
    echo 'X-Forwarded-For: ' . esc_html( $_SERVER['HTTP_X_FORWARDED_FOR'] ?? '(none)' ) . "\n";
    echo 'GuardPress detected: ' . esc_html( GuardPress_Logger::get_client_ip() ) . "\n";
    echo '</pre>';
    exit;
} );

Visit https://your-site.com/?gp_ip_check=1 while logged in as admin. The output tells you exactly what GuardPress is seeing. If REMOTE_ADDR is a Cloudflare range and CF-Connecting-IP is set and GuardPress detected = the CF-Connecting-IP value, auto-detection is healthy. Remove the snippet when you’re done.

Don’t leave the snippet in production

It exposes the visitor’s IP only to logged-in admins, so it’s not a leak, but it’s still test code in a production site. Delete it once you’ve confirmed.

Manual Configuration (When Auto-Detection Isn’t Enough)

Auto-detection covers Cloudflare and same-host reverse proxies. If you’re behind a different proxy — Sucuri, StackPath, a custom load balancer, an enterprise WAF in front of Cloudflare — you need to tell GuardPress which addresses to trust.

Add CIDRs to Trusted Proxies

Go to GuardPress → Settings and scroll to the Network / Proxies section. The Trusted Proxies textarea accepts one IP or CIDR per line. Examples:

Save. GuardPress will now honour X-Forwarded-For / CF-Connecting-IP / etc. on any request originating from those addresses, in addition to the built-in Cloudflare ranges.

Extending or overriding the built-in Cloudflare ranges

The 22 baked-in CIDRs are snapshotted from cloudflare.com/ips-v4 + /ips-v6. Cloudflare’s edge ranges change rarely (years between additions) but if a new range appears before the next GuardPress release, you have two options:

What a Blocked Visitor Sees, and How to Unblock

A visitor matching a blocked country gets a plain Access Denied HTML page with a short error code (the first 8 characters of an MD5 of the block reason — useful for support, doesn’t leak the rule details). The HTTP status is 403; the page advises contacting the site administrator. There is no captcha, no “prove you’re a human” flow — geo blocking is a hard block.

To let a specific person through despite their country being blocked, add their IP to the whitelist:

  1. GuardPress → IP Management → Whitelist section
  2. Add the visitor’s real IP (or CIDR for a range)
  3. Save

Whitelist is checked BEFORE the geographic rule, so whitelisted IPs always bypass country blocking (and every other firewall check). The same precedence applies to legitimate search-engine bots — see the next section.

Search Engine Bots Are Exempt

GuardPress short-circuits the firewall — including geo blocking — for legitimate search-engine and platform crawlers. This prevents geo rules from accidentally de-indexing your site by blocking the Googlebot or Bingbot crawl. The major crawlers are recognised by user agent AND verified via reverse-DNS lookup against documented hostname suffixes:

Social and platform crawlers (Facebook, Twitter, LinkedIn, Pinterest, Slack, Telegram, WhatsApp, Discord) plus archive bots (archive.org, ia_archiver) and the major uptime monitors (UptimeRobot, StatusCake, Jetpack monitors) are trusted by user agent only — their infrastructure is too heterogeneous for DNS verification to work reliably.

This list is filterable via the guardpress_verified_bots filter (DNS-verified bots) and guardpress_whitelisted_bots filter (UA-trust bots) if you need to add or remove entries.

Common Pitfalls

VPN and proxy users from blocked countries get through

Country blocking is IP-based. A determined visitor in a blocked country can route through a commercial VPN whose exit nodes are in an allowed country, and they’ll resolve to the allowed country. There’s no general defence against this at the geo-block layer — if you need stronger gating, combine country blocking with login-protection (CAPTCHA, 2FA), rate limiting, and content-level access controls. Geo blocking is a noise filter, not an air gap.

Mobile carriers with IPs that rotate across countries

Some mobile carriers (especially in border regions, or low-cost MVNOs) assign IPs from country pools that don’t match the user’s physical location. A user in Belgium may resolve to France one session and Germany the next. If you block one of those, you’ll get intermittent customer complaints from real visitors. Tune the blocklist conservatively — block countries that produce sustained malicious traffic on your specific site, not countries you have a general impression about.

Page caches serving stale blocked-page responses

If your site has server-side caching (ForgeCache, Cloudflare full-page cache, host page cache), the 403 Access Denied page COULD be cached and served to subsequent visitors from non-blocked countries. GuardPress sends nocache_headers() with the block, which signals downstream caches not to store the response — but a cache that ignores cache-control headers (some aggressive Cloudflare Cache Rules, Varnish with hard overrides) can still misbehave. If you see country-block responses showing up for visitors who shouldn’t be blocked, audit your page cache’s honor-cache-headers setting first.

The visitor is whitelisted but still gets blocked

The whitelist matches against the IP GuardPress detects, not the raw REMOTE_ADDR. If real-IP detection isn’t configured behind your proxy, you’ll be whitelisting the visitor’s real IP while GuardPress is seeing the proxy IP — and the whitelist never matches. Run the diagnostic snippet from the “Verifying” section above to confirm the real IP is being detected.

The status line says the country database isn’t available

If the download fails, the status line turns red, shows the error, and country rules block no one until a database is in place. Click Retry download on the same card; GuardPress also retries on its daily check. The usual causes are a host firewall that blocks outbound downloads from PHP, a server PHP build without zlib support (the error says so), or an uploads folder WordPress can’t write to. If a monthly refresh fails after a database is already installed, the rules keep working with the older data and the status line shows a warning with the same Retry button.

FAQ

Does GuardPress send my visitors’ IPs to a third party?

No. Country rules look visitors up in the country database stored on your site, or use the country Cloudflare already attached to the request when your site is behind Cloudflare. The only outbound traffic is the database download itself, which happens when you turn the rules on and then about once a month, and it carries no visitor data.

Can I block a region or continent instead of individual countries?

Not directly. The selector is country-level. To block a region, add every country in the region to the blocklist individually — you can do this in one save.

Can I block Tor?

Yes, on sites behind Cloudflare. Add Tor network (sites behind Cloudflare) from the country dropdown. Cloudflare labels Tor traffic for you; without Cloudflare there is no country code for Tor, so the entry has no effect.

How do I add a custom CDN’s ranges if GuardPress doesn’t know about them?

Two options. Quick: paste their published IP ranges into GuardPress → Settings → Trusted Proxies. Permanent / code-driven: use the guardpress_known_proxy_ranges filter from a must-use plugin to register a new provider key with its CIDRs. Both work; the textarea is friendlier for non-developers and survives plugin updates.

I’m getting flooded with “Geographic restriction: CN” entries in my audit log

That means a lot of automated traffic from blocked countries is hitting your site, which is exactly what country blocking is for — the alert noise IS the protection working. If the audit log volume is more than you want, tune email alert throttling at GuardPress → Settings → Email Alerts → Alert Throttling (introduced in 1.6.29) so you get a summary instead of one email per block. The audit log itself is pruned daily.

Still Stuck? Email Priority Support

If country blocking isn’t blocking the visitors you expect, or it’s blocking visitors you don’t want to block:

Email support@royalplugins.com with the diagnostic info below. Priority email support is included with your GuardPress Pro license — typical response time is within 24 hours.

Information to include in your email

  • GuardPress version from WP Admin → Plugins (country rules need 1.6.54 or later)
  • WordPress version from WP Admin → Updates
  • Are you behind Cloudflare / Sucuri / StackPath / a custom load balancer? Name the proxy and whether it’s proxying ALL traffic or only some paths
  • Country codes on your blocklist (e.g. CN, RU, KP)
  • What the Geographic Access Rules status line says, and the result of Test an IP for an address you expected to be blocked
  • Output of the diagnostic snippet from the “Verifying” section above, captured from a request you expected to be blocked
  • A sample audit log entry from GuardPress → Audit Log showing a recent firewall block (action firewall_block) — we need to see what IP GuardPress logged
  • If unblocking a customer: their real IP (you can ask them to visit https://api.ipify.org to get it) and the country code we should expect for that IP
Related GuardPress topics

If you’re tightening up firewall and access controls more broadly: