https://github.com/darvid/emissary

A TCP service multiplexer
https://github.com/darvid/emissary

golang golang-application multiplexer networking routing tcp-service-multiplexer

Last synced: about 1 month ago
JSON representation

A TCP service multiplexer

• Host: GitHub
• URL: https://github.com/darvid/emissary
• Owner: darvid
• License: mit
• Created: 2017-01-14T03:47:24.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2017-05-04T13:54:12.000Z (over 7 years ago)
• Last Synced: 2024-06-20T14:21:46.906Z (6 months ago)
• Topics: golang, golang-application, multiplexer, networking, routing, tcp-service-multiplexer
• Language: Go
• Size: 7.81 KB
• Stars: 17
• Watchers: 4
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# emissary: A TCP service multiplexer

[![Coveralls](https://img.shields.io/coveralls/darvid/emissary.svg)](https://coveralls.io/github/darvid/emissary) [![Go Report Card](http://goreportcard.com/badge/github.com/darvid/emissary)](https://goreportcard.com/report/github.com/darvid/emissary) [![Travis](https://img.shields.io/travis/darvid/emissary.svg)](https://travis-ci.org/darvid/emissary)

[![asciicast](https://asciinema.org/a/99252.png)](https://asciinema.org/a/99252)

**emissary** provides a command to multiplex TCP services on the same port,

and route connections to different upstream addresses based on their starting

bytes.

Upstreams are configured through *upstream rules*, which are a simple

regexp/remote address pair.

## Installation

### With go get

```shell

$ go get github.com/darvid/emissary

```

### Binaries

The latest releases can be downloaded from

[Github](https://github.com/darvid/emissary/releases).

### From source

```shell

$ git clone https://github.com/darvid/emissary.git

$ cd emissary

# Requires Glide to be installed - https://glide.sh/

$ glide install

$ make build

```

## Examples

```shell

# Forward all HTTP GET requests to httpbin.org

$ emissary -bind localhost:1080 -upstream '/^GET/:httpbin.org:80'

# Forward SOCKS5 traffic to a local SOCKS5 server

$ emissary -bind localhost:1080 -upstream '/^\x05/:localhost:1081'

```

Any number of upstreams may be chained together.

## Usage

    Usage of emissary:

      -alsologtostderr

            log to standard error as well as files

      -bind string

            bind address (default "localhost:1080")

      -buffersize int

            buffer size for first read (default 4096)

      -log_backtrace_at value

            when logging hits line file:N, emit a stack trace (default :0)

      -log_dir string

            If non-empty, write log files in this directory

      -logtostderr

            log to standard error instead of files

      -stderrthreshold value

            logs at or above this threshold go to stderr

      -upstream value

            list of upstream rules (default [])

      -v value

            log level for V logs

      -version

            show version

      -vmodule value

            comma-separated list of pattern=N settings for file-filtered logging

# Similar projects

A few projects exist that provide TCP service muxing. The ones mentioned below

are libraries which require writing custom applications or scripts, which may be

preferential to some, depending on the use case.

* [Emissary](https://github.com/craSH/Emissary)

* [node-port-mux](https://github.com/robertklep/node-port-mux)

* [cmux](https://github.com/soheilhy/cmux)