Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lucavallin/vodo
A primitive DNS server written in Rust for fun.
https://github.com/lucavallin/vodo
dns networking rust
Last synced: 3 months ago
JSON representation
A primitive DNS server written in Rust for fun.
- Host: GitHub
- URL: https://github.com/lucavallin/vodo
- Owner: lucavallin
- License: mit
- Created: 2023-07-03T13:48:36.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-04-30T15:40:43.000Z (6 months ago)
- Last Synced: 2024-06-30T11:29:44.430Z (4 months ago)
- Topics: dns, networking, rust
- Language: Rust
- Homepage: https://lucavall.in
- Size: 1.07 MB
- Stars: 24
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 
vòdo
A primitive DNS server written in Rust for fun.
```bash
@lucavallin ➜ /workspaces/vodo (main) $ ./target/debug/vodo -h
A primitive DNS server written in Rust for fun.
Usage: vodo [OPTIONS]
Options:
-p, --port Port for the server to listen on [default: 5353]
-h, --help Print help
-V, --version Print version
```
## Usage
```bash
# Build the server
$ cargo build --release
# Run the server (or use cargo run)
$ ./target/release/vodo -p 5353
# Query the server
$ dig @127.0.0.1 -p 5353 cavall.in
; <<>> DiG 9.18.16-1~deb12u1-Debian <<>> @127.0.0.1 -p 5353 cavall.in
; (1 server found)
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 8919
;; flags: qr rd ra; QUERY: 1, ANSWER: 4, AUTHORITY: 2, ADDITIONAL: 0
;; QUESTION SECTION:
;cavall.in. IN A
;; ANSWER SECTION:
cavall.in. 1799 IN A 185.199.111.153
cavall.in. 1799 IN A 185.199.108.153
cavall.in. 1799 IN A 185.199.109.153
cavall.in. 1799 IN A 185.199.110.153
;; AUTHORITY SECTION:
cavall.in. 1800 IN NS dns1.registrar-servers.com.
cavall.in. 1800 IN NS dns2.registrar-servers.com.
;; Query time: 120 msec
;; SERVER: 127.0.0.1#2053(127.0.0.1) (UDP)
;; WHEN: Sun Jul 23 16:04:24 UTC 2023
;; MSG SIZE rcvd: 225
```
## Makefile
I have included a Makefile to make it easier to build and run the server.
```bash
# Build the server
$ make build[-release|-debug]
# Run the server
$ make run [port=5353]
# Clean the build
$ make clean
# Query the server
$ make query [hostname=example.com]
```
## Limitations
- There is no true concurrency in this server.
- It does not support TCP, IPv6, EDNS or DNSSEC.
- It cannot be used to host its own zones, and allow it to act as an authorative server.
- There is no caching.
- There are no automated tests or benchmarks.
## Improvements
- Use [tokio-rs/bytes](https://github.com/tokio-rs/bytes) for handling buffers and `bitvec` for bit manipulation.
- Async/await with tokio.rs (`header.rs` and `packet.rs` could use [tokio_util::codec](https://docs.rs/tokio-util/latest/tokio_util/codec/index.html))