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.
After installation, run:
If using the binary directly, run it from wherever you downloaded it.
You’ll see the main menu:
[ MAIN MENU ]
[1] Test Gaming DNS
Test all DNS servers and find the top 3 best for gaming
[2] Set Custom DNS
Manually configure DNS server of your choice
[3] Clear/Reset DNS
Reset DNS settings to automatic (DHCP default)
[4] Test DoH/DoT DNS
Test encrypted DNS (DNS over HTTPS/TLS)
[5] Help & About
Learn more about DNS-MNS
[6] Test DNSCrypt
Test encrypted DNS (DNSCrypt protocol)
[7] DNSCrypt Proxy
Start a local DNSCrypt proxy
[8] DoH/DoT Proxy
Start a local DoH or DoT encrypted proxy
[9] DNS Censorship Check
Detect DNS poisoning, hijacking, and blocking
[10] Smart Proxy (Auto-Fallback)
Resilient encrypted DNS proxy with auto protocol switching
[0] Exit
Quit the application
Enter your choice [0-10]:
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:
If you’re getting responses, you’re all set.
Testing Encrypted DNS (DoH/DoT/DNSCrypt)
For enhanced privacy and to bypass DNS-based censorship, test encrypted DNS providers:
[ MAIN MENU ]
[4] Test DoH/DoT DNS
Test encrypted DNS (DNS over HTTPS/TLS)
[6] Test DNSCrypt
Test DNSCrypt providers for encrypted DNS
[7] Start DNSCrypt Proxy
Run a local DNSCrypt proxy server
What is 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
Option [6] tests available DNSCrypt providers for reachability and response time. Option [7] starts a local DNSCrypt proxy that forwards your DNS queries through an encrypted DNSCrypt connection.
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