Desktop 1.3 and Android 1.3.4 clean-IP scanner, proxy checker, ASN target expander, and WhiteDNS toolkit.

English · فارسی · Downloads

Download the latest files from the GitHub Releases page:

https://github.com/WhiteDNS/WhiteDNS-cleanip-finder/releases

WhiteDNS is a clean-IP discovery and proxy workflow toolkit. It expands IP ranges, scans ports, tests TLS/SNI behavior, verifies HTTP and SOCKS5 proxies, exports ASN targets, and saves results in a format that is easy to reuse in proxy and routing workflows.

• Native Go scanner engine with CIDR expansion, concurrency control, pause/resume, stop, progress, and result export.
• Desktop terminal UI for scanning, routing, DPI/desync-related workflows, config tools, and proxy operations.
• Android app with IP/CIDR scan, SNI scan, HTTP proxy scan, SOCKS5 scan, ASN export, foreground service scanning, and storage export.
• ASN-aware target handling using embedded datasets.
• Standalone desktop builds with embedded runtime assets.
• Android multi-ABI builds: armeabi-v7a, arm64-v8a, x86, x86_64, universal APK, and release AAB.

Go to Releases and download the file for your operating system:

Why can't I just double-click it on macOS/Linux? WhiteDNS is a terminal UI (TUI) application — it draws its interface inside a terminal, so it has no window to open on double-click. On Windows the .exe automatically launches a console, but on macOS and Linux a bare command-line binary won't auto-attach a terminal (and Linux file managers block running downloaded binaries for security). You must run it from a terminal as shown below.

Windows PowerShell:

.\whitedns-windows-amd64.exe -mode ui -host 0.0.0.0 -port 8080

macOS (Intel: whitedns-macos-amd64 · Apple Silicon: whitedns-macos-arm64):

# cd into the folder where you downloaded the binary
cd ~/Downloads

# make it executable (only needed once)
chmod +x ./whitedns-macos-arm64

# clear Apple's Gatekeeper quarantine flag on the download (only needed once)
xattr -d com.apple.quarantine ./whitedns-macos-arm64

# run it
./whitedns-macos-arm64 -mode ui -host 0.0.0.0 -port 8080

If you skip the xattr step, macOS shows "cannot be opened because the developer cannot be verified." You can also right-click the file in Finder → Open → Open to whitelist it once.

Apple Silicon (M1/M2/M3/M4): the released macOS binaries are ad-hoc code-signed, so they run without the killed error. If you ever see zsh: killed (e.g. on a binary you built yourself), apply an ad-hoc signature once:

codesign --force --sign - ./whitedns-macos-arm64

Linux (x64: whitedns-linux-amd64 · ARM64: whitedns-linux-arm64):

# cd into the folder where you downloaded the binary
cd ~/Downloads

# make it executable (only needed once)
chmod +x ./whitedns-linux-amd64

# run it
./whitedns-linux-amd64 -mode ui -host 0.0.0.0 -port 8080

Proxy-only mode (macOS/Linux):

./whitedns-linux-amd64 -mode proxy -host 0.0.0.0 -port 8080

Note: The leading ./ is required — without it the shell only searches system PATH, not the current folder, and you'll get command not found.

• Results and logs are written beside the executable in WhiteDNS output folders.
• ASN datasets and Cloudflare domain assets are embedded in the binary.
• Use the TUI for the full workflow experience.
• Use proxy mode when you only need the local proxy/tunnel behavior.

From Releases, download one of the Android artifacts:

1. Download the APK to your phone.
2. Open it from your file manager.
3. Allow installation from your browser/file manager if Android asks.
4. Open WhiteDNS IP Scanner.
5. Grant storage/folder access if you want the app to create and write to the public WhiteDNS Scanner folder.

• IP / CIDR Scan
• SNI Scanner
• HTTP Proxy Scan
• SOCKS5 Scan
• ASN Export
• Pause / Resume / Stop scanning
• Results, logs, and ASN exports saved under WhiteDNS Scanner

When folder access is granted, WhiteDNS writes to a user-visible folder:

/sdcard/WhiteDNS Scanner/

Fallback/app-specific location:

/sdcard/Android/data/com.whitescan.app/files/WhiteDNS Scanner/

• Go 1.25+
• PowerShell on Windows, or bash on Linux/macOS
• For Windows desktop icon embedding: go install github.com/tc-hib/go-winres@latest
• For Android: JDK 17, Android SDK API 34, NDK r26, Gradle 8.7, gomobile

Build all desktop targets:

.\build_cross_platform.ps1 -CleanBuild

The Windows .exe build embeds the same WhiteDNS icon used by Android. The script generates the Windows resource file automatically when go-winres is available.

Run tests:

go test ./...

Build the Go mobile AAR:

.\build-aar.ps1

Build Android from the android folder:

cd android
gradle assembleRelease bundleRelease

For complete Android build instructions, see:

android/README.md

1. Create a branch.
2. Run go test ./....
3. Build the affected target.
4. Open a pull request with a clear summary and test notes.

Use WhiteDNS only on networks, hosts, and ranges you own or have permission to test. You are responsible for complying with local laws, provider rules, and network policies.