REDSOCKS(8)

📦
version 0.5 · 2 versions
  • 0.5 · debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 0.5 · fedora 43, fedora 44
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💅 REDSOCKS — the girlies' guide to proxying literally everything 💅

okay so bestie, this is the manual page for redsocks from the System Manager's Manual section, and honestly? it's giving main character energy for your whole network stack. sit down, grab a strawberry drink 🍓, and let's get into it.

✨ NAME ✨

redsocks — redirect any TCP connection to a SOCKS or HTTP proxy. any. all of them. no cap. 👑

🌸 SYNOPSIS 🌸

redsocks [options]

🦋 DESCRIPTION 🦋

so like, redsocks is a daemon (a lil background bestie) that runs on your local system and will transparently tunnel any TCP connection through a remote SOCKS4, SOCKS5 or HTTP proxy server. transparently meaning it just happens, nobody has to know, the apps don't even clock it. 💅

it does this by using your system firewall's redirection facility to intercept TCP connections. the way that works is so clever — the redirection is system-wide, with fine-grained control, and it does not depend on LD_PRELOAD libraries. (not me being obsessed with not needing LD_PRELOAD 😭 iconic behaviour fr fr.)

redsocks supports tunneling TCP connections and UDP packets. and it has authentication support for both — SOCKS and HTTP proxies. equal opportunity auth, we love to see it. 🫶

also included?? a small DNS server that returns answers with the "truncated" flag set for any UDP query, which forces the resolver to use TCP. she really said "UDP? not today, babes, we're going TCP." 🌈

🎀 OPTIONS 🎀

  • -p pidfile — write the process ID to pidfile. so you can find your daemon later. she's not ghosting you, she left a note. 💖
  • -c config — use config as the configuration file. tell her where the vibes live. ✨
  • -t — test the configuration file syntax. a little vibe check before you commit. 🔥

⭐ SEE ALSO ⭐

  • iptables(8) — the firewall bestie doing the actual redirecting 👑
  • /etc/redsocks.conf — the config file, obviously 💜
  • /usr/share/doc/redsocks/README.gz — the extended lore, go read it 🧚

🙈 AUTHOR 🙈

redsocks was written by Leonid Evdokimov <leon@darkk.net.ru>. absolute legend, no notes. 🏆

this manual page was written by Apollon Oikonomopoulos <apoikos@debian.org>, for the Debian project (and may be used by others). she ate that. 💅

quick reminder bestie: the firewall redirection happens system-wide, so this isn't a cute little per-app thing — it's the whole machine. know what you're configuring before you configure it. 😌

and that's the whole page, babes!! 🌸 this was from the System Manager's Manual, dated November 14, 2011 — vintage but still slaying ✨ — and it's the REDSOCKS(8) page, so now you know. go forth and proxy responsibly 🦋💖

📦 where this page comes from