WhiteDNS/Soar-Server

If you already run a Lantern Soar-style DNS tunnel and want per-user accounts, quotas and a web panel instead of hand-editing config, this installer is worth a look — with the caveats below.

The problem

Setting up a DNS tunnel server normally means provisioning a VPS, pointing a domain at it, opening port 53, then editing config files and creating user keys by hand. Each new user becomes another manual edit, and giving someone a link or QR code is your own problem. Here, a guided installer takes a fresh Ubuntu or Debian machine through seven steps, creates the panel, and then account creation, links, QR codes and subscriptions happen in a browser dashboard. The result is a working panel address with a random path and per-account connection details.

What's different

The distinguishing choice is the guided installer rather than a stack of manual steps. One command downloads the stable release bundle for the server's architecture and verifies its checksum before changing the service; if that lookup or check fails, installation stops rather than replacing the old version. During install it checks A/NS records first, then runs an HTTPS test from inside the tunnel, and offers to retry, roll back or keep an explicitly "unverified" install, which exits non-zero. It also handles UFW rules for DNS and the management port after confirmation.

The panel then wraps three engines — Soar, Cotten and MasterDNS — under one account model, so a single account can expose several connection methods while sharing volume, expiry and speed limits. That is convenient for distributing one subscription to multiple clients, but the README is explicit that the shared link carries the same account identity, so it is not per-device isolation. Anti-abuse controls (connection-rate limits, destination scanning detection, upload ceilings and temporary quarantine) are shared across engines and enabled by default; these are separate from per-account traffic caps. The docs also note browser-interface reliability issues recorded in a dated report, so the panel is not presented as fully battle-tested.

Who should try it

A good fit is someone administering a small set of users on their own Ubuntu 22.04/24.04/26.04 or Debian 12/13 server, who wants accounts, quotas and shareable subscription links without building that management layer. The fact that the terminal installer is English/ASCII while the panel and guides are Persian-first matters: if you need Persian documentation and a Persian UI, this is unusually complete, and an English installation guide plus subscription docs also exist.

A poor fit is anyone expecting general-purpose proxy coverage: the README scopes the release to TCP 80/443 destinations and says UDP/QUIC, games and calls are not covered. Nor is it for someone who wants a fully verified production rollout today — physical-device, Iran-network and large production load testing are described as not yet complete.

Requirements and limitations

You need root or sudo with systemd on a supported Ubuntu/Debian release and architecture (amd64/x86_64 or arm64/aarch64); Go, Docker, Node and a separate database are not needed on the server. You must control a domain and its DNS records and have UDP/53 and TCP/53 reachable, with provider firewall and NAT configured outside the installer; UFW handling is only part of the path. The panel URL includes a random path that you must save, and account changes require refreshing the subscription or re-importing the direct link in the WhiteDNS app (1.6.8 or newer for full subscriptions).

Ongoing upkeep has two traps. Updating the binary alone does not rerun DNS checks or installation tests; the installer must be rerun for that. Versions older than beta8 need one installer run to get the maintenance service, and the docs advise backing up before upgrades. The older panel-less setup.sh path is still documented but is managed via sudo soar-manager, and migrating from its shared profile to panel accounts requires confirmation and fresh account links.

HotRepo's take

HotRepo first tracked this repository at 7 days old (created 2026-10-17) and recorded 119 total stars at #23 on the NEW-REPOSITORY board on 2026-10-25 — a snapshot of a young project, not a daily growth figure or an overall Trending rank. With only two recorded dates and no comparable daily-board history, persistence cannot yet be judged. Before committing, verify the supported-release matrix and the random-path login behaviour in the installation guide and the noted browser-interface reliability report.