Skip to content
/ doh-go Public
forked from likexian/doh

DNS over HTTPS (DoH) Golang implementation

License

Notifications You must be signed in to change notification settings

poohvpn/doh-go

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

About

DNS over HTTPS (DoH) Golang implementation

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Languages

  • Go 100.0%