What is whitedns-wizard?

WhiteDNS Wizard is a command-line tool written in Go that automates setting up a self-hosted VPN server on a rented cloud computer (VPS). Doing this manually would require juggling DNS configuration, SSL certificates, Docker containers, and a VPN management panel across many separate steps. WhiteDNS packages all of that into a single interactive menu you run on your local machine. The tool connects to Cloudflare (a service that manages your domain name and routes traffic) and to your VPS over SSH. Once you give it your Cloudflare API credentials, your domain name, and the address of your server, it handles the rest: creating the right DNS records, setting up strict TLS encryption, installing a Docker-based stack that includes a VPN panel called 3x-ui and a PostgreSQL database, and then printing ready-to-use connection strings you can paste into a VPN client app. The generated connection profiles cover a range of VPN protocols, including VLESS over WebSocket, Hysteria2, Shadowsocks, and Reality. Some are routed through Cloudflare's proxy network, which hides the server's real IP address. Others are direct. There is also a set of Tor-routed variants that send outbound traffic through the Tor anonymity network on the server side, so the destination website sees a Tor exit node address instead of your server. After the initial setup, the interactive menu gives you ongoing options: run diagnostics to check that everything is working, repair or restart the Docker stack, back up the configuration, restore from a backup, or generate a troubleshooting bundle you can share when asking for help. Secrets like API tokens are stored encrypted on disk so you can repeat any of these operations later without re-entering credentials. The project is aimed at people who want a managed, repeatable VPN setup on their own hardware and domain, with Cloudflare handling DNS and traffic proxying. It does not run a hosted service, everything lives on infrastructure you control.