Skip to content
A multi-connection TCP forwarder/accelerator
Go Makefile Dockerfile
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Add version when build; Remove debug info from docker image. Oct 14, 2019
block
client
cmd
connection Implement SetTimeout for InboundConnection. Oct 17, 2019
connection_pool Disable connection creation on client side. Oct 25, 2019
logger
peer Disable connection creation on client side. Oct 25, 2019
server
tunnel Alpha version finished. Oct 12, 2019
tunnel_pool Disable connection creation on client side. Oct 25, 2019
.gitignore
Dockerfile Add version when build; Remove debug info from docker image. Oct 14, 2019
LICENCE Update document. Oct 15, 2019
Makefile
README.MD
README_ZH.MD
docker-compose-client.yml Update document. Oct 15, 2019
docker-compose-server.yml Update document. Oct 15, 2019

README.MD

Rabbit TCP

Build badge Docker pull badge

A multi-connection TCP forwarder created for accelerating TCP connections

English | 中文

Introduction

This project is created to support and forward TCP connections. It will split bytes into blocks and reconstruct them during forwarding. All upper connections visible to all users are carried by N underlying physical connections, and even a single upper connection is forwarded through all underlying connections.

Due to the use of multiple connections, similar to the multi-threaded downloader, this project can accelerate the connection without any more traffic consumption (bilateral deployment is required). This project the extension of the accelerating method of ShadowSocks-magic.

Rabbit TCP

Get Started

This project can work in standalone proxy mode or inline in other Golang code.

Here are two common usage examples. For detailed documentation, please go to the Wiki.

Accelerate any TCP service in a standalone proxy mode

Server side

  1. Install Docker and docker-compose
  2. Download and edit docker-compose-server.yml (Link)
    rabbit-server:
      image: ihciah/rabbit
      ports:
        - "$RABBIT_PORT:9891/tcp"
      environment:
        - MODE=s
        - PASSWORD=$RABBIT_PASSWORD
        - RABBITADDR=:9891
        - VERBOSE=2
      restart: always
    • $RABBIT_PORT replaced with RabbitTCP service port, which should be the same as the client side
    • $RABBIT_PASSWORD replaced with RabbitTCP service password, which should be the same as the client side
  3. Run in the same directory docker-compose -f docker-compose-server.yml up -d

Client side

  1. Install Docker and docker-compose
  2. Download and edit docker-compose-client.yml (Link)
    rabbit-client:
      image: ihciah/rabbit
      ports:
        - "$CLIENT_LISTEN_PORT:9892/tcp"
      environment:
        - MODE=c
        - PASSWORD=$RABBIT_PASSWORD
        - RABBITADDR=$RABBIT_ADDR
        - LISTEN=:9892
        - DEST=$SERVICE_ADDR
        - TUNNELN=6
        - VERBOSE=2
      restart: always
    • $RABBIT_ADDR replaced with ip_or_domain:port , which should be the same as the server side
    • $RABBIT_PASSWORD replaced with RabbitTCP service password, which should be the same as the server side
    • $SERVICE_ADDR replaced with the ip_or_domain:port of the target service
    • $CLIENT_LISTEN_PORT replaced with local listen port, which can be dialed when connecting to the target service with acceleration.
    • Modify TUNNELN if you want to change count of physical connections
  3. Run in the same directory docker-compose -f docker-compose-server.yml up -d

Accelerate ShadowSocks service in a standalone proxy mode with plugin

The server-side configuration is the same as above. Please note that except for Rabbit TCP server, you have to run ShadowSocks service too.

Configure client-side as above is useful too if you want to run a forwarder on a server inside the blocked area.

However, run docker or daemon service on client devices is not so user-friendly. What recommended is the plugin built for ShadowSocks: Rabbit Plugin.

  1. Download the latest Rabbit Plugin release, unzip it and put it into the ShadowSocks folder(same as ShadowSocks.exe).
  2. Fill in ShadowSocks client configuration(Take ShadowSocks Windows as an example)
    • Server Addr: Rabbit TCP service ip/domain
    • Server Port: Rabbit TCP service port
    • Password: ShadowSocks password
    • Encryption: ShadowSocks Encryption
    • Plugin Program: The binary filename(without .exe)
    • Plugin Options: serviceAddr=SHADOWSOCKS_ADDR;password=RABBIT_PASSWORD;tunnelN=4
      • SHADOWSOCKS_ADDR is ShadowSocks server address(ip:port or domain:port), for example: 10.10.10.10:443
      • RABBIT_PASSWORD is Rabbit TCP password
      • Modify tunnelN to change count of physical connections
  3. Save

Speedup Result

Environment:

  • Chrome <--> ShadowsocksWindows <--> RabbitTCP <==[ISP]==> RabbitTCP <--> ShadowsocksLibev
  • Local ISP: China Unicom - Shanghai
  • Remote ISP: Amazon LightSail - Tokyo
  • Physical Connections Count: 4

Speedup with Rabbit TCP(Link):

Speed with rabbit-tcp

Original ShadowSocks libev(Link):

Speed without rabbit-tcp

You can’t perform that action at this time.