https://github.com/ssrlive/dns-over-https
A lightweight DNS-over-HTTPS ("DOH") proxy written in Rust.
https://github.com/ssrlive/dns-over-https
dns dns-over-https dns-over-tls doh dot https tls
Last synced: 6 months ago
JSON representation
A lightweight DNS-over-HTTPS ("DOH") proxy written in Rust.
- Host: GitHub
- URL: https://github.com/ssrlive/dns-over-https
- Owner: ssrlive
- License: mit
- Created: 2024-04-26T11:02:46.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-06-01T13:18:30.000Z (over 1 year ago)
- Last Synced: 2025-03-21T03:34:44.398Z (7 months ago)
- Topics: dns, dns-over-https, dns-over-tls, doh, dot, https, tls
- Language: Rust
- Homepage:
- Size: 49.8 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# DNS-over-HTTPS
[](https://crates.io/crates/dns-over-https)
[](https://docs.rs/dns-over-https)
[](https://crates.io/crates/dns-over-https)
[](https://github.com/ssrlive/dns-over-https/blob/master/LICENSE)
A lightweight DNS-over-HTTPS ("DOH") proxy written in Rust.
DNS-over-HTTPS is a lightweight proxy that will securely forward any requests to a DNS-over-HTTPS resolver such as [Cloudflare](https://developers.cloudflare.com/1.1.1.1/dns-over-https/).
**Current version:** 0.2.0
**Supported Rust version:** 1.31
## Install
Download the latest binary for your architecture from the [releases page](https://github.com/ssrlive/dns-over-https/releases).
## Usage
```
Usage: dns-over-https [OPTIONS]
Options:
-b, --bind Listen for DNS requests on the addresses and ports [default: 127.0.0.1:53]
-u, --upstream-urls URL(s) of upstream DNS-over-HTTPS service [default: https://1.1.1.1/dns-query]
-v, --verbosity Verbosity level [default: info] [possible values: off, error, warn, info, debug, trace]
--service Windows only: Run as a service
-h, --help Print help
-V, --version Print version
```
### Running on Windows
To use DNS-over-HTTPS to encrypt your DNS requests on Windows, download and install the latest [release](https://github.com/ssrlive/dns-over-https/releases).
Or you can install it using `cargo`, assuming you have `Rust` installed:
```bash
cargo install dns-over-https
```
The binary will be installed in `C:\Users\\.cargo\bin\dns-over-https.exe`.
Open a `powershell` terminal with administrative privileges and input command `New-Service` to create a new service,
- Name: `dns-over-https`
- BinaryPathName: `C:\Users\\.cargo\bin\dns-over-https.exe -b 127.0.0.1:53 -b [::1]:53 --service`
Start the service: Input command `services` from start menu, open `Services` window, start the service `dns-over-https`.
Modify the DNS server address in the network adapter settings to `127.0.0.1`(IPv4) and `::1`(IPv6).
Done.
### Running on a Pi-Hole
To use DNS-over-HTTPS to encrypt your DNS requests on a Pi-Hole, download and install the latest [release](https://github.com/ssrlive/dns-over-https/releases):
```bash
pi@raspberrypi:~ $ wget https://github.com/ssrlive/dns-over-https/releases/latest/download/dns-over-https-arm-unknown-linux-gnueabihf.zip
pi@raspberrypi:~ $ unzip dns-over-https-arm-unknown-linux-gnueabihf.zip
pi@raspberrypi:~ $ sudo mv dns-over-https /usr/local/bin/
```
You can confirm dns-over-https is working properly by asking for the current version:
```bash
pi@raspberrypi:~ $ dns-over-https --version
dns-over-https 0.2.0
```
You can then configure dns-over-https to run as a Systemd service that listens on port 5053 and forwards requests to [Cloudflare's DNS-over-HTTPS resolvers](https://developers.cloudflare.com/1.1.1.1/dns-over-https/).
First, create a system user for dns-over-https:
```bash
pi@raspberrypi:~ $ sudo adduser --system --no-create-home dns-over-https
```
Then write out a Systemd unit file:
```bash
pi@raspberrypi:~ $ sudo tee /lib/systemd/system/dns-over-https.service <