tcpdam is a parking proxy for your tcp connection. When your upstream server is ready, send SIGUSR1 to flush connection to the server.
make
tcpdam -l LISTEN-HOST:LISTEN-PORT -r REMOTE-HOST:REMOTE-PORT
will setup a listening tcp server, when something connect it is parked in a waiting list
killall -USR1 tcpdam
will lookup REMOTE-HOST once, and open the dam : the parked and new connections are proxified to REMOTE-HOST.
killall -USR2 tcpdam
will re-close the dam and start to park new connections,
| Env | Command line | Description |
|---|---|---|
| TCPDAM_LISTEN_ADDRESS | -l | Listen address for incoming connections |
| TCPDAM_REMOTE_ADDRESS | -h | Remote address where the connections will be flushed |
| TCPDAM_DEBUG | -d | Show all information |
| TCPDAM_VERBOSE | -v | Show some information |
| TCPDAM_PIDFILE | -p | File which will contain the pid of the dam |
| TCPDAM_CTRLSOCKET | -ctrl-socket | Unix socket to control the dam |
| TCPDAM_MAX_FLUSHING | -max-flushing | Max number of open remote connections |
| TCPDAM_MAX_PARKED | -max-parked | Max number of connections in the queue |
| TCPDAM_OPEN | -open | Start the dam open |
| -c | command to send to a running dam |
| Command | Description |
|---|---|
| open | open the dam unless already open |
| close | close the dam unless already closed |
| set-remote HOST:PORT | switch the remote address, will be used at the next open |
You need to configure your maximum number of file descriptor to allow a high number of parked connections
- debian : configure /etc/security/limits.conf
- docker : docker run --ulimit nofile=100000:100000
- compose : see docker-compose.yml
TODO
TODO
To run the dam
docker run -p 9999:9999 --rm -ti --name tcpdam_test simkim/tcpdam tcpdam -r google.com:80
To open the dam
docker exec tcpdam_test killall -USR1 tcpdam
To open the dam, wait for connections to terminate and quit
docker stop tcpdam_test
Edit docker-compose.yml
docker run -v `pwd`/build:/go/bin -v `pwd`:/go/src/github.com/simkim/tcpdam --rm golang go get github.com/simkim/tcpdam/...
docker-compose build
docker-compose up