🐶 Command-line DNS client for humans
+
+ doggo.mrkaran.dev
---
-**doggo** is a modern command-line DNS client (like _dig_) written in Golang. It outputs information in a neat concise manner and supports protocols like DoH, DoT as well.
+**doggo** is a modern command-line DNS client (like _dig_) written in Golang. It outputs information in a neat concise manner and supports protocols like DoH, DoT, DoQ, and DNSCrypt as well.
It's totally inspired from [dog](https://github.com/ogham/dog/) which is written in Rust. I wanted to add some features to it but since I don't know Rust, I found it as a nice opportunity
to experiment with writing a DNS Client from scratch in `Go` myself. Hence the name `dog` +`go` => **doggo**.
@@ -22,23 +24,28 @@ to experiment with writing a DNS Client from scratch in `Go` myself. Hence the n
- Has support for multiple transport protocols:
- DNS over **HTTPS** (DoH)
- DNS over **TLS** (DoT)
+ - DNS over **QUIC** (DoQ)
- DNS over **TCP**
- DNS over **UDP**
+ - DNS over **DNSCrypt**
- Supports **ndots** and **search** configurations from `resolv.conf` or command-line arguments.
- Supports multiple resolvers at once.
- Supports IPv4 **and** IPv6 _both_.
+- Available as a web tool as well: [https://doggo.mrkaran.dev](https://doggo.mrkaran.dev).
+- Shell completions for `zsh` and `fish`.
+- Reverse DNS Lookups.
## Installation
### Binary
-You can grab the latest binaries for Linux, MacOS and Windows from the [Releases](https://github.com/mr-karan/doggo/releases) section.
+You can grab the latest binaries for Linux, MacOS and Windows from the [Releases](https://git.zio.sh/astra/doggo/releases) section.
-For eg, to pull the latest Linux binary:
+For eg, to pull the latest `linux-amd64` binary:
```shell
$ cd "$(mktemp -d)"
-$ curl -sL "https://github.com/mr-karan/doggo/releases/download/v0.2.0/doggo_0.2.0_linux_amd64.tar.gz" | tar xz
+$ curl -sL "https://git.zio.sh/astra/doggo/releases/download/v0.3.7/doggo_0.3.7_linux_amd64.tar.gz" | tar xz
$ mv doggo /usr/local/bin
# doggo should be available now in your $PATH
$ doggo
@@ -58,24 +65,36 @@ You can supply all arguments to the CLI directly to `docker run` command. Eg:
`docker run ghcr.io/mr-karan/doggo:latest mrkaran.dev @1.1.1.1 MX`
-### Using snap
+### Package Managers
-[](https://snapcraft.io/doggo)
+#### Homebrew
-```sh
-$ sudo snap install doggo
+Install via [Homebrew](https://brew.sh/)
+
+```bash
+$ brew install doggo
```
-**NOTE**: Since the [confinement](https://snapcraft.io/docs/snap-confinement) mode is strict as of now, it cannot access your host's `/etc/resolv.conf`.
-I'll be making a request in the Snap forums soon so that it can be manually reviewed and allowed to use `--classic`. Until then, please specify a nameserver manually
-if using `snap`.
+#### Arch
+
+```bash
+yay -S doggo-bin
+```
+
+#### Scoop
+
+Install via [Scoop](https://scoop.sh/)
+
+```bash
+scoop install doggo
+```
### From Source
You need to have `go` installed in your system.
```bash
-$ go get github.com/mr-karan/doggo/cmd/doggo
+$ go install git.zio.sh/astra/doggo/cmd/doggo@latest
```
The binary will be available at `$GOPATH/bin/doggo`.
@@ -190,6 +209,10 @@ URL scheme of the server is used to identify which resolver to use for lookups.
@tcp:// eg: @1.1.1.1 initiates a TCP resolver for 1.1.1.1:53.
@https:// eg: @https://cloudflare-dns.com/dns-query initiates a DOH resolver for Cloudflare DoH server.
@tls:// eg: @1.1.1.1 initiates a DoT resolver for 1.1.1.1:853.
+ @sdns:// eg: @sdns://AgcAAAAAAAAABzEuMC4wLjEAEmRucy5jbG91ZGZsYXJlLmNvbQovZG5zLXF1ZXJ5
+ initiates a DNSCrypt or DoH resolver using its DNS stamp.
+ @quic:// eg: @quic://dns.adguard.com
+ initiates a DNS over QUIC resolver for Adguard DNS Resolver.
```
### Query Options
@@ -204,11 +227,14 @@ URL scheme of the server is used to identify which resolver to use for lookups.
### Resolver Options
```
- --ndots=INT Specify ndots parameter. Takes value from /etc/resolv.conf if using the system nameserver or 1 otherwise.
- --search Use the search list defined in resolv.conf. Defaults to true. Set --search=false to disable search list.
- --timeout Specify timeout (in seconds) for the resolver to return a response.
- -4 --ipv4 Use IPv4 only.
- -6 --ipv6 Use IPv6 only.
+ --strategy=STRATEGY Specify strategy to query nameserver listed in etc/resolv.conf. Defaults to `all` (`random`, `first`, `all`).
+ --ndots=INT Specify ndots parameter. Takes value from /etc/resolv.conf if using the system nameserver or 1 otherwise.
+ --search Use the search list defined in resolv.conf. Defaults to true. Set --search=false to disable search list.
+ --timeout Specify timeout (in seconds) for the resolver to return a response.
+ -4 --ipv4 Use IPv4 only.
+ -6 --ipv6 Use IPv6 only.
+ --tls-hostname=HOSTNAME Provide a hostname for doing verification of the certificate if the provided DoT nameserver is an IP.
+ --skip-hostname-verification Skip TLS Hostname Verification in case of DOT Lookups.
```
@@ -219,6 +245,7 @@ URL scheme of the server is used to identify which resolver to use for lookups.
--color Defaults to true. Set --color=false to disable colored output.
--debug Enable debug logging.
--time Shows how long the response took from the server.
+ --short Short output format. Shows only the response section.
```
---
@@ -231,4 +258,4 @@ For now I am focussing more on [planned features](TODO.md) for a **stable** v1.0
## License
-[LICENSE](LICENSE)
+[LICENSE](./LICENSE)
diff --git a/TODO.md b/TODO.md
index 30effea..30cca2f 100644
--- a/TODO.md
+++ b/TODO.md
@@ -54,14 +54,16 @@
# Future Release
- [ ] Support obscure protocol tweaks in `dig`
-- [ ] Read from file with `-f`
- [x] Support more DNS Record Types
-- [ ] Shell completions
- - [ ] bash
- - [ ] zsh
- - [ ] fish
+- [x] Shell completions
+ - [x] zsh
+ - [x] fish
- [ ] Add tests for Resolvers.
- [ ] Add tests for CLI Output.
- [ ] Homebrew - Goreleaser
+- [ ] Add support for `dig +trace` like functionality.
+- [ ] Add `dig +short` short output
+- [x] Add `--strategy` for picking nameservers.
+- [ ] Explore `dig.rc` kinda file
- [x] Separate Authority/Answer in JSON output.
- [x] Error on NXDomain (Related upstream [bug](https://github.com/miekg/dns/issues/1198))
diff --git a/cmd/doggo/api/api.go b/cmd/api/api.go
similarity index 95%
rename from cmd/doggo/api/api.go
rename to cmd/api/api.go
index 43b42d9..c467f9c 100644
--- a/cmd/doggo/api/api.go
+++ b/cmd/api/api.go
@@ -6,8 +6,8 @@ import (
"net/http"
"time"
- "github.com/mr-karan/doggo/internal/app"
- "github.com/mr-karan/doggo/pkg/utils"
+ "git.zio.sh/astra/doggo/internal/app"
+ "git.zio.sh/astra/doggo/pkg/utils"
"github.com/sirupsen/logrus"
"github.com/go-chi/chi"
diff --git a/cmd/api/assets/dark.css b/cmd/api/assets/dark.css
new file mode 100644
index 0000000..4e4777d
--- /dev/null
+++ b/cmd/api/assets/dark.css
@@ -0,0 +1,48 @@
+:root {
+ --primary: #58a6ff;
+ --background: #0d1117;
+}
+
+body {
+ background-color: var(--background);
+ color: #c9d1d9;
+}
+
+.box {
+ border: 1px solid #30363d;
+ box-shadow: unset;
+}
+
+.help a {
+ text-decoration: none;
+}
+
+a:hover {
+ color: var(--primary);
+ text-decoration: underline;
+}
+
+input, select, button {
+ background-color: #010409;
+ border: 1px solid #30363d;
+ color: #ffffff;
+}
+
+button {
+ color: #c9d1d9;
+ background-color: #21262d;
+ box-shadow: 0 0 transparent, 0 0 transparent;
+}
+
+button:hover,
+button:focus {
+ background-color: #30363d;
+ border-color: #8b949e;
+ transition-duration: .1s;
+}
+
+table th {
+ background: #161b22;
+ border-bottom: unset;
+ color: #c9d1d9;
+}
\ No newline at end of file
diff --git a/cmd/api/assets/main.js b/cmd/api/assets/main.js
new file mode 100644
index 0000000..dc405a2
--- /dev/null
+++ b/cmd/api/assets/main.js
@@ -0,0 +1,90 @@
+const $ = document.querySelector.bind(document);
+const $new = document.createElement.bind(document);
+const $show = (el) => {
+ el.classList.remove('hidden');
+};
+const $hide = (el) => {
+ el.classList.add('hidden');
+};
+
+const apiURL = '/api/lookup/';
+
+(function () {
+ const fields = ['name', 'address', 'type', 'ttl', 'rtt'];
+
+ // createRow creates a table row with the given cell values.
+ function createRow(item) {
+ const tr = $new('tr');
+ fields.forEach((f) => {
+ const td = $new('td');
+ td.innerText = item[f];
+ td.classList.add(f);
+ tr.appendChild(td);
+ });
+ return tr;
+ }
+
+ const handleSubmit = async () => {
+ const tbody = $('#table tbody'),
+ tbl = $('#table');
+ tbody.innerHTML = '';
+ $hide(tbl);
+
+ const q = $('input[name=q]').value.trim(),
+ typ = $('select[name=type]').value,
+ addr = $('input[name=address]').value.trim();
+
+ // Post to the API.
+ const req = await fetch(apiURL, {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({ query: [q,], type: [typ,], nameservers: [addr,] })
+ });
+
+ const res = await req.json();
+
+ if (res.status != 'success') {
+ const error = (res && res.message) || response.statusText;
+ throw(error);
+ return;
+ }
+
+ if (res.data[0].answers == null) {
+ throw('No records found.');
+ return;
+ }
+
+ res.data[0].answers.forEach((item) => {
+ tbody.appendChild(createRow(item));
+ });
+
+ $show(tbl);
+ };
+
+ // Capture the form submit.
+ $('#form').onsubmit = async (e) => {
+ e.preventDefault();
+
+ const msg = $('#message');
+ $hide(msg);
+
+ try {
+ await handleSubmit();
+ } catch(e) {
+ msg.innerText = e.toString();
+ $show(msg);
+ throw e;
+ }
+ };
+
+ // Change the address on ns change.
+ const ns = $("#ns"), addr = $("#address");
+ addr.value = ns.value;
+
+ ns.onchange = (e) => {
+ addr.value = e.target.value;
+ if(addr.value === "") {
+ addr.focus();
+ }
+ };
+})();
\ No newline at end of file
diff --git a/cmd/api/assets/style.css b/cmd/api/assets/style.css
new file mode 100644
index 0000000..84b2194
--- /dev/null
+++ b/cmd/api/assets/style.css
@@ -0,0 +1,201 @@
+:root {
+ --primary: #4338ca;
+ --secondary: #333;
+}
+
+* {
+ box-sizing: border-box;
+}
+
+:focus {
+ outline: 0;
+}
+
+body {
+ font-family: "Segoe UI", "Helvetica Neue", Inter, sans-serif;
+ font-size: 16px;
+ line-height: 24px;
+ color: #111;
+ margin: 0 auto;
+}
+
+h1, h2, h3, h4 {
+ line-height: 1.3em;
+}
+
+a {
+ color: var(--primary);
+}
+ a:hover {
+ color: #111;
+ text-decoration: none;
+ }
+
+input, select, button {
+ border-radius: 5px;
+ border: 1px solid #ddd;
+ font-size: 1.3rem;
+ padding: 10px 15px;
+ width: 100%;
+}
+ input:focus, select:focus {
+ border-color: var(--primary);
+ }
+ button {
+ border-color: var(--primary);
+ background: var(--primary);
+ color: #fff;
+ cursor: pointer;
+ width: auto;
+ padding: 10px 30px;
+ }
+ button:focus,
+ button:hover {
+ border-color: var(--secondary);
+ background: var(--secondary);
+ }
+
+label {
+ display: block;
+ padding-bottom: 0.5rem;
+}
+
+.box {
+ box-shadow: 1px 1px 4px #eee;
+ border: 1px solid #eee;
+ padding: 30px;
+ border-radius: 3px;
+}
+
+.hidden {
+ display: none !important;
+}
+
+.main {
+ margin: 60px auto 30px auto;
+ max-width: 900px;
+}
+
+header {
+ text-align: center;
+ font-size: 1.5em;
+ margin-bottom: 60px;
+}
+ .logo span {
+ color: var(--primary);
+ font-weight: 900;
+ }
+
+form {
+ margin-bottom: 45px;
+}
+
+ .row {
+ display: flex;
+ margin-bottom: 15px;
+ }
+ .row .field {
+ flex: 50%;
+ }
+ .row .field:last-child {
+ margin-left: 30px;
+ }
+
+ .submit {
+ text-align: right;
+ }
+ .help {
+ color: #666;
+ font-size: 0.875em;
+ }
+
+#message {
+ color: #ff3300;
+}
+
+table.box {
+ width: 100%;
+ max-width: 100%;
+ padding: 0;
+}
+ table th {
+ background: #f9fafb;
+ color: #666;
+ font-size: 0.875em;
+ border-bottom: 1px solid #ddd;
+ }
+ table th, tbody td {
+ padding: 10px 15px;
+ text-align: left;
+ }
+ td.name {
+ font-weight: bold;
+ }
+ th.type, td.type {
+ text-align: center;
+ }
+ td.type {
+ background: #d1fae5;
+ color: #065f46;
+ font-weight: bold;
+ }
+
+footer {
+ margin: 60px 0 0 0;
+ text-align: center;
+}
+ footer a {
+ text-decoration: none;
+ }
+
+
+@media (max-width: 650px) {
+ .main {
+ margin: 60px 30px 30px 30px;
+ }
+ .box {
+ box-shadow: none;
+ border: 0;
+ padding: 0;
+ }
+
+ .row {
+ display: block;
+ }
+ .field {
+ margin: 0 0 20px 0;
+ }
+ .row .field:last-child {
+ margin: 0;
+ }
+ .submit button {
+ width: 100%;
+ }
+
+ table {
+ table-layout: fixed;
+ }
+ table th {
+ width: 100%;
+ }
+ table tr {
+ border-bottom: 0;
+ display: flex;
+ flex-direction: row;
+ flex-wrap: wrap;
+ margin-bottom: 30px;
+ }
+ table td {
+ border: 1px solid #eee;
+ margin: 0 -1px -1px 0;
+ position: relative;
+ width: 100%;
+ word-wrap:break-word;
+ }
+ table th.type, table td.type {
+ text-align: left;
+ }
+ table td span {
+ display: block;
+ }
+}
\ No newline at end of file
diff --git a/cmd/doggo/api/config.go b/cmd/api/config.go
similarity index 100%
rename from cmd/doggo/api/config.go
rename to cmd/api/config.go
diff --git a/cmd/doggo/api/handlers.go b/cmd/api/handlers.go
similarity index 96%
rename from cmd/doggo/api/handlers.go
rename to cmd/api/handlers.go
index 5adff0b..388ff92 100644
--- a/cmd/doggo/api/handlers.go
+++ b/cmd/api/handlers.go
@@ -8,9 +8,9 @@ import (
"net/http"
"time"
- "github.com/mr-karan/doggo/internal/app"
- "github.com/mr-karan/doggo/pkg/models"
- "github.com/mr-karan/doggo/pkg/resolvers"
+ "git.zio.sh/astra/doggo/internal/app"
+ "git.zio.sh/astra/doggo/pkg/models"
+ "git.zio.sh/astra/doggo/pkg/resolvers"
)
type httpResp struct {
diff --git a/cmd/api/index.html b/cmd/api/index.html
new file mode 100644
index 0000000..c5de849
--- /dev/null
+++ b/cmd/api/index.html
@@ -0,0 +1,101 @@
+
+
+
+ ' + error + '
' - throw (error); - } - - if (res.data[0].answers == null) { - const errSec = $('div[id=api-error-sec]'); - errSec.classList.remove("hidden"); - errSec.innerHTML = '' + 'No records found!' + '
' - return null; - } - - $('div[id=answer_sec]').classList.remove("hidden"); - - if (isMobile === true) { - list.classList.remove("hidden"); - res.data[0].answers.forEach((item) => { - console.log("appending", item) - list.appendChild(createList(item)); - }); - - } else { - res.data[0].answers.forEach((item) => { - tbl.appendChild(createRow(item)); - }); - } - - }; - - document.querySelector('form').addEventListener('submit', handleSubmit); -})(); \ No newline at end of file diff --git a/cmd/doggo/api/assets/tailwind.css b/cmd/doggo/api/assets/tailwind.css deleted file mode 100644 index f7ca494..0000000 --- a/cmd/doggo/api/assets/tailwind.css +++ /dev/null @@ -1,1048 +0,0 @@ -/*! tailwindcss v2.0.3 | MIT License | https://tailwindcss.com */ - -/*! modern-normalize v1.0.0 | MIT License | https://github.com/sindresorhus/modern-normalize */ - -/* -Document -======== -*/ - -/** -Use a better box model (opinionated). -*/ - -*, -*::before, -*::after { - box-sizing: border-box; -} - -/** -Use a more readable tab size (opinionated). -*/ - -:root { - -moz-tab-size: 4; - -o-tab-size: 4; - tab-size: 4; -} - -/** -1. Correct the line height in all browsers. -2. Prevent adjustments of font size after orientation changes in iOS. -*/ - -html { - line-height: 1.15; /* 1 */ - -webkit-text-size-adjust: 100%; /* 2 */ -} - -/* -Sections -======== -*/ - -/** -Remove the margin in all browsers. -*/ - -body { - margin: 0; -} - -/** -Improve consistency of default fonts in all browsers. (https://github.com/sindresorhus/modern-normalize/issues/3) -*/ - -body { - font-family: - system-ui, - -apple-system, /* Firefox supports this but not yet `system-ui` */ - 'Segoe UI', - Roboto, - Helvetica, - Arial, - sans-serif, - 'Apple Color Emoji', - 'Segoe UI Emoji'; -} - -/* -Grouping content -================ -*/ - -/** -1. Add the correct height in Firefox. -2. Correct the inheritance of border color in Firefox. (https://bugzilla.mozilla.org/show_bug.cgi?id=190655) -*/ - -hr { - height: 0; /* 1 */ - color: inherit; /* 2 */ -} - -/* -Text-level semantics -==================== -*/ - -/** -Add the correct text decoration in Chrome, Edge, and Safari. -*/ - -abbr[title] { - -webkit-text-decoration: underline dotted; - text-decoration: underline dotted; -} - -/** -Add the correct font weight in Edge and Safari. -*/ - -b, -strong { - font-weight: bolder; -} - -/** -1. Improve consistency of default fonts in all browsers. (https://github.com/sindresorhus/modern-normalize/issues/3) -2. Correct the odd 'em' font sizing in all browsers. -*/ - -code, -kbd, -samp, -pre { - font-family: - ui-monospace, - SFMono-Regular, - Consolas, - 'Liberation Mono', - Menlo, - monospace; /* 1 */ - font-size: 1em; /* 2 */ -} - -/** -Add the correct font size in all browsers. -*/ - -small { - font-size: 80%; -} - -/** -Prevent 'sub' and 'sup' elements from affecting the line height in all browsers. -*/ - -sub, -sup { - font-size: 75%; - line-height: 0; - position: relative; - vertical-align: baseline; -} - -sub { - bottom: -0.25em; -} - -sup { - top: -0.5em; -} - -/* -Tabular data -============ -*/ - -/** -1. Remove text indentation from table contents in Chrome and Safari. (https://bugs.chromium.org/p/chromium/issues/detail?id=999088, https://bugs.webkit.org/show_bug.cgi?id=201297) -2. Correct table border color inheritance in all Chrome and Safari. (https://bugs.chromium.org/p/chromium/issues/detail?id=935729, https://bugs.webkit.org/show_bug.cgi?id=195016) -*/ - -table { - text-indent: 0; /* 1 */ - border-color: inherit; /* 2 */ -} - -/* -Forms -===== -*/ - -/** -1. Change the font styles in all browsers. -2. Remove the margin in Firefox and Safari. -*/ - -button, -input, -optgroup, -select, -textarea { - font-family: inherit; /* 1 */ - font-size: 100%; /* 1 */ - line-height: 1.15; /* 1 */ - margin: 0; /* 2 */ -} - -/** -Remove the inheritance of text transform in Edge and Firefox. -1. Remove the inheritance of text transform in Firefox. -*/ - -button, -select { /* 1 */ - text-transform: none; -} - -/** -Correct the inability to style clickable types in iOS and Safari. -*/ - -button, -[type='button'], -[type='submit'] { - -webkit-appearance: button; -} - -/** -Remove the inner border and padding in Firefox. -*/ - -/** -Restore the focus styles unset by the previous rule. -*/ - -/** -Remove the additional ':invalid' styles in Firefox. -See: https://github.com/mozilla/gecko-dev/blob/2f9eacd9d3d995c937b4251a5557d95d494c9be1/layout/style/res/forms.css#L728-L737 -*/ - -/** -Remove the padding so developers are not caught out when they zero out 'fieldset' elements in all browsers. -*/ - -legend { - padding: 0; -} - -/** -Add the correct vertical alignment in Chrome and Firefox. -*/ - -progress { - vertical-align: baseline; -} - -/** -Correct the cursor style of increment and decrement buttons in Safari. -*/ - -/** -1. Correct the odd appearance in Chrome and Safari. -2. Correct the outline style in Safari. -*/ - -/** -Remove the inner padding in Chrome and Safari on macOS. -*/ - -/** -1. Correct the inability to style clickable types in iOS and Safari. -2. Change font properties to 'inherit' in Safari. -*/ - -/* -Interactive -=========== -*/ - -/* -Add the correct display in Chrome and Safari. -*/ - -summary { - display: list-item; -} - -/** - * Manually forked from SUIT CSS Base: https://github.com/suitcss/base - * A thin layer on top of normalize.css that provides a starting point more - * suitable for web applications. - */ - -/** - * Removes the default spacing and border for appropriate elements. - */ - -blockquote, -dl, -dd, -h1, -h2, -h3, -h4, -h5, -h6, -hr, -figure, -p, -pre { - margin: 0; -} - -button { - background-color: transparent; - background-image: none; -} - -/** - * Work around a Firefox/IE bug where the transparent `button` background - * results in a loss of the default `button` focus styles. - */ - -button:focus { - outline: 1px dotted; - outline: 5px auto -webkit-focus-ring-color; -} - -fieldset { - margin: 0; - padding: 0; -} - -ol, -ul { - list-style: none; - margin: 0; - padding: 0; -} - -/** - * Tailwind custom reset styles - */ - -/** - * 1. Use the user's configured `sans` font-family (with Tailwind's default - * sans-serif font stack as a fallback) as a sane default. - * 2. Use Tailwind's default "normal" line-height so the user isn't forced - * to override it to ensure consistency even when using the default theme. - */ - -html { - font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; /* 1 */ - line-height: 1.5; /* 2 */ -} - -/** - * Inherit font-family and line-height from `html` so users can set them as - * a class directly on the `html` element. - */ - -body { - font-family: inherit; - line-height: inherit; -} - -/** - * 1. Prevent padding and border from affecting element width. - * - * We used to set this in the html element and inherit from - * the parent element for everything else. This caused issues - * in shadow-dom-enhanced elements likeOops! Found no records for this query.
-