web3pi-tunnel 0.1

Description:

web3pitunnel 0.1

WEb3Pi Tunnel
PoC Python implementation of a basic TCP tunnel. Primary purpose: provide a public IP to clients behind NATs.
It was initially developed alongside the Web3Pi Proxy.
There are two parts of the tunnel: the server which accepts connections from external users and forwards
to the client, and the client which forwards connections further to a target service.
Configure and Run
Setup
Simply install web3pi-tunnel package using your Python package manager, using pip for example:
pip install web3pi-tunnel

Configuration
Create the .env file or set the system environments with the following entries.
Server

SERVICE_PUBLIC_IP - the network address of the tunnel server
SERVICE_PUBLIC_LISTEN_PORT - the port of tunnel server for external web3 users
TUNNEL_ESTABLISH_PORT - the port of the tunnel server for the tunnel client
PROXY_ESTABLISH_PORT - the port of the tunnel server for stats
TUNNEL_SERVICE_AUTH_KEY - the api key to authenticate the tunnel client, any random character string
USE_UPNP - should the tunnel server use UPnP for the service, default value is False, may be set to True, optional

The example of the .env file
SERVICE_PUBLIC_IP=127.0.0.1
SERVICE_PUBLIC_LISTEN_PORT=6512
TUNNEL_ESTABLISH_PORT=7634
PROXY_ESTABLISH_PORT=7835
TUNNEL_SERVICE_AUTH_KEY=aaa

Client

TUNNEL_SERVICE_HOST - the network address of the tunnel server
CLIENT_SERVICE_HOST - the network address of the client target service
CLIENT_SERVICE_PORT - the port of the client target service
TUNNEL_ESTABLISH_PORT - the port of the tunnel server
TUNNEL_SERVICE_AUTH_KEY - the api key to authenticate the tunnel client, any random character string

The example of the .env file
TUNNEL_SERVICE_HOST=127.0.0.1
CLIENT_SERVICE_HOST=127.0.0.1
CLIENT_SERVICE_PORT=8545
TUNNEL_ESTABLISH_PORT=7634
TUNNEL_SERVICE_AUTH_KEY=aaa

Run
Server
Execute the command
web3pi_tunnel_server

Client
Execute the command
web3pi_tunnel_client