2019-07-04 08:40:10 +00:00
|
|
|
|
# Unbound
|
|
|
|
|
|
|
|
|
|
[![Travis Build Status](https://travis-ci.org/NLnetLabs/unbound.svg?branch=master)](https://travis-ci.org/NLnetLabs/unbound)
|
|
|
|
|
[![Packaging status](https://repology.org/badge/tiny-repos/unbound.svg)](https://repology.org/project/unbound/versions)
|
2019-12-31 15:50:41 +00:00
|
|
|
|
[![Fuzzing Status](https://oss-fuzz-build-logs.storage.googleapis.com/badges/unbound.svg)](https://bugs.chromium.org/p/oss-fuzz/issues/list?sort=-opened&can=1&q=proj:unbound)
|
2021-08-17 09:32:56 +00:00
|
|
|
|
[![Documentation Status](https://readthedocs.org/projects/unbound/badge/?version=latest)](https://unbound.readthedocs.io/en/latest/?badge=latest)
|
2023-01-15 05:39:31 +00:00
|
|
|
|
[![Mastodon Follow](https://img.shields.io/mastodon/follow/109262826617293067?domain=https%3A%2F%2Ffosstodon.org&style=social)](https://fosstodon.org/@nlnetlabs)
|
2019-07-04 08:40:10 +00:00
|
|
|
|
|
|
|
|
|
Unbound is a validating, recursive, caching DNS resolver. It is designed to be
|
|
|
|
|
fast and lean and incorporates modern features based on open standards. If you
|
|
|
|
|
have any feedback, we would love to hear from you. Don’t hesitate to
|
|
|
|
|
[create an issue on Github](https://github.com/NLnetLabs/unbound/issues/new)
|
2020-05-21 21:00:46 +00:00
|
|
|
|
or post a message on the [Unbound mailing list](https://lists.nlnetlabs.nl/mailman/listinfo/unbound-users).
|
2020-10-27 23:03:15 +00:00
|
|
|
|
You can learn more about Unbound by reading our
|
2022-02-18 00:05:15 +00:00
|
|
|
|
[documentation](https://unbound.docs.nlnetlabs.nl/).
|
2019-07-04 08:40:10 +00:00
|
|
|
|
|
|
|
|
|
## Compiling
|
|
|
|
|
|
|
|
|
|
Make sure you have the C toolchain, OpenSSL and its include files, and libexpat
|
|
|
|
|
installed. Unbound can be compiled and installed using:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
./configure && make && make install
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
You can use libevent if you want. libevent is useful when using many (10000)
|
|
|
|
|
outgoing ports. By default max 256 ports are opened at the same time and the
|
|
|
|
|
builtin alternative is equally capable and a little faster.
|
|
|
|
|
|
|
|
|
|
Use the `--with-libevent=dir` configure option to compile Unbound with libevent
|
|
|
|
|
support.
|
|
|
|
|
|
|
|
|
|
## Unbound configuration
|
|
|
|
|
|
|
|
|
|
All of Unbound's configuration options are described in the man pages, which
|
|
|
|
|
will be installed and are available on the Unbound
|
2022-02-18 00:05:15 +00:00
|
|
|
|
[documentation page](https://unbound.docs.nlnetlabs.nl/).
|
2019-07-04 08:40:10 +00:00
|
|
|
|
|
|
|
|
|
An example configuration file is located in
|
|
|
|
|
[doc/example.conf](https://github.com/NLnetLabs/unbound/blob/master/doc/example.conf.in).
|