dns2tcpd(1)
π dns2tcpd β the manual page, but make it a group chat
okay bestie, you're reading the dns2tcpd(1) page from the General Commands Manual (section 1, we love a section 1 moment π
). buckle up, this one's a tunneling baddie.
β¨ NAME β¨
dns2tcpd β a tunneling tool that encapsulates TCP traffic over DNS. fr fr that's the whole personality π¦
πΈ SYNOPSIS πΈ
dns2tcpd [ -h ] [ -F ] [ -i address ] [ -f config_file ] [ -p pidfile ]
[ -d debug_level ]
that's it. that's the whole summoning ritual π
π DESCRIPTION π
okay so dns2tcp is a network tool that encapsulates TCP communications in DNS. the vibe is: when connections show up on a specific port, all that TCP traffic gets yeeted over to the remote dns2tcpd server and then forwarded to a specific host and port. and bestie, multiple connections are supported β it's giving main character energy, not one-connection-wonder energy π₯
lowkey it was written for demonstration purposes. iconic of it honestly.
π OPTIONS π
-hβ help menu. your little emergency SOS button π«Ά-Fβ run in foreground. no hiding in the background, we're being perceived β¨-iaddress β IP address to bind (default0.0.0.0). if you don't pick one, it picks everything for you π-fconfig file β the configuration file to use. your little instruction manual π-ppidfile β the file where our pid will be written. yes, it's writing about itself, very main character π-ddebug level β change the debug level. levels available are1,2or3. three whole levels, choose your fighter π
π CONFIGURATION FILES π
by default, ${HOME}/.dns2tcprcd is used if no configuration file is specified. no cap, that's the default bestie.
the resource syntax is:
<resource-name>:<server>:<port>
you can define multiple resources in multilines, but they must be comma separated. don't skip the commas, that's the rules π
here is an example (steal it, it's cute):
listen = 127.0.0.1
port = 53
user = nobody
chroot = /tmp
pid_file = /var/run/dns2tcp.pid
domain = dns2tcp.hsc.fr
debug_level = 0
resources = ssh:127.0.0.1:22 , smtp:127.0.0.1:25,
pop3:10.0.0.1:110
β οΈ note that resources line wraps across two lines in the original and the resources are comma separated β keep it exactly like that, bestie, no reformatting π
π AUTHORS π
Olivier Dembour <olivier.dembour@hsc.fr> β the icon, the legend, the moment. we stan π
π¦ SEE ALSO π¦
ssltunnelβ go read that one too, it's in the same friend group π
okay that's the whole page, you ate that. this was the dns2tcpd(1) manual page, living in the General Commands Manual section, and that's a wrap β periodt π
β¨π
π¦ where this page comes from
- debian bookworm: dns2tcp 0.5.2-3 Β· GPL-2.0-or-later
- debian trixie: dns2tcp 0.5.2-3 Β· GPL-2.0-or-later
- nixos 26.05: dns2tcp 0.5.2
- nixpkgs unstable: dns2tcp 0.5.2
- ubuntu jammy: dns2tcp 0.5.2-3 Β· GPL-2.0-or-later
- ubuntu noble: dns2tcp 0.5.2-3 Β· GPL-2.0-or-later
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms