dns-prefetch, a feature intended to reduce the perceived latency of websites by doing DNS lookups in the background for specified domains. DNS traffic does not appear in the browser’s debugging tools, is not blocked by a page’s Content Security Policy (CSP), and is often not inspected by corporate firewalls or proxies, making it an ideal medium for smuggling data in constrained scenarios.
It’s an old technique—DNS tunneling itself dates back to the ’90s, and Patrick Vananti wrote about using
dns-prefetchfor it in 2016, but as far as I can tell, browsertunnel is the first open source, production-ready client/server demonstrating its use. Because
dns-prefetchby default, and in those cases, browsertunnel will silently fail.
The project comes in two parts:
- A server, written in golang, functions as an authoritative DNS server which collects and decodes messages sent by browsertunnel.
html/folder, encodes and sends messages from the client side.
How it works
Browsertunnel can send arbitrary strings over DNS by encoding the string in a subdomain, which is forwarded to the browsertunnel server when the browser attempts to recursively resolve the domain.
Longer messages that cannot fit in one domain (253 bytes) are automatically split into multiple queries, which are reassembled and decoded by the server.
Setup and usage
First, set up DNS records to delegate a subdomain to your server. For example, if your server’s IP is
192.0.2.123 and you want to tunnel through the subdomain
t1.example.com, then your DNS configuration will look like this:
t1 IN NS t1ns.example.com.
t1ns IN A 192.0.2.123
On your server, install browsertunnel using
go get. Alternatively, compile browsertunnel on your own machine, and copy the binary to your server.
go get github.com/veggiedefender/browsertunnel
browsertunnel, specifying the subdomain you want to tunnel through.
For full usage, run
$ browsertunnel -help
Usage of browsertunnel:
seconds in between checks for expired messages (default 5)
seconds an incomplete message is retained before it is deleted (default 60)
maximum encoded size (in bytes) of a message (default 5000)
port to run on (default 53)
For more detailed descriptions and rationale for these parameters, you may also consult the godoc.
Finally, test out your tunnel! You can use my demo page here or clone this repo and load
html/index.html locally. If everything works, you should be able to see messages logged to stdout.
For real-world applications of this project, you may want to fork and tweak the code as you see fit. Some inspiration:
You may be interested in...
- Write messages to a database instead of printing them to stdout
- Transpile or rewrite the client code to work with older browsers
- Make the ID portion of the domain larger or smaller, depending on the amount of traffic you get, and ID collisions you expect
- Authenticate and encrypt messages for secrecy and tamper-resistance (remember that DNS is a plaintext protocol)
If you like the site, please consider joining the telegram channel or supporting us on Patreon using the button below.