just1689/just-tunnel repository overview

⁠Just Tunnel

A tool to tunnel one or more TCP endpoints over HTTP. This is best used behind a HTTPS reverse proxy.

⁠History

This project is based on a fork of a fork. Based originally on nf/gohttptun⁠ (Andrew Gerrand [email protected]⁠) and later forked & maintained at xuiv/gohttptun⁠ (Polaris Young).

While I liked these projects there were a few things I wanted to add.

⁠Features planned

• Separate things by /context
• Admin /context
• Remote adding of targets
• Security key
• Websocket support
• WS fail-over to http polling
• Declarative config file support for client
• Declarative config file support for server
• Dockerfile for server
• Go mod & support for embedding.

⁠Features completed

⁠Previous docs

Example usage:

Run 'server' at your endpoint, by default it listens on port 8080. ./server -http=:8080

Run 'client' on your local machine, by default it listens locally on 2222. Use -http=serverAddress:8080 to point to your server, and -dest=destAddr:destPort to point to your tunnel endpoint (default is -dest=127.0.0.1:22 to connect to local sshd on the server). ./client -http=serverAddress:8080

With both of them running (you must start server first), you can then connect via ssh to localhost:2222 on the local machine: ssh -p 2222 [email protected]

You should then be tunnelling SSH over HTTP. Pretty neat, huh?