From 3cb459d56daeae8fd2b923c27f39ca5595a50e7b Mon Sep 17 00:00:00 2001 From: Thomas Kriechbaumer Date: Thu, 17 Aug 2017 10:18:05 +0200 Subject: docs++: add individual protocol pages --- docs/protocols/tcpproxy.rst | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 docs/protocols/tcpproxy.rst (limited to 'docs/protocols/tcpproxy.rst') diff --git a/docs/protocols/tcpproxy.rst b/docs/protocols/tcpproxy.rst new file mode 100644 index 00000000..77248573 --- /dev/null +++ b/docs/protocols/tcpproxy.rst @@ -0,0 +1,31 @@ +.. _tcp_proxy: + +TCP Proxy / Fallback +==================== + +In case mitmproxy does not handle a specific protocol, you can exempt +hostnames from processing, so that mitmproxy acts as a generic TCP forwarder. +This feature is closely related to the :ref:`passthrough` functionality, +but differs in two important aspects: + +- The raw TCP messages are printed to the event log. +- SSL connections will be intercepted. + +Please note that message interception or modification are not possible yet. +If you are not interested in the raw TCP messages, you should use the ignore domains feature. + +How it works +------------ + +================== ====================== +command-line ``--tcp HOST`` +mitmproxy shortcut :kbd:`O` then :kbd:`T` +================== ====================== + +For a detailed description how the hostname pattern works, please look at the :ref:`passthrough` +feature. + +.. seealso:: + + - :ref:`passthrough` + - :ref:`streaming` -- cgit v1.2.3