Skip to content
21st century, multi-purpose relay from source to destination
Go
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/workflows
assets
cmd
internal
.gitignore
.go-version
.golangci.yml
CHANGELOG.md
CODEOWNERS
CODE_OF_CONDUCT.md
CONTRIBUTING.md
LICENSE
README.md
RELEASE_PROCESS.md
go.mod
go.sum
mage.go
magefile.go
main.go
main_e2e_test.go

README.md

gocat

Faster Golang alternative of socat.

Multi-purpose relay from source to destination.

A relay is a tool for bidirectional data transfer between two independent data channels.

Supported source-to-destination relays:

  • TCP to Unix,
  • Unix to TCP.
  • Need something else? Feel free to open an issue to discuss it or shoot a Pull Request.

Why?

  • Significantly faster than socat with medium and larger message payloads.
  • Static binary, it just works. TM
  • Actively health checks the source to prevent hanging/zombified source connections. (initial reason why socat didn't work for us)

Why not?

  • socat performs slightly better with small message payloads.

Where it's used?

At SumUp we use it as a backbone for infrastructure and deployment system(s) that:

  • need to relay SSH protocol,
  • proxy to TCP -> Unix or vice-versa where speed
  • have reliability as an important concern.

As a now open-source project of SumUp, we hope that we find more use-cases together.

Benchmarks

How the benchmarks work

Benchmarks are sending a message from the destination, relaying via gocat/socat to the source, which is an echo server that relays back to the destination via gocat/socat.

Reading the benchmarks

X axis is the message payload size.

Y axis is throughput as per golang test's -count argument, which benchmarks only the sending and receiving of a message sync or async.

TCP to UNIX

tcp-to-unix

Unix to TCP

unix-to-tcp

Benchmarking mistakes?

Think we can improve them or got something wrong? Feel free to open an issue to discuss it.

We want the best possible benchmark and opportunity to improve the software!

Configuration

Check out config.go

Usage

Unix Domain Socket to TCP

Example SSH agent forwarding

gocat

> gocat unix-to-tcp --src /run/ssh-agent.socket --dst 0.0.0.0:56789

socat

# NOTE: `-d -d -d` is to reach at least some level of verbosity
> socat -d -d -d TCP-LISTEN:56789,reuseaddr,fork UNIX-CLIENT:/run/ssh-agent.socket

TCP to Unix Domain Socket

Example TCP to ssh-agent socket forwarding

gocat

> gocat tcp-to-unix --src 0.0.0.0:56789 --dst /tmp/sshagent.sock

socat

# NOTE: `-d -d -d` is to reach at least some level of verbosity
> socat -t 100000 -v UNIX-LISTEN:/tmp/sshagent.sock,unlink-early,mode=777,fork TCP:0.0.0.0:56789

Contributing

Check out CONTRIBUTING.md

Code of conduct (CoC)

We want to foster an inclusive and friendly community around our Open Source efforts. Like all SumUp Open Source projects, this project follows the Contributor Covenant Code of Conduct. Please, read it and follow it.

If you feel another member of the community violated our CoC or you are experiencing problems participating in our community because of another individual's behavior, please get in touch with our maintainers. We will enforce the CoC.

About SumUp

SumUp logo

It is our mission to make easy and fast card payments a reality across the entire world. You can pay with SumUp in more than 30 countries, already. Our engineers work in Berlin, Cologne, Sofia and Sāo Paulo. They write code in JavaScript, Swift, Ruby, Go, Java, Erlang, Elixir and more. Want to come work with us? Head to our careers page to find out more.

You can’t perform that action at this time.