Fast and secure tunnels over HTTP/2.
Go HTTP tunnel is a reverse tunnel based on HTTP/2. It enables you to share your localhost when you don't have a public IP.
Features:
Alternatively download the latest release.
Tunnel requires TLS certificates for both client and server.
Run client:
Run server:
This will run HTTP server on port
Sample configuration that exposes:
Configuration options:
The tunnel is based HTTP/2 for speed and security. There is a single TCP connection between client and server and all the proxied connections are multiplexed using HTTP/2.
from https://github.com/mmatczuk/go-http-tunnel
Features:
- HTTP proxy with basic authentication
- TCP proxy
- Client auto reconnect
- Client management and eviction
- Easy to use CLI
- Hosting a game server from home
- Developing webhook integrations
- Managing IoT devices
Installation
Build the latest version.$ go get -u github.com/mmatczuk/go-http-tunnel/cmd/...
(运行此命令后,将会在$GOPATH/bin/里面生成tunnel,tunneld这2个可执行文件)
Running
There are two executables:tunneld- the tunnel server, to be run on publicly available host like AWS or GCEtunnel- the tunnel client, to be run on your local machine or in your private network
tunneld -h or tunnel -h.Tunnel requires TLS certificates for both client and server.
$ openssl req -x509 -nodes -newkey rsa:2048 -sha256 -keyout client.key -out client.crt
$ openssl req -x509 -nodes -newkey rsa:2048 -sha256 -keyout server.key -out server.crt
- Install
tunnelbinary - Make
.tunneldirectory in your project directory - Copy
client.key,client.crtto.tunnel - Create configuration file
tunnel.ymlin.tunnel - Start all tunnels
$ tunnel -config ./tunnel/tunnel.yml start-all
- Install
tunneldbinary - Make
.tunnelddirectory - Copy
server.key,server.crtto.tunneld - Start tunnel server
$ tunneld -tlsCrt .tunneld/server.crt -tlsKey .tunneld/server.key
80 and HTTPS (HTTP/2) server on port 443. If you want to use HTTPS it's recommended to get a properly signed certificate to avoid security warnings.Configuration
The tunnel clienttunnel requires configuration file, by default it will try reading tunnel.yml in your current working directory. If you want to specify other file use -config flag.Sample configuration that exposes:
localhost:8080aswebui.my-tunnel-host.com- host in private network for ssh connections
server_addr: SERVER_IP:5223
tunnels:
webui:
proto: http
addr: localhost:8080
auth: user:password
host: webui.my-tunnel-host.com
ssh:
proto: tcp
addr: 192.168.0.5:22
remote_addr: 0.0.0.0:22
server_addr: server TCP address, i.e.54.12.12.45:5223tls_crt: path to client TLS certificate, default:client.crtin the config file directorytls_key: path to client TLS certificate key, default:client.keyin the config file directoryroot_ca: path to trusted root certificate authority pool file, if empty any server certificate is acceptedtunnels / [name]proto: tunnel protocol,httportcpaddr: forward traffic to this local port number or network address, forproto=httpthis can be full URL i.e.https://machine/sub/path/?plus=params, supports URL schemeshttpandhttpsauth: (proto=http) (optional) basic authentication credentials to enforce on tunneled requests, formatuser:passwordhost: (proto=http) hostname to request (requires reserved name and DNS CNAME)remote_addr: (proto=tcp) bind the remote TCP address
backoffinterval: how long client would wait before redialing the server if connection was lost, exponential backoff initial interval, default:500msmultiplier: interval multiplier if reconnect failed, default:1.5max_interval: maximal time client would wait before redialing the server, default:1mmax_time: maximal time client would try to reconnect to the server if connection was lost, set0to never stop trying, default:15m
How it works
A client opens TLS connection to a server. The server accepts connections from known clients only. The client is recognized by its TLS certificate ID. The server is publicly available and proxies incoming connections to the client. Then the connection is further proxied in the client's network.The tunnel is based HTTP/2 for speed and security. There is a single TCP connection between client and server and all the proxied connections are multiplexed using HTTP/2.
from https://github.com/mmatczuk/go-http-tunnel