Tikhole

Welcome to Tikhole, your DNS forwarder with the power of black hole filtering for MikroTik routers. Unleash the cosmic force of DNS-based firewall filtering and take control of your network’s destiny.

Overview

Tikhole is a forward-thinking DNS forwarder that goes beyond traditional methods. By connecting to a MikroTik router, Tikhole dynamically updates address-lists based on DNS responses, allowing you to implement precise IP-based firewall filtering.

Features ?

  • Dynamic DNS Filtering: React to DNS responses in real-time and apply filtering rules to MikroTik router address-lists.
  • Regex Rule Matching: Define rules on the rules page using regex patterns to selectively filter DNS responses.
  • MikroTik Integration: Seamlessly connect Tikhole to your MikroTik router, enhancing your network’s security with IP-based filtering.
  • Real-time Web Interface: Configure Tikhole, view real-time logs, and monitor DNS requests passing through Tikhole, all through a user-friendly web interface.
  • Cosmic Control: Take charge of your network’s destiny by gaining control over IP addresses linked to DNS queries.

Getting Started with Docker ?

Prerequisites

Before you embark on your cosmic journey with Tikhole, ensure you have the following installed on your system:

Launch Tikhole with Docker

  1. Pull the Tikhole Docker Image:
docker pull ghcr.io/belowaverage-org/tikhole:latest
  1. Launch Tikhole with Docker:
docker run -d -p 8080:80 -v /path/to/config/folder:/Tikhole.Website/config --name Tikhole ghcr.io/belowaverage-org/tikhole:latest
  1. Explore DNS Filtering: Open your web browser and witness the magic at http://localhost:8080.
  2. Configure Tikhole through the Web Interface:
    • Login to the web interface at http://localhost:8080.
    • Use your MikroTik router login credentials since Tikhole validates them over the MikroTik API.
    • Ensure your MikroTik router has the API enabled.
    • If your MikroTik router is configured with the default IP of 192.168.200.1 and the default API port, no configuration change will be nessesary. Otherwise, edit the Tikhole config file manually at /Tikhole.Website/config/Tikhole.xml.
  3. Editing Tikhole Configuration Manually:
    • After running Tikhole once, the configuration file (Tikhole.xml) will auto-generate.
    • Edit the file with your specific MikroTik router details and configurations.
    • Restart Tikhole for the changes to take effect.
  4. Set MikroTik API IP, Port, Username, and Password:
    • Browse to the Settings page on the web interface.
    • Configure the MikroTik router API ip, port, username, and password.
    • It is advisable to create a dedicated user on the router with full API permissions enabled for security.