godns/README.MD

113 lines
1.6 KiB
Markdown

GODNS
====
A simple and fast dns cache server written by go.
Similar as [dnsmasq](http://www.thekelleys.org.uk/dnsmasq/doc.html) ,but support some difference features:
* Keep hosts records in redis instead of the local file /etc/hosts
* Atuo-Reload when hosts configuration changed. (Yes,dnsmasq need restart)
* Cache records save in memory or redis configurable
## Install & Running
1. Install
$ go get github.com/kenshinx/godns
2. Build
$ cd $GOPATH/src/github.com/kenshinx/godns
$ go build -o godns *.go
3. Running
$ sudo ./godns -c godns.conf
4. Use
$ sudo vi /etc/resolv.conf
nameserver 127.0.0.1
## Configuration
All the configuration on `godns.conf` a TOML formating config file.
More about Toml :[https://github.com/mojombo/toml](https://github.com/mojombo/toml)
#### resolv.conf
Upstream server can be configuration by change file from somewhere other that "/etc/resolv.conf"
```
[resolv]
resolv-file = "/etc/resolv.conf"
```
If multi `namerserver` set at resolv.conf, the upsteam server will try in order of up to botton
#### hosts
#### cache
Only the local memory storage backend implemented now. The redis backend is in todo list
```
[cache]
backend = "memory"
expire = 600 # default expire time 10 minutes
maxcount = 100000
```
## Benchmak
```
$ go test -bench=.
testing: warning: no tests to run
PASS
BenchmarkDig-4 5000 435141 ns/op
ok _/Users/kenshin/workspace/godns 2.270s
```
The result : 2200 queries/per second
The enviroment of test:
MacBook Air
* CPU:
Inter Core i5 1.7G
Double cores
* MEM:
8G
## TODO
* The redis cache backend
* Update ttl