node-httptunnel

node-httptunnel a didirectional data stream tunnelled in standard HTTP requests (GET/PUT/POST/DELETE) written in node js.

This is a proof of concept, use it at your own risks

It supports mTLS between client and server or client -> reverse-proxy / reverse-proxy -> server. Useful to use non HTTP protocols (like ssh) through an HTTP reverse proxy (like otoroshi).

Install dependencies

yarn install

Test it with ssh

For the following example let say we want to tunnel an ssh connection from machine A to machine B using only HTTP.

On machine A (the client)

node src/client.js --remote 'http://xxx.xxx.xxx.xxx:8080' --port 2222

the client command supports the following options :

debug: display debug logs
remote: remote server url
address: forwarded address, by default 127.0.0.1
port: forwarded port, by default 2222
retries: number of retries when http error occurs, by default 3
caPath: path for a ca cert file
certPath: path for a client cert file
keyPath: path for a client cert key file

On machine B (the server)

node src/client.js --port 8080 --targetPort 22

the server command supports the following options :

debug: display debug logs
port: http port, default is 8080;
target: target host and port, default is '127.0.0.1:22'
timeout: timeout in ms before releasing a read bytes connection, default is 10000;
caPath: path for a ca cert file
certPath: path for a client cert file
keyPath: path for a client cert key file
requestCert: request client cert
rejectUnauthorized: reject non client cert requests

Then on machine A again (the client)