Installation Guide

Complete guide to set up Base Cloak on your website

Quick Start

Get started with Base Cloack in just 5 minutes. Follow these simple steps to protect your website from unwanted traffic.

Step 1: Start the Bot

Open Telegram and start a conversation with our bot:

  1. Click @basecloak_bot or search for "Base Cloak" in Telegram
  2. Press the /start button
  3. Choose your preferred language (English or Russian)
  4. Accept the Terms of Service

Step 2: Purchase a Subscription

Select a plan that fits your needs:

  1. Click "Buy Subscription" in the main menu
  2. Choose your plan (Lite, Premium, or Unlimited)
  3. Select the subscription period
  4. Complete payment through CryptoBot (USDT)

Note: You can top up your balance first and then purchase a subscription.

Step 3: Add Your Domain

Register your website domain:

  1. Click "My Domains" in the main menu
  2. Click "Add Domain"
  3. Enter your domain name (e.g., example.com)
  4. Wait for confirmation

Step 4: Configure Filters

Set up your protection rules:

  1. Click on your domain in "My Domains"
  2. Configure the following options:
    • Bot Blocking: Enable to block known bots and scrapers
    • Country Filtering: Select countries to block or allow
    • IP Blocking: Add specific IP addresses to blacklist
    • ASN Filtering: Block VPNs, proxies, and datacenters
  3. Set your redirect URL (where blocked visitors will be sent)

Step 5: Download PHP Script

Get your protection script:

  1. In domain settings, click "Download Script"
  2. Click "Get PHP Script"
  3. Save the file (e.g., cloaking_example_com.php)

Important: Do not modify the script file! It contains cryptographic signatures that will break if changed.

Step 6: Upload to Server

Install the script on your web server:

  1. Connect to your server via FTP, SFTP, or SSH
  2. Upload the PHP file to your website's root directory:
    • /public_html/ (cPanel)
    • /var/www/html/ (Linux)
    • /httpdocs/ (Plesk)
  3. Rename the file to cloaking.php (optional but recommended)

Step 7: Integrate with Your Site

Add the protection to your website:

Method 1: Include in index.php (Recommended)

<?php
// Add this at the very top of your index.php
require_once 'cloaking.php';
?>

Method 2: Auto-prepend (Advanced)

Add to your .htaccess file:

php_value auto_prepend_file "/path/to/cloaking.php"

Method 3: php.ini (Server-wide)

Add to your php.ini file:

auto_prepend_file = "/path/to/cloaking.php"

Step 8: Test Your Setup

Verify everything is working:

  1. Visit your website in a normal browser - you should see your site normally
  2. Check the bot for statistics - you should see visitor data
  3. Test with a VPN or proxy - blocked visitors should be redirected
  4. Check for any PHP errors in your server logs

Requirements

Your server must meet these requirements:

  • PHP Version: 7.4 or higher (8.0+ recommended)
  • cURL Extension: Must be enabled
  • JSON Extension: Must be enabled
  • File Permissions: PHP file must be readable
  • Internet Access: Server must be able to make outbound HTTPS requests

Troubleshooting

Script not working?

  • Check PHP version: <?php echo phpversion(); ?>
  • Verify cURL is enabled: <?php echo function_exists('curl_init') ? 'Yes' : 'No'; ?>
  • Check file permissions (should be 644 or 755)
  • Look for errors in PHP error log

Getting "Script integrity violation" error?

  • Do not modify the PHP file in any way
  • Re-download the script from the bot
  • Make sure you uploaded the file in binary mode (not ASCII)
  • Check that the file wasn't corrupted during upload

Visitors not being blocked?

  • Verify filters are enabled in domain settings
  • Check that the script is included before any output
  • Make sure the API server is running
  • Test with a known bot user-agent or blocked country

Site is slow after installation?

  • The script adds minimal overhead (< 50ms typically)
  • Check your server's internet connection speed
  • Consider using a CDN for your main content
  • Contact support if issues persist

Viewing Statistics

Monitor your protection in real-time:

  1. Open the Telegram bot
  2. Go to "My Domains"
  3. Click on your domain
  4. Click "Statistics" to view:
    • Total blocks by reason
    • Top blocked countries
    • Top blocked IPs
    • Traffic graphs by day/hour

Need Help?

If you encounter any issues or have questions:

  • Contact support through the Telegram bot
  • Check our FAQ section in the bot
  • Email us at: support@basecloak.com

You're All Set!

Congratulations! Your website is now protected by Base Cloak. Monitor your statistics regularly and adjust filters as needed to optimize your traffic quality.