From b7359e1d45f505171356bcae3c7d5e2341ecc859 Mon Sep 17 00:00:00 2001
From: radhitya <alif@radhitya.org>
Date: Sun, 21 Jun 2026 09:48:42 +0700
Subject: forward mode, cache opt, ACL, rate limit, admin/health, systemd, fix
 UDP reply

---
 README.md | 56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)
 create mode 100644 README.md

(limited to 'README.md')

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5ceeb66
--- /dev/null
+++ b/README.md
@@ -0,0 +1,56 @@
+## Linum
+
+A simple DNS recursive resolver written in Golang
+
+### Features
+
+- Forward resolver
+- Adblock
+
+### Config Reference
+
+Save it to `/etc/linum.toml`
+
+```toml
+[server]
+listen_udp = ":5353"
+listen_tcp = ":5353"
+listen_doh = ":8443"
+
+[cache]
+max_entries = 100000
+db_path = "/tmp/cache.db"
+
+[resolver]
+mode = "forward"
+timeout = "2s"
+max_delegations = 30
+forwarders = ["1.1.1.1"]
+
+[blocklist]
+response = "zero_ip"
+files = ["etc/blocklist/*.txt"]
+#urls = [
+ #   "https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts",
+#]
+
+[log]
+level = "info"
+```
+
+### Build and Run
+
+First, build the program:
+
+```bash
+$ go get codeberg.org/miekg/dns
+$ go get modernc.org/sqlite
+$ go get github.com/BurntSushi/toml
+$ make
+```
+
+And run the program
+
+```bash
+$ ./build/linum
+```
-- 
cgit v1.2.3