/twisted-socks

Adding client SOCKS support to Twisted.

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

twisted-socks -- Client SOCKS support in Twisted.


Twisted [0] doesn't seem to have support for writing a SOCKS client.
The SOCKS support is written for servers and is restricted to SOCKSv4.

This package aims to add support for client TCP connections, with or
without SSL/TLS, to go over a SOCKS proxy, version 4, 4a or 5.


See the examples directory for an idea on how to use it. You can run
the http example like this:

    cd examples; ln -s ../socksclient.py .
    ./http.py http://google.com/

You can start a SOCKSv4 proxy server in the foreground by issuing 

  twistd -n socks


Thanks to lebek for the Twisted magic needed to hook this in.
Thanks to hellais and nextime for the bugfix that sneaked into
a1c4f02c.
Thanks to Karsten Loesing for bug fixes.

This package is being maintained by linus@torproject.org. Its canonical
pickup point is http://github.com/ln5/twisted-socks . It's licensed
under a BSD license, see LICENSE for details.


twisted-socks was written mid 2011. Since then txsocksx [1] has
appeared. txsocks seems like a good alternative to twisted-socks. It
looks clean, seems to have support for SOCKS5 and does have tests.


[0] https://twistedmatrix.com/
[1] https://github.com/habnabit/txsocksx/