Changes between Initial Version and Version 1 of doc/TorifyHOWTO/socat


Ignore:
Timestamp:
Jul 13, 2018, 7:00:13 PM (12 months ago)
Author:
Jaruga
Comment:

created

Legend:

Unmodified
Added
Removed
Modified
  • doc/TorifyHOWTO/socat

    v1 v1  
     1[[TOC(depth=5)]]
     2
     3= Torifying Socat =
     4
     5Socat is a command line based utility that establishes two bidirectional data streams and transfers between them. This data can take many forms such as files, pipes, devices (terminal or modems), or sockets (UNIX, IPv4, IPv6, TCP, SSL etc). The streams can be constructed from a large and diverse selection of data sinks, sources and address options, which allows Socat to be highly flexible in its usage. Socat can be used for many different purposes. It is for this reason that it and similar tools are often referred to as '''multipurpose relays'''.
     6
     7== Using Socat with Tor ==
     8
     9Below is an example of utilising Socat to relay traffic from a remote server. While the example shows how to connect to an {{{.onion}}} service, these steps work the exact same way for clear-net facing servers and connections.
     10
     11Suppose you would like to connect to an IRC network called {{{examplename.onion}}}.
     12
     13To use pipe Socat via Tor for this connection, simply use the command:
     14{{{
     15    socat TCP4-LISTEN:4242,fork SOCKS4A:localhost:examplename.onion:6667,socksport=9050
     16}}}
     17
     18=== How it works ===
     19
     20This command informs Socat to build a connection between your local system on port 4242 and examplename.onion on port 6667 via the Tor network.
     21
     22'''Note:''' If you are using Tor browser for your connection you will need to use port {{{9150}}}.
     23
     24== See also ==
     25 * [https://developers.cloudflare.com/1.1.1.1/fun-stuff/dns-over-tor/ Cloudflare - Using DNS over Tor with Socat]
     26 * [https://linux.die.net/man/1/socat Linux Manpage - Socat]