This repository has been archived by the owner on Apr 26, 2024. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
38 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,38 @@ | ||
# iroh-dns-server | ||
|
||
A server that functions as a [pkarr](https://github.com/Nuhvi/pkarr/) relay and | ||
[DNS](https://de.wikipedia.org/wiki/Domain_Name_System) server. | ||
|
||
This server compiles to a binary `iroh-dns-server`. It needs a config file, of | ||
which there are two examples included: | ||
|
||
- [`config.dev.toml`](./config.dev.toml) - suitable for local development | ||
- [`config.prod.toml`](./config.dev.toml) - suitable for production, after | ||
adjusting the domain names and IP addresses | ||
|
||
The server will expose the following services: | ||
|
||
- A DNS server listening on UDP and TCP for DNS queries | ||
- A HTTP and/or HTTPS server which provides the following routes: | ||
- `/pkarr`: `GET` and `PUT` for pkarr signed packets | ||
- `/dns-query`: Answer DNS queries over | ||
[DNS-over-HTTPS](https://datatracker.ietf.org/doc/html/rfc8484) | ||
|
||
All received and valid pkarr signed packets will be served over DNS. The pkarr | ||
packet origin will be appended with the origin as configured by this server. | ||
|
||
# License | ||
|
||
This project is licensed under either of | ||
|
||
- Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or | ||
http://www.apache.org/licenses/LICENSE-2.0) | ||
- MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT) | ||
|
||
at your option. | ||
|
||
### Contribution | ||
|
||
Unless you explicitly state otherwise, any contribution intentionally submitted | ||
for inclusion in this project by you, as defined in the Apache-2.0 license, | ||
shall be dual licensed as above, without any additional terms or conditions. |