Skip to content

jalaljaleh/Halundns

Repository files navigation


Logo

Halun DNS

A high-performance, parallel-testing DNS management tool for Windows.

Official Website · Report Bug · Request Feature

.NET Framework 4.7.2 Platform Windows License MIT Views

Halun DNS

Halun DNS is a modern Windows utility designed for users who need fast, reliable, and secure DNS management. Built on .NET Framework 4.7.2, it features a sophisticated parallel ping engine and advanced bypass testing for sanctions and filtering.

Key Features

  • ⚡ Parallel Ping Engine: Test latencies across your entire server list simultaneously using asynchronous semaphores.
  • 🌍 Sanction & Filtering Bypass: Real-time testing of URLs against specific DNS nodes to check for accessibility.
  • 🎨 Modern WPF UI: Clean, dark-themed interface with DPI awareness for 4K monitors.
  • 📥 Import/Export: Manage your server lists easily via standard JSON formats.
  • 🔔 System Tray Integration: Stay connected in the background with a native Windows notify icon.
  • 🛡 Admin-Safe: Built-in manifest handling for required network stack permissions.

Getting Started

Prerequisites

Installation

  1. Download the latest release from the Releases page.
  2. Extract the ZIP file.
  3. Run HalunDns.exe as Administrator.

Project Structure

  • MainWindow: The central hub for connecting/disconnecting and monitoring status.
  • DnsServerWindow: A dedicated dialog for adding and editing custom DNS nodes.
  • DnsWindowsHelper: Core logic for interacting with the WMI and Windows Registry for DNS changes.
  • DnsPingHelper: The engine behind the parallel latency and bypass testing.

Usage Example (serverlist.json)

[
  {
    "Name": "Cloudflare",
    "DnsAddress": "1.1.1.1",
    "DnsAddressAlt": "1.0.0.1",
    "Priority": 1,
    "Type": "Global"
  },
  {
    "Name": "Shecan",
    "DnsAddress": "178.22.122.100",
    "DnsAddressAlt": "185.51.200.2",
    "Priority": 2,
    "Type": "Bypass"
  }
]

Contributing

Contributions are welcome! Fork the Project Create your Feature Branch (git checkout -b feature/AmazingFeature) Commit your Changes (git commit -m 'Add some AmazingFeature') Push to the Branch (git push origin feature/AmazingFeature) Open a Pull Request

Contact

Jalal Jaleh - @jalaljaleh Project Link: https://github.com/jalaljaleh/HalunDns

Developed with ❤️ for a freer internet.

Release Checklist (done-by-agent)

  • Remove or hide any embedded secrets, keys, or certificates (none found).
  • Ensure COM visibility is disabled by default (AssemblyInfo set ComVisible(false)).
  • Set neutral resources language to en-US.
  • Update company and copyright information in AssemblyInfo.
  • Bump version numbers in AssemblyInfo if you want a new release version.
  • Code-sign binaries with your Authenticode certificate before publishing installers.
  • Create a proper release (zip/installer) and upload to GitHub Releases.

Author & Company

About

A high-performance, parallel-testing DNS management tool for Iranian or other nations.

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors