Custom DNS-Server

A custom authoritative DNS server built with Node.js and TypeScript. It operates at the Authoritative DNS Server level in the DNS hierarchy, meaning it directly responds to queries for domains defined in its zone configuration.

This project demonstrates how DNS works internally by handling DNS queries and returning records from a local zone configuration

---

Internet DNS Hierarchy

            Root DNS Servers
                   │
                   ▼
             TLD Servers
        (.com, .org, .net, etc.)
                   │
                   ▼
       Authoritative DNS Server
            (This Project)
                   │
                   ▼
              DNS Records
    (A, AAAA, CNAME, NS, SOA)
                   │
                   ▼
                Client
         (Browser / Device)

         See in Img...
                   │
                   ▼
         [1_goSb1oow5UBNF3KkzvOX8A.png](https://github.com/01iamysf/DNS-Server/blob/main/1_goSb1oow5UBNF3KkzvOX8A.png)

Features

• Lightweight DNS server implementation
• Supports A, AAAA, NS, SOA, and CNAME records
• Zone records configured using a JSON file
• UDP based DNS query handling
• Easy to extend for learning and experimentation

---

Project Structure

DNS-Server

├── src # TypeScript source code

├── dist # Compiled JavaScript files

├── zones # DNS zone configuration

├── docs # Documentation and deployment guides

---

Installation

• Clone the repository:

git clone https://github.com/01iamysf/DNS-Server.git cd DNS-Server

• Install dependencies:

  • npm install

  • Build the project:

  • npm run build

  • Run the DNS Server

  • sudo node dist/server.js

• The server listens on UDP port 53 and resolves domains based on the records defined in "zones/zones.json".

---

Testing

• Example DNS query:

  dig @127.0.0.1 -p 5300 mysite.dev

  dig @127.0.0.1 -p 5300 ysf.host

  dig @127.0.0.1 -p 5300 doman.name

---

Author

Md Yusuf