~emersion/lodns - A local DNS resolver

bc29d403 — Simon Ser 1 year, 7 months ago

Add resolv.conf example file

730d1f18 — Simon Ser 1 year, 7 months ago

readme: add setcap invocation to allow binding to port 53

852a9a9a — Simon Ser 1 year, 7 months ago

readme: add short building section

refs

master: browse log

clone

read-only: https://git.sr.ht/~emersion/lodns
read/write: git@git.sr.ht:~emersion/lodns

#lodns

A local DNS resolver. Designed to forward DNS requests to a DNS-over-TLS or DNS-over-HTTPS server.

#Usage

To listen for local connections on port 53 and forward requests to ns0.fdn.fr:

lodns ns0.fdn.fr

lodns itself will need to perform DNS queries to lookup the DoT or DoH hostname. To set the resolv.conf file to use for these lookups, the -bootstrap-resolv-conf option can be used. For instance, to use the local DNS resolver with NetworkManager:

lodns -bootstrap-resolv-conf=/run/NetworkManager/no-stub-resolv.conf ns0.fdn.fr

The system-wide /etc/resolv.conf file can be symlinked to the resolv.conf file in this repository to configure applications with lodns.

#Building

go build

To allow lodns to listen on port 53:

setcap cap_net_bind_service=+ep ./lodns

#License

AGPLv3 only, see LICENSE.