Real IP Restore for Cloudflare
| 开发者 | websolman |
|---|---|
| 更新时间 | 2026年6月2日 16:25 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPL-2.0-or-later |
| 版权网址: | 版权信息 |
详情介绍:
On many shared cPanel hosts - Bluehost, HostGator, Namecheap, A2 Hosting, GoDaddy, and European providers such as IONOS, OVHcloud or Krystal - Apache does not natively restore the client IP from Cloudflare headers. This causes WordPress, WooCommerce, security plugins and access logs to record Cloudflare's edge IP instead of the real visitor IP.
Real IP Restore for Cloudflare fixes this transparently:
- On every request, checks whether
REMOTE_ADDRbelongs to a Cloudflare IP range. - If yes, replaces
REMOTE_ADDRwith the value fromCF-Connecting-IP(orX-Forwarded-Foras fallback). - IP ranges are fetched once per day from Cloudflare's official endpoints and cached as a WordPress transient.
- Zero configuration - works out of the box.
- IPv4 and IPv6 support.
- Daily auto-refresh of Cloudflare IP ranges.
- Manual refresh from Settings → CF Real IP.
- Falls back to hardcoded ranges if Cloudflare endpoints are unreachable.
- Lightweight - no database tables, no options, no JavaScript.
安装:
- Upload the plugin folder to
/wp-content/plugins/. - Activate via Plugins → Installed Plugins.
- Done. Visitor IPs are now correctly logged.
常见问题:
Does this work with WooCommerce fraud detection?
Yes. All plugins that read $_SERVER['REMOTE_ADDR'] will receive the real visitor IP.
What if my server already handles real IPs via mod_remoteip?
The plugin checks the IP against Cloudflare ranges before replacing it. If REMOTE_ADDR is not a Cloudflare IP, nothing is changed.
Can I manually refresh the IP range cache?
Yes - Settings → CF Real IP → Refresh IP Ranges Cache.
更新日志:
1.3.1
- Compatibility check against WordPress 7.0.
- Translations loaded automatically via plugin slug (removed manual load_plugin_textdomain call).
- Added a manual "Refresh IP Ranges Cache" action on the settings screen.
- Settings page now displays the current detected REMOTE_ADDR.
- Hardened header handling: visitor IP is only trusted when the request originates from a verified Cloudflare range (anti-spoofing).
- Added French and Spanish translations.
- Added IPv6 range matching.
- Daily auto-refresh of Cloudflare IP ranges via WP-Cron.
- Initial release.