https://github.com/dwisiswant0/fastdns
DNS at ludicrous speed for Go, powered by XDP sockets. [EXPERIMENTAL]
https://github.com/dwisiswant0/fastdns
af-xdp dns dns-client ebpf xdp
Last synced: 3 months ago
JSON representation
DNS at ludicrous speed for Go, powered by XDP sockets. [EXPERIMENTAL]
- Host: GitHub
- URL: https://github.com/dwisiswant0/fastdns
- Owner: dwisiswant0
- License: apache-2.0
- Created: 2025-05-12T12:39:29.000Z (5 months ago)
- Default Branch: experimental
- Last Pushed: 2025-06-28T21:15:37.000Z (4 months ago)
- Last Synced: 2025-07-03T19:58:02.109Z (4 months ago)
- Topics: af-xdp, dns, dns-client, ebpf, xdp
- Language: Go
- Homepage:
- Size: 199 KB
- Stars: 11
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# FastDNS
[](http://pkg.go.dev/github.com/dwisiswant0/fastdns)
**fastdns** is a high-performance DNS client for Go. It leverages Linux XDP sockets for ultra-low-latency, lock-free DNS queries, bypassing the kernel network stack for maximum throughput.
## Install
```bash
go get github.com/dwisiswant0/fastdns@latest
```
> [!NOTE]
> This library requires **`CAP_NET_ADMIN`** capability or **root** privileges to create & manage XDP sockets and attach programs to network interfaces.
## Example
```go
package main
import (
"fmt"
"net"
"github.com/dwisiswant0/fastdns"
"github.com/miekg/dns"
)
func main() {
// Define the DNS resolver to use.
// This should be a valid IP address of a DNS resolver.
resolver := net.ParseIP("1.1.1.1")
// Create a new FastDNS instance with the default resolver.
f, err := fastdns.New(resolver)
if err != nil {
panic(err)
}
// Ensure that the FastDNS instance is closed when done.
// Closing is essential to properly release all underlying XDP and socket
// resources.
//
// If Close is not called, system resources such as file descriptors and
// network handles may be leaked, which can eventually exhaust available
// resources and cause failures in network operations or prevent new FastDNS
// instances from being created.
defer f.Close()
// Create a new DNS query message.
msg := new(dns.Msg)
msg.SetQuestion(dns.Fqdn("cloudflare.com"), dns.TypeA)
// Send the DNS query and receive the response.
resp, _, err := f.Query(msg)
if err != nil {
f.Close()
panic(err)
}
fmt.Printf("Response: %v\n", resp.String())
fmt.Printf("Round-trip time: %v\n", rtt)
}
```
## Status
> [!CAUTION]
> **fastdns** has NOT reached 1.0 yet. Therefore, this library is currently not supported and does not offer a stable API; use at your own risk.
There are no guarantees of stability for the APIs in this library, and while they are not expected to change dramatically. API tweaks and bug fixes may occur.
## License
**fastdns** is released by **[@dwisiswant0](https://github.com/dwisiswant0)** under the Apache 2.0 license. See [LICENSE](/LICENSE).