README
¶
DnsForwarder
A dns server, cacher, and forwarder.
- Resolve with multiple upstreams
- Caching the record from upstreams
- Support local hosts files
- White list support
Getting started
Installation
Build from source
Make sure you have a correctly configured Go installtion first, then:
$ make bootstrap
$ go build
Install with package
Download packages from github releases page.
Configuration
forcetcp: If set it to true, server will use TCP connection with upstreams even the request from client is UDP request.
cache:
enable: Enable or disable in-memory cachettl: Default TTL for cache
loggers:
console:enable: Enable or disable console loggerlevel: Log level for console logger
file:enable: Enable or disable file loggerlevel: Log level for file loggerpath: Log file path
timeout:
server:read: Timeout for read from clientswrite: Timeout for write to clients
forwarder:read: Timeout for read from upstreamswrite: Timeout for write to upstreams
host:
enable: Resolve with hosts filesresolvs: Hosts files list
upstreams: List of upstream dns servers
Running
Build from source
$ sudo dnsforwarder
Install from package
$ service dnsforwarder start # upstart
$ systemctl start dnsforwarder #systemd
Testing
$ dig domain.tld @your.server.ip
TODO
- Cache persistence
Packaging- Hot-reload
Documentation
¶
Overview ¶
Dns Forwader, a dns server, cacher, and forwarder.
Usage:
sudo dnsforwader [options] Use sudo command to gain the root privileges for dns default port 53.
Options:
-c Configuration file path (default: ./dnsforwarder.yml) -h Server host (default: 127.0.0.1) -p Server port (default: 53) -d Enable debug mode (default:false)
Source Files
Click to show internal directories.
Click to hide internal directories.