Skip to main content

Proxy & VPN Blocker Documentation

Welcome to the complete documentation for Proxy & VPN Blocker - the essential WordPress security plugin that helps you detect and block traffic from VPNs, proxies, TOR networks, and other anonymization services.

What is Proxy & VPN Blocker?​

Proxy & VPN Blocker is a powerful WordPress security plugin designed to protect your website from unwanted traffic, spam, fraud, and abuse. By identifying visitors using anonymization services, you can:

  • Reduce spam from automated bots and malicious users
  • Prevent fraudulent registrations and form submissions
  • Protect premium content from unauthorized access
  • Improve site performance by blocking resource-intensive traffic
  • Enhance security by identifying high-risk connections

Free vs Premium Editions​

Proxy & VPN Blocker is available in two editions to suit different needs:

Perfect for Basic Protection​

The Free edition provides essential VPN and proxy detection with simple, effective blocking:

  • ✅ Basic VPN/Proxy Detection - Identify common anonymization services
  • ✅ Simple Block Pages - Display clear blocking messages to detected visitors
  • ✅ WordPress Integration - Seamless integration with your existing site
  • ✅ proxycheck.io Integration - Leverage industry-leading IP intelligence
  • ✅ Local Caching - Reduce API calls and improve performance

Ideal for: Bloggers, small business websites, and sites with basic security needs.

How It Works​

Proxy & VPN Blocker operates at the earliest stage of WordPress request processing, ensuring maximum effectiveness:

  1. IP Detection - Extract the visitor's real IP address (even behind proxies/CDNs)
  2. Classification - Query proxycheck.io's database to classify the IP address
  3. Caching - Store positively detected results locally to minimize API usage and improve speed
  4. Evaluation - Apply your configured blocking rules and logic
  5. Enforcement - Block, challenge, or redirect based on your settings

Key Technologies​

  • proxycheck.io Integration - Industry-leading IP intelligence and classification
  • Early Request Processing - Block threats before they reach your content
  • Smart Caching - Optimize performance while maintaining accuracy
  • Flexible Enforcement - Multiple blocking methods for different scenarios

Common Use Cases​

🛡️ Spam Prevention​

Block automated bots and comment spam from VPN/proxy users while allowing legitimate visitors.

🛒 E-commerce Protection​

Prevent fraudulent orders, fake accounts, and payment fraud from anonymized connections.

📧 Form Security​

Stop spam registrations, contact form abuse, and newsletter sign-up fraud.

🎯 Content Protection​

Restrict access to premium content, downloads, courses, or member-only areas.

📊 Analytics Accuracy​

Improve your site analytics by filtering out bot traffic and proxy visits.

🔒 Enhanced Security​

Identify high-risk connections and potential threats before they access sensitive areas.

Quick Start Guide​

For New Users​

  1. Installation - Install and activate the plugin
  2. Setup Wizard - Configure basic settings in minutes
  3. Detection Settings - Understand how detection works
  4. Plugin Settings - Customize blocking behavior

For Premium Users​

  1. API Configuration - Set up proxycheck.io integration
  2. Advanced Rules - Configure rule-based targeting
  3. Custom Pages - Design custom block and challenge pages
  4. Monitoring - Track detection statistics

Documentation Structure​

Our documentation is organized into clear sections to help you find exactly what you need:

Need Help?​

Ready to Get Started?​

Choose your path based on your needs:

Start with the Free Edition for essential VPN and proxy blocking.

Next Steps: Installation Guide → Setup Wizard → Understanding Detection