Repository navigation
Releases: IzumiRain/HyperDNS
Release list
v2.8.0-beta.1
⚠️ UNSTABLE — development pre-release (v2.8.0-beta.1).
This build is a work in progress and is not recommended for production.
New installs should use the current stable line the README points at
(v2.2.0-beta.1); this tag exists for testing the features in flight.
Full list of changes: docs/CHANGELOG.md.
Full Changelog: v2.7.0-beta.1...v2.8.0-beta.1
v2.7.0-beta.1
⚠️ UNSTABLE — development pre-release (v2.7.0-beta.1).
This build is a work in progress and is not recommended for production.
New installs should use the current stable line the README points at
(v2.2.0-beta.1); this tag exists for testing the features in flight.
Full list of changes: docs/CHANGELOG.md.
Full Changelog: v2.6.0-beta.1...v2.7.0-beta.1
HyperDNS v2.6.0-beta.1 (HyperFORGE) — UNSTABLE
⚠️ UNSTABLE — development pre-release (v2.6.0-beta.1).
This build is a work in progress and is not recommended for production.
New installs should use the current stable line the README points at
(v2.2.0-beta.1); this tag exists for testing the features in flight.
Full list of changes: docs/CHANGELOG.md.
Full Changelog: v2.5.0-beta.1...v2.6.0-beta.1
HyperDNS v2.5.0-beta.1 (HyperFORGE) — UNSTABLE
⚠️ UNSTABLE — development pre-release (v2.5.0-beta.1).
This build is a work in progress and is not recommended for production.
New installs should use the current stable line the README points at
(v2.2.0-beta.1); this tag exists for testing the features in flight.
Full list of changes: docs/CHANGELOG.md.
Full Changelog: v2.4.0-beta.1...v2.5.0-beta.1
HyperDNS v2.4.0-beta.1 (HyperFORGE) — UNSTABLE
⚠️ UNSTABLE — development pre-release (v2.4.0-beta.1).
This build is a work in progress and is not recommended for production.
New installs should use the current stable line the README points at
(v2.2.0-beta.1); this tag exists for testing the features in flight.
Full list of changes: docs/CHANGELOG.md.
Full Changelog: v2.3.0-beta.1...v2.4.0-beta.1
HyperDNS v2.3.0-beta.1 (HyperFORGE) — UNSTABLE
⚠️ UNSTABLE — development pre-release (v2.3.0-beta.1).
This build is a work in progress and is not recommended for production.
New installs should use the current stable line the README points at
(v2.2.0-beta.1); this tag exists for testing the features in flight.
Full list of changes: docs/CHANGELOG.md.
Full Changelog: v2.2.0-beta.1...v2.3.0-beta.1
HyperDNS v2.2.0-beta.1 — Built-In ACME, Whitelist by Default, API v2 & a Real Console
⚡ What's new in v2.2.0-beta.1
Certificates are issued by the daemon itself. An in-process ACME client (RFC 8555) replaces certbot and acme.sh entirely — issuance and daily renewal happen while the service runs, and renewed certificates hot-swap into the live listeners without a restart. The HTTP-01 challenge is served out of the port-80 listener that is already running.
Client access whitelist is on by default. An unknown source is refused by DNS (with an RFC 8914 Extended DNS Error so the client learns why) instead of being served for free. Fresh installs ship whitelist-on; existing installs converge through a one-time migration.
REST API v2. A versioned successor contract: symmetric field names, cursor-paginated lists, RFC 9457 application/problem+json errors, dedicated action endpoints, and strict decoding — an unknown field is a 400, not a silently dropped typo. v1 keeps working with Deprecation/Sunset headers.
A console worth opening. hdns can now stop, start and uninstall the service, renders an aligned subscriber table, and sanitizes untrusted names against ANSI injection.
🔒 Security fixes (Mantis review, PoC-verified)
- F1 — the TLS loader now rejects expired, not-yet-valid and wrong-hostname CA-signed certificates instead of serving them to every client.
- F2 — a valid certificate pair is applied regardless of whether its paths match the stored ones.
- F3 — subscriber-listener rebinding now binds the replacement before shutting the old one down, so a failed bind no longer leaves the panel offline.
- F7 — the ACME gate is now atomic, so concurrent issuance attempts can't both run.
- F8 — a data race in the panel certificate pair accessor (race-detector only).
- The installer now enforces safe permissions on the
systemd-resolveddrop-in (755dir,644file).
📚 Docs
- Docs reorganized into
docs/: API, SECURITY, CHANGELOG, PRESET_CATALOG (renamed from SUPPORTED_GAMES — HyperDNS covers games, platforms, AI services, dev tools and social media, not only games). - New docs/TUTORIAL.md (+ Persian
TUTORIAL.fa.md): a full walkthrough from an empty VPS to subscribers connected, including the custom domain for the subscriber portal. - Dashboard screenshot in both READMEs; warnings condensed.
📦 Install
curl -fsSL https://raw.githubusercontent.com/IzumiRain/HyperDNS/v2.2.0-beta.1/scripts/install.sh | sudo bashA panel domain is mandatory (its A record must point at the server). Non-interactive: HYPERDNS_DOMAIN=dns.example.com HYPERDNS_EMAIL=you@example.com bash install.sh.
The offline bundle (hyperdns-offline-bundle.tar.gz / .zip) verifies itself by sha256 and works with zero outbound internet.
Full changelog: docs/CHANGELOG.md
Full Changelog: v1.2.0-beta...v2.2.0-beta.1
HyperDNS v1.2.0-beta — 171+ Games, REST API v1 & Auto-Upgrade
⚡ HyperDNS v1.2.0-beta Release
We are thrilled to announce HyperDNS v1.2.0-beta — featuring a massive expansion with 171+ supported games & platforms, the brand-new Developer REST API v1, Strict 1-IP multi-client accounting & real-time expiration watcher, and an intelligent zero-data-loss auto-detect installer!
Warning
Beta Preview Notice: This project is in active beta development. If you experience any bugs or routing quirks, please open an issue on GitHub Issues.
🌟 Highlights & What's New in v1.2.0-beta
🎮 1. Massive 171+ Games & Services Directory
- Tactical Shooters & Battle Royales Extra: Delta Force: Hawk Ops, Escape from Tarkov, HellDivers 2, Rust, Squad, DayZ, ArmA Reforger & 3, Dead by Daylight, Hunt: Showdown, Insurgency: Sandstorm, SCUM.
- Anime, Gacha & Modern MMORPGs: Genshin Impact, Honkai: Star Rail, Zenless Zone Zero, Wuthering Waves, Arknights: Endfield, Lost Ark, Throne & Liberty, Path of Exile 1 & 2, Warframe, Elden Ring, Black Desert Online, Final Fantasy XIV.
- Sports, Fighting & Racing: EA Sports FC 25 / FIFA, eFootball / PES, Street Fighter 6, Mortal Kombat 1, Tekken 8, 2XKO, Assetto Corsa & Competizione, Euro Truck Simulator 2, Forza Horizon 5, F1 24.
- Platforms, Anti-Cheats & Cloud Gaming: Faceit AC, Riot Vanguard, EasyAntiCheat (EAC), BattlEye, Ricochet, Denuvo, GeForce NOW, Boosteroid, Xbox Cloud Gaming, Razer Synapse, Logitech G Hub, Corsair iCUE.
- Streaming & Media: SoundCloud integration (Web & Desktop Player), Discord (Voice RTC + Chat + Updating fix), Spotify, Twitch, Kick.com.
- Developer 403 Suite: Docker Hub, OpenAI, Claude, npm, Gradle, Android SDK, PyPI, HuggingFace, Supabase, Vercel.
👉 View Full Supported Games Directory
🔌 2. Developer REST API v1 & Interactive Swagger Docs
- Headless API (
/api/v1) with Master API Key (X-API-Key) & JWT auth. - Endpoints for client lifecycle, QPS/RAM telemetry, live diagnostics, and online rule toggling.
- Interactive OpenAPI / Swagger documentation at
/api/v1/docs.
👉 View REST API Documentation & Code Samples
👥 3. Strict 1-IP Accounting & 1-Minute Expiration Watcher
- 1-Click dynamic IP binding URLs (
/r/:token) for subscribers. - Strict 1-IP policy per token (automatically replaces old IP when a new device connects, preventing account sharing).
- Automated 60-second background ticker to cut off DNS resolution for expired subscriptions.
🔄 4. Auto-Detection & Zero-Loss Safe Installer
- Installer auto-detects existing installations (
v1.1.0-beta), creates timestamped backups, and migrates configuration schemas while preserving 100% of accounts and custom rules.
🚀 Quick Installation
Online One-Liner (Ubuntu / Debian / CentOS):
curl -fsSL https://raw.githubusercontent.com/IzumiRain/HyperDNS/main/scripts/install.sh | sudo bash100% Standalone Offline Package:
Download hyperdns-offline-bundle.tar.gz attached below, extract, and run ./install.sh.
🔐 SHA256 Checksums
| File | SHA256 Hash |
|---|---|
hyperdns-linux-amd64 |
d4bdde6e6b5de677163cdf71a47308dc8053759bec5e2bcaa801990abf2ea362 |
hyperdns-linux-arm64 |
e127a457e76733b12480cf8aaab53fe922b42887c011816ee9c97606c07e5d91 |
hyperdns-windows-amd64.exe |
c4479f56168b3c447e751eccd7af7f6d35c5f0c28387ac65ed670a1e698a90b3 |
hyperdns-darwin-arm64 |
49785d5bdd91f1d285b6d4e9fd1ae2e6822df1498c3719b69efb998f372925b6 |
hyperdns-offline-bundle.tar.gz |
fbaa1062f8b6c0e4caf76a4304edcea7258bd1405ace6ec9b883e0feee88ce0b |
hyperdns-offline-bundle.zip |
aaa5b83d36cf6b9decb36449c393e4c9c255a308879909af370e79105571cb2f |
📄 License
Released under the GNU Affero General Public License v3.0 (AGPL-3.0).