raptorizer68 / gun

Toy gRPC Tunnel over CloudFlare (Proof of Concept)

gun

You know what it means.

Guide

Server

1. Go to your domain in CloudFlare. In "Network" tab, turn on gRPC.

2. In "SSL/TLS" tab, choose "Source Servers" sub tab. Create a new certificate and save as cert.pem and cert.key.

3. In "DNS" Tab, add a record pointing to your own server. Make sure the proxy state is "Proxied".

4. Run and persist this on your server. This example will forward the inbound traffic to 127.0.0.1:8899.

gun -mode server -local :443 -remote 127.0.0.1:8899 -cert cert.pem -key cert.key

5. If you are using a TLS termination proxy, you can set -cleartext parameter to use HTTP/2 Cleartext transport protocol.

Client

1. Assume the domain of server is grpc.example.com.

2. Run locally and persist. This will tunnel connections from 127.0.0.1:8899 to remote.

gun -mode client -local 127.0.0.1:8899 -remote grpc.example.com:443

There's also a SIP003 plugin version, see it's document for instruction.

License

Used to be AGPL3 Relicensed to MIT License.