README.md

Tunnel

A minimal ngrok-like tool that exposes local servers to the public internet via websocket tunnels.

Steps to setup servers:

Start server:

go run main.go

Build client:

cd ./cli
go build -o tunnel ./

Start client - gives public URL

./tunnel --port 3000 #local server port

Start test server or use any local server:

cd ./test-server
go run main.go

Test tunnel:

curl [Public URL]

Demo:

Start the server, build the client, and expose the localhost port:

Screen.Recording.2025-10-07.at.2.58.26.AM.mov

Run test server and hit the request:

Screen.Recording.2025-10-07.at.2.59.03.AM.mov