explaingit

whitedns/whitedns-android

Analysis updated 2026-07-03 · repo last pushed 2026-06-20

1,056KotlinAudience · generalComplexity · 2/5ActiveLicenseSetup · moderate

TLDR

WhiteDNS is an Android app that routes your phone's internet traffic through DNS tunneling services to bypass network restrictions. It works as a VPN or a local proxy to mask your browsing activity.

Mindmap

mindmap
  root((repo))
    What it does
      DNS tunneling
      VPN mode
      Proxy mode
      Bypass restrictions
    How it works
      Captures network traffic
      Secure tunnel to server
      SOCKS5 support
      HTTP support
    Use cases
      Bypass blocked websites
      Mask browsing activity
      Switch server profiles
      Restrictive Wi-Fi networks
    Tech stack
      Android
      Kotlin
      MasterDNS
      StormDNS
    Audience
      Android users
      Censorship circumventers
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Bypass website blocks on restrictive Wi-Fi networks by routing traffic through a DNS tunnel.

USE CASE 2

Mask your browsing activity from network monitors using VPN mode on your Android device.

USE CASE 3

Set up a local SOCKS5 or HTTP proxy so other apps on your phone can tunnel their traffic.

USE CASE 4

Import and switch between server profiles for different DNS tunneling service configurations.

What is it built with?

KotlinAndroidMasterDNSStormDNS

How does it compare?

whitedns/whitedns-androidharmony-on-android/hoaamrdoh/clockmaster
Stars1,056121102
LanguageKotlinKotlinKotlin
Last pushed2026-06-20
MaintenanceActive
Setup difficultymoderatehardeasy
Complexity2/55/52/5
Audiencegeneraldevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an active account with a MasterDNS or StormDNS service to import server profiles and establish a connection.

The code is source-available for transparency but not open-source, you cannot copy, modify, or distribute your own versions without permission.

In plain English

WhiteDNS is an Android app that lets you route your phone's internet traffic through a DNS tunneling service, acting as either a VPN or a proxy. The main benefit is that it gives you a way to get around network restrictions or mask your browsing activity directly from your Android device. It connects to services powered by MasterDNS and StormDNS. At a high level, the app works in two modes. In VPN mode, it uses Android's built-in VPN feature to capture your phone's network traffic and funnel it through a secure tunnel to a remote server. In proxy mode, it sets up a local connection point (supporting SOCKS5 and HTTP) that other apps on your phone can direct their traffic through. Both modes use bundled networking tools to manage the heavy lifting of moving your data securely. This app is for people who need to control how their Android device connects to the internet, particularly in situations where normal connections are blocked or monitored. For example, if you are on a restrictive Wi-Fi network that blocks certain websites, you could use this app to route your traffic through a server that bypasses those limits. It supports importing and exporting server profiles, so you can easily switch between different server configurations provided by a DNS tunneling service. One notable aspect of the project is its licensing. The code is "source-available," meaning anyone can look at the code for transparency and contribute back to the official project, but it is not open-source. You cannot legally copy it, modify it, or distribute your own versions. The project also emphasizes that it has no presence on the Google Play Store, and any versions found there are unofficial and potentially unsafe. Official updates are only shared through the project's repository and Telegram channel.

Copy-paste prompts

Prompt 1
How do I configure WhiteDNS in VPN mode to route my Android phone's traffic through a MasterDNS server profile?
Prompt 2
Set up WhiteDNS in proxy mode with SOCKS5 so I can point other apps on my phone to tunnel through it.
Prompt 3
How do I import and export server profiles in WhiteDNS to switch between different DNS tunneling services?
Prompt 4
Explain the difference between VPN mode and proxy mode in WhiteDNS and which one I should use to bypass network restrictions.

Frequently asked questions

What is whitedns-android?

WhiteDNS is an Android app that routes your phone's internet traffic through DNS tunneling services to bypass network restrictions. It works as a VPN or a local proxy to mask your browsing activity.

What language is whitedns-android written in?

Mainly Kotlin. The stack also includes Kotlin, Android, MasterDNS.

Is whitedns-android actively maintained?

Active — commit in last 30 days (last push 2026-06-20).

What license does whitedns-android use?

The code is source-available for transparency but not open-source, you cannot copy, modify, or distribute your own versions without permission.

How hard is whitedns-android to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is whitedns-android for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub whitedns on gitmyhub

Verify against the repo before relying on details.