MasterDnsVPN
SHA-256A research project that tunnels TCP traffic through DNS queries and responses, designed for censorship resistance and harsh network conditions. Up to 9x faster than DNSTT and 3.6x faster than SlipStream.
Tunnel TCP over DNS with ultra-low overhead, surviving even total internet blackouts.
Core Features
- Ultra-low protocol overhead: only 5-7 bytes header, 88% lower than DNSTT, 71% lower than SlipStream
- Multi-path with packet duplication: send data through multiple DNS resolvers for higher delivery rate
- Smart failover: automatically detect and switch unhealthy resolvers
- 8 built-in load balancing modes for flexible traffic distribution
- Optimized SOCKS5/4 support, can carry Shadowsocks, VLESS, etc.
What It Can't Do
- •This project is for educational and research purposes only. Check local laws before use. In extremely harsh networks, you may need to manually adjust MTU and retransmission timeouts. The developers assume no liability for misuse.
Use Cases
- Bypass strict internet censorship and firewalls
- Restore international connectivity during total internet blackouts
- Research and education: test DNS tunneling under various network conditions
Detailed Introduction
MasterDnsVPN is a scientific and research-oriented project that carries TCP traffic through DNS queries and responses. It is similar to projects like DNSTT or SlipStream but follows a fundamentally different structure and implementation approach. The system is designed around compatibility with many resolver behaviors and harsh network conditions, with the goal of preserving the highest possible stability and data delivery even in the worst cases. It features a lightweight custom protocol with retransmission logic, multipath and packet duplication, smart resolver selection and health checks, MTU discovery, SOCKS5/SOCKS4 support, optional compression, flexible encryption, and a client-side local DNS service. It has been battle-tested during a total internet blackout in Iran, proving its ability to function when 99% of international bandwidth is cut.
Troubleshooting & FAQ (1)
TroubleshootingHow to fix Ookla speedtest CLI installation failure on Ubuntu 24.04?
The auto install script fails silently because there is no official Ookla repository for Ubuntu 24.04 (noble). As a workaround, use the alternative installation method provided by Ookla: https://support.ookla.com/hc/en-us/articles/32139787616141-Install-CLI-client-on-Ubuntu-24-04-noble. This guide includes manual steps to download and install the CLI.
Tags
Getting Started
Download installer
Click the button above to download the installer for your system
Install the software
Double-click the downloaded installer and follow the prompts
Step 1: Download the latest binary for your OS from GitHub Releases
Step 2: Configure the server (requires a public IP) with DNS resolvers and encryption settings per the documentation
Step 3: Run the client and connect your browser/app via local SOCKS5 proxy (default port 1080)
- Step 1: Download the latest binary for your OS from GitHub Releases
- Step 2: Configure the server (requires a public IP) with DNS resolvers and encryption settings per the documentation
- Step 3: Run the client and connect your browser/app via local SOCKS5 proxy (default port 1080)
SHA-256 checksum verified
Checksum extracted from GitHub official Release page
SHA256 Checksum
320f7b6e6458de6b9177005318df1bbf37047fbcf518fe7e9ae9b5ba2fea5572This checksum is extracted from the GitHub Release page. Verify file integrity after download.
All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.
Open Source Transparency
View GitHub SourceUninstall Info
Delete the downloaded binary and configuration file (default config.json in the same directory).
No Extra Dependencies
Ready to use after download. No additional runtime required.
Having issues? Check the FAQ below
1 FAQ
Similar Projects
Immich
High performance self-hosted photo and video management solution with automatic backup, AI search, facial recognition, and multi-user support.
syncthing
A continuous file synchronization program that syncs files between devices securely and automatically, with no central server.
uBlock Origin
uBlock Origin is a wide-spectrum content blocker for Chromium and Firefox that is CPU and memory efficient. Blocks ads, trackers, miners, and malware out of the box.