# m13253/dns-over-https

High performance DNS over HTTPS client & server

Repository: https://github.com/m13253/dns-over-https
Canonical: https://ross.abutalabs.com/products/dns-over-https
Homepage: https://developers.google.com/speed/public-dns/docs/dns-over-https
Language: Go
License: MIT
License Family: permissive
Topics: dns-over-https, doh, dns, google-dns, ietf-doh, rfc-8484
Last push: 2026-03-17T14:06:24+00:00

## Health v2 (maintenance only)
Score: 62/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 72, release rhythm 28, longevity 100
- inputs: {"age_days": 3272, "days_push": 169, "days_rel": 523, "gap_med": 59, "n_releases_24m": 4}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2204, forks 245 (observed 2026-08-28T04:06:25.830623+00:00)

## What it is
A high-performance DNS-over-HTTPS (DoH) client and server written in Go, supporting both the Google DoH JSON API and IETF RFC 8484 wire format. It can be run as a local DNS resolver forwarding queries over HTTPS or self-hosted as a DoH server.

## Use cases
- encrypt dns queries over https
- run my own dns-over-https server
- bypass dns blocking and censorship
- forward local dns to google or cloudflare over https
- set up a doh server with docker
- resolve dns via rfc 8484

## When to choose
- you need both a DoH client and a self-hosted DoH server in one tool
- you want a lightweight, high-performance Go implementation deployable via systemd or Docker
- you need support for both Google JSON API and RFC 8484 wire format

## When to avoid
- you only need a DoH client and your OS or browser already supports DoH natively
- you need DNS-over-TLS (DoT) or other encrypted DNS transports
- you want a managed DNS service rather than self-hosted software

## Facets
- artifact type: application
- maturity: active
- function: networking, security, proxy, http-server, http-client
- domain: networking, security, privacy, self-hosted
- platform: windows, cross-platform, go, self-hosted
- tags: dns-over-https, doh, rfc-8484, dns-client, dns-server, censorship-circumvention, linux, macos, docker

## Member repositories
- m13253/dns-over-https (main) score 62

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:25.830623+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:46:43.771695+00:00, confidence not recorded.
  - readme: https://github.com/m13253/dns-over-https (fetched 2026-08-28T04:06:25.830623+00:00, sha f3257fdda24d)
  - homepage: https://developers.google.com/speed/public-dns/docs/dns-over-https (fetched 2026-08-29T10:26:55.475511+00:00, sha 2c80b968abb2)
- Data as of 2026-08-30T08:39:29.467469+00:00.