Awesome Open Source
Awesome Open Source

doh.go

License GoDoc Build Status Go Report Card Code Cover

doh-go is a DNS over HTTPS (DoH) Golang client implementation.

Overview

DNS over HTTPS (DoH) is a protocol for performing remote Domain Name System (DNS) resolution via the HTTPS protocol. Specification is RFC 8484 - DNS Queries over HTTPS (DoH).

This module provides a easy way to using DoH as client in golang.

Features

  • DoH client, Simple and Easy to use
  • Support cloudflare, google, quad9 and dnspod
  • Specify the provider you like
  • Auto select fastest provider
  • Enable cache is supported
  • EDNS0-Client-Subnet query supported

Installation

go get -u github.com/likexian/doh-go

Importing

import (
    "github.com/likexian/doh-go"
    "github.com/likexian/doh-go/dns"
)

Documentation

Visit the docs on GoDoc

Example

Select fastest provider and query (Highly Recommend)

// init a context
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
defer cancel()

// init doh client, auto select the fastest provider base on your like
// you can also use as: c := doh.Use(), it will select from all providers
c := doh.Use(doh.CloudflareProvider, doh.GoogleProvider)

// do doh query
rsp, err := c.Query(ctx, "likexian.com", dns.TypeA)
if err != nil {
    panic(err)
}

// close the client
c.Close()

// doh dns answer
answer := rsp.Answer

// print all answer
for _, a := range answer {
    fmt.Printf("%s -> %s\n", a.Name, a.Data)
}

Specify DoH provider and query (You are Welcome)

// init a context
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
defer cancel()

// init doh client, specify one provider
c := doh.New(Quad9Provider)

// do doh query
rsp, err := c.Query(ctx, "likexian.com", dns.TypeMX)
if err != nil {
    panic(err)
}

// doh dns answer
answer := rsp.Answer

// print all answer
for _, a := range answer {
    fmt.Printf("%s -> %s\n", a.Name, a.Data)
}

Providers

Quad9 (Recommend)

Quad9 is a free, recursive, anycast DNS platform that provides end users robust security protections, high-performance, and privacy.

Cloudflare (Fast)

Cloudflare's mission is to help build a better Internet. We're excited today to take another step toward that mission with the launch of 1.1.1.1 — the Internet's fastest, privacy-first consumer DNS service.

Google (NOT work in Mainland China)

Google Public DNS is a recursive DNS resolver, similar to other publicly available services. We think it provides many benefits, including improved security, fast performance, and more valid results. But it is not work in mainland China.

DNSPod (Fake DoH)

DNS over HTTP but NOT HTTPS and A record only. This is something known as HTTPDNS, provided by DNSPod (Tencent Cloud). The backend is a anycast public DNS platform well known in China.

LICENSE

Copyright 2019 Li Kexian

Licensed under the Apache License 2.0

About

DONATE

Alternatives To Doh Go
Select To Compare


Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Golang (158,174
Go (158,174
Provider (15,583
Dns (10,193
Https (5,494
Cloudflare (2,481
China (2,091
Dns Over Https (151
Doh (94
Httpdns (12