letstool/http2dns repository overview

⁠http2dns

Lightweight HTTP gateway that resolves DNS queries through a JSON REST API.

Send a POST /api/v1/dns request, get DNS records back as structured JSON. Supports A, AAAA, CNAME, MX, NS, PTR, SOA, TXT, SRV, NAPTR, and ANY record types, with automatic UDP → TCP fallback for large responses.

The binary embeds a web UI (dark/light mode, 15 languages) and an OpenAPI 3.1 spec — no external files, no runtime dependencies.

⁠Quick start

docker run -p 8080:8080 letstool/http2dns:latest

Open http://localhost:8080⁠ to use the web UI, or query the API directly:

curl -s -X POST http://localhost:8080/api/v1/dns \
  -H "Content-Type: application/json" \
  -d '{"class":"IN","type":"A","record":"example.com"}' | jq 

⁠Configuration

CLI flags take priority over environment variables.

docker run -p 9090:9090 \
  -e LISTEN_ADDR=0.0.0.0:9090 \
  -e DNS_SERVERS=1.1.1.1:53,9.9.9.9:53 \
  letstool/http2dns:latest

## Repo

https://github.com/letstool/http2dns⁠

⁠License

This project is licensed under the Apache License, Version 2.0⁠.

Copyright (c) 2026 letstool.net

⁠See also