Architecture
Simple proxy ...with client up- and/or downstream observer(s):
##########################################################################
# #
# (Proxy) Target # Observer 0..N
# TCP client `tcp-clone` (TCP server) # (TCP server(s))
# +------------+ +-------------+ +------------+ # +--------------+
# | | | | | | # | |--+
# | connect |----------->| accept | | | # | | |
# | #1 | | connect |------------>| accept | # | | |
# | | | |\------------------------------------------>| accept | |
# | | | | | | # | | |
# | | | | | | # | | |
# | | | | | | # | | |
# | | | | | | # | | |
# | connect |----------->| accept | | | # | | |
# | #2 | | connect |------x----->| | # | | |
# | disconnect |<----x------| disconnect | | | # | | |
# | | | | | | # | | |
# | | | | | | # | | |
# | | | | | | # | | |
# | | | | | | # | | |
# | | | | | | # | | |
# | | | | full proxy | | # | | |
# | | | | (TX and RX) | | # | | |
# | TX/RX |<---------->| TX/RX TX/RX |<----------->| TX/RX | # | | |
# | | | |\ half proxy | | # | | |
# | | | | \(TX or RX) | | # | | |
# | | | | \---------------------------------------->| RX | |
# | | | | | | # | | |
# | | | | | | # | | |
# | | | dropped |<-------------------------------------------| TX | |
# | | | | | | # | | |
# | | | | | | # | | |
# | | | | | | # | | |
# | | | | | | # | | |
# | | | | | | # | | |
# | | | | | | # | | |
# | disconnect |-----x----->| disconnect | | | # | | |
# | #1 | | disconnect |------x----->| | # | | |
# | | | |\ | | # | | |
# | | | | -------------------x---------------------->| disconnect | |
# | | | | | | # | | |
# | | | | | | # | | |
# | | | | | | # | | |
# | | | | | | # | | |
# | | | | | | # | | |
# | | | | | | # | | |
# | | | disconnect |<-----x------| disconnect | # | | |
# | disconnect |<----x------| disconnect | | #2 | # | | |
# | | | disconnect |--------------------x---------------------->| disconnect | |
# | | | | | | # | | |
# | | | | | | # | | |
# | | | | | | # | | |
# | | | | | | # | | |
# | | | | | | # | | |
# | | | disconnect |<-------------------x-----------------------| disconnect | |
# | | | | | | # | #3 | |
# +------------+ +-------------+ +------------+ # +--------------+ |
########################################################################## +----------------+
Installation
From source
With cargo installed run:
Pre-builds
Download a released version.
Usage
Configuration file
Example
[[]]
[]
= "127.0.0.1:1202"
[]
= "127.0.0.1:5000"
[[]]
= "127.0.0.1:6000"
[[]]
= "127.0.0.1:7000"
[[]]
= "127.0.0.1:8000"
# Multiple servers:
#
#[[tcp_clone]]
#
# [tcp_clone.server]
# listen_addr = "127.0.0.1:1111"
#
# [tcp_clone.target]
# addr = "127.0.0.1:3333"
#
# [[tcp_clone.client_tx_observer]]
# addr = "127.0.0.1:5555"
Demo
With iperf
With netcat