Skip to content

v1.0.0

Choose a tag to compare

View all tags
@iampedii iampedii released this 05 Jun 18:04
· 8 commits to main since this release
v1.0.0
6000243

First public release of WhiteDNS, a Cloudflare-first CLI/TUI wizard for provisioning a managed 3x-ui/Xray VPN stack on a VPS.

Highlights

  • Interactive ./whitedns menu for setup, diagnostics, repair, backup, restore, reset, delete, and support bundles.
  • Cloudflare automation for DNS records, SSL mode strict, Origin CA certificates, and ACME wildcard certificates.
  • Local SSH-based VPS provisioning.
  • Managed Docker stack with 3x-ui, PostgreSQL, and an internal Tor sidecar.
  • Encrypted local project secrets under ~/.wdns-wizard.
  • Copyable client import strings for all generated profiles.
  • Release assets for Linux, macOS, Windows, BSD, and Termux Android ARM64.

Generated Profiles

WhiteDNS creates 12 importable client profiles:

  • VLESS WS through Cloudflare: vpn.<domain>:443
  • VLESS WS 8443 through Cloudflare: trojan.<domain>:8443
  • Hysteria2 direct: hy2.<domain>:443/udp
  • Direct VLESS TCP TLS: direct.<domain>:2087
  • Reality XHTTP direct: reality.<domain>:2083
  • Shadowsocks 2022 direct: ss.<domain>:8388
  • VLESS WS Tor: tor-vless-ws.<domain>:2097
  • VLESS WS 8443 Tor: tor-vless-ws-8443.<domain>:2098
  • Hysteria2 Tor: tor-hy2.<domain>:2099/udp
  • Direct VLESS Tor: tor-direct.<domain>:2100
  • Reality XHTTP Tor: tor-reality.<domain>:2101
  • Shadowsocks Tor: tor-ss.<domain>:8390

Requirements

  • Cloudflare account with an active zone.
  • Cloudflare API token with DNS, Zone Settings, SSL/Certificates, and Zone read/write permissions.
  • Linux VPS with SSH access.
  • Docker-capable VPS. WhiteDNS can install Docker and Docker Compose plugin when missing.

Notes

  • Tor profiles route server-side outbound traffic through Tor.
  • The VPS still sees the client IP; destination sites see the Tor exit IP.
  • UDP traffic through Tor profiles may fail because Tor is TCP-oriented.
  • Direct, Hysteria2, Reality, Shadowsocks, panel, and Tor hosts must stay DNS-only in Cloudflare.
  • The 3x-ui dashboard is available at http://panel.<domain>:2053/<base-path>/.

Install

Download the asset for your platform, extract it, then run:

./whitedns
Assets 23
Loading