Skip to main content

Quick Start

This guide will help you find and configure the fastest DNS servers for your connection in just a few steps.

Step 1: Install DNS-MNS

Option A: Download the binary (Recommended) Go to the Releases page and download the binary for your platform. Then make it executable and run it:
chmod +x dns-mns-linux-amd64
./dns-mns-linux-amd64
On Windows, just double-click the .exe file. Option B: One-line install
curl -sSL https://gitlab.com/E-Gurl/dns-mns/-/raw/main/install.sh | bash
This automatically detects your OS and architecture and installs the correct binary.

Step 2: Launch the Tool

After installation, run:
dns-mns
If using the binary directly, run it from wherever you downloaded it. You’ll see the main menu:
【 MAIN MENU 】

  [1]  Test & Benchmark DNS
  [2]  Set / Reset DNS
  [3]  Encrypted DNS
  [4]  Security & Privacy
  [5]  Smart Proxy (Auto-Fallback)
  [6]  Live Dashboard
  [7]  Smart Recommend
  [8]  Advanced Evasion Suite
  [9]  Help & About
  [10] DNS Leak Test Dashboard
  [11] Passwall Integration
  [12] MikroTik Integration
  [0]  Exit

Step 3: Test DNS Servers

Press 1 to test DNS servers. You’ll see a category selection menu:
Select DNS category to test:

  [1] International Gaming DNS
  [2] Regional/Middle East DNS
  [3] Gaming Optimized DNS
  [4] VPN/Privacy DNS
  [5] Additional Iranian DNS
  [6] Test ALL DNS Servers

  [0] Back to Main Menu
For Iranian users: Start with option 2 (Regional/Middle East DNS) or option 3 (Gaming Optimized DNS) for best results.

Step 4: Wait for Results

The tool will test each DNS server and show a progress bar:
Testing DNS servers...
[████████████████████████░░░░░░░░░░░░░░░░] 60%
Testing takes 1-5 minutes depending on how many servers you selected.

Step 5: View Top Results

After testing completes, you’ll see the top 3 DNS servers:
TOP 3 DNS SERVERS

#1 Shecan
   Location: Iran
   Primary:   178.22.122.100
   Secondary: 185.51.200.2
   Ping: 15ms (Excellent)

#2 Electro
   Location: Iran
   Primary:   37.152.182.112
   Secondary: 37.152.182.113
   Ping: 18ms (Excellent)

#3 Cloudflare
   Location: Global
   Primary:   1.1.1.1
   Secondary: 1.0.0.1
   Ping: 25ms (Good)

Step 6: Apply the Best DNS

The tool will ask if you want to apply one of the top DNS servers:
Would you like to apply one of these DNS servers? (y/n): y
Enter selection (1-3): 1
The tool will request administrator/sudo privileges to change your DNS settings.

Step 7: Verify It’s Working

After applying, test your connection:
ping google.com
If you’re getting responses, you’re all set.

Step 8: Encrypted DNS and Tunnel Workflows

For enhanced privacy and censorship resilience:
  • Main Menu → [3] Encrypted DNS for DoH/DoT/DNSCrypt tests and local encrypted proxy controls
  • Main Menu → [8] Advanced Evasion Suite for sing-box protocols and Tunnel Suite workflows (DNSTT/Slipstream/Paqet)
What are DoH/DoT/DNSCrypt?
  • DNS over HTTPS (DoH): Encrypts DNS queries using HTTPS (port 443)
  • DNS over TLS (DoT): Encrypts DNS queries using TLS (port 853)
  • DNSCrypt: Encrypts and authenticates DNS traffic between client and resolver using the DNSCrypt protocol
Encrypted DNS menu actions include provider testing, DoH health checks, and starting/stopping local DoH/DoT or DNSCrypt proxy services. Advanced Evasion menu includes Tunnel Suite for profile-based tunnel operations:
  • profile create/list/select/import/export
  • start/stop/status/logs
  • resolver scan and health checks
These protocols can help bypass DNS filtering and blocking, which is particularly useful in regions with internet restrictions.
The tool tests 28+ DoH/DoT providers including international (Cloudflare, Google, Quad9, NextDNS, RethinkDNS) and regional (Shecan, Electro, RadarGame) options, plus DNSCrypt providers.

Resetting DNS

If you want to go back to your default DNS settings, run dns-mns and select option 3 from the main menu. This resets your DNS to automatic (DHCP), meaning your router/ISP will provide DNS servers again.

Next Steps

DNS Testing

Learn about the DNS testing algorithms

Setting DNS

Understand how DNS is configured on each platform

DNS Servers

Browse all 375+ DNS servers available

Troubleshooting

Fix common issues