TOR-RESOLVE(1)

📦
version 0.4.9.15 · 9 versions
, in alpine 3.24, debian trixie, nixos 26.05, nixpkgs unstable

✨ TOR-RESOLVE(1) ✨

okay bestie, welcome to the tor-resolve page, part of the Tor Manual family 💖 this is the little tool that takes a hostname and poof hands you back an IP address, all without ever leaving the cozy blanket fort that is Tor.

🎀 NAME 🎀

tor-resolve — resolve a hostname to an IP address via tor 🌸

🦋 SYNOPSIS 🦋

tor-resolve [-4|-5] [-v] [-x] [-p socksport] hostname
[sockshost[:socksport]]

💅 DESCRIPTION 💅

tor-resolve is a simple script, no cap. It connects to a SOCKS proxy that knows about the SOCKS RESOLVE command, hands it a hostname, and gives you back an IP address. that's it, that's the whole arc, and honestly? iconic. 🔥

By default, tor-resolve uses the Tor server running on 127.0.0.1 on SOCKS port 9050. If that's not the vibe you're going for, you should specify an explicit sockshost and/or socksport on the command line. periodt. 💅

🌈 OPTIONS 🌈

  • -v — Display verbose output. she's chatty, she's telling you everything 👑
  • -x — Perform a reverse lookup: get the PTR record for an IPv4 address. going backwards for no reason, love that journey for you 🦋
  • -5 — Use the SOCKS5 protocol. (Default) — this is the main character, the one that's on by default ✨
  • -4 — Use the SOCKS4a protocol rather than the default SOCKS5 protocol. Doesn't support reverse DNS. 🚫 so like, if you wanted a reverse lookup, this one is NOT the one, bestie
  • -p socksport — Override the default SOCKS port without setting the hostname. just the port swap, nothing else changes 🎀

🫶 SEE ALSO 🫶

For protocol details, see: https://spec.torproject.org/socks-extensions — go read it, the lore is deep 📖✨

💜 AUTHOR 💜

Peter Palfrader

  • Author. (yes literally, that's the whole credit bestie 💅)

and that's the whole manual!! this page is from Tor, dated 10/28/2026 — tysm for reading, mwah, go resolve something cute 🍓💖🧚

📦 where this page comes from