aboutsummaryrefslogtreecommitdiffstats
path: root/mitmproxy/docs/features/tcpproxy.rst
diff options
context:
space:
mode:
Diffstat (limited to 'mitmproxy/docs/features/tcpproxy.rst')
-rw-r--r--mitmproxy/docs/features/tcpproxy.rst31
1 files changed, 31 insertions, 0 deletions
diff --git a/mitmproxy/docs/features/tcpproxy.rst b/mitmproxy/docs/features/tcpproxy.rst
new file mode 100644
index 00000000..fd0746a2
--- /dev/null
+++ b/mitmproxy/docs/features/tcpproxy.rst
@@ -0,0 +1,31 @@
+.. _tcpproxy:
+
+TCP Proxy
+=========
+
+WebSockets or other non-HTTP protocols are not supported by mitmproxy yet. However, 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 :option:`--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:`responsestreaming`