Skip to content

shanecurran/tls-tunnel

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

tls-tunnel

Rust TLS over TCP tunnel

Crates.io docs.rs MIT licensed

This simple crate establishes a TLS connection to a specified target and creates a TCP server that allows you to communicate with the TLS server over a raw, unencrypted TCP socket.

This is useful for environments where TLS connections are not feasible at runtime. Some examples:

  • Using a CONNECT proxy from a language that doesn't support CONNECT-over-TLS.
  • Legacy runtimes which do not support HTTPS but do support HTTP.
  • Interoperability of legacy VoIP, IRC or FTP clients which do not support TLS with servers which do.

Install

Simply download and compile the Rust binary using cargo install:

$ cargo install tls-tunnel

Run

Pass the target host and port as an argument when running using cargo or the compiled binary. If not provided, the tunnel will default to httpbin.org:443 for demo purposes.

$ tls-tunnel https://httpbin.org

The server will automatically choose a port to listen on. It defaults to port 1025 and will increment by one until it finds an available port to bind to.

About

Exposes a TLS connection over a raw, unencrypted TCP socket.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages