DEPRECATED

⚠️ This repository is deprecated.

Please use nport instead. It's the newer version with improved features and better stability.

---

Npm

Normal install

npm install git+https://github.com/tuanngocptn/socket-tunnel.git

Global install

npm install -g git+https://github.com/tuanngocptn/socket-tunnel.git

How to use

Short way (with normal install)

npx st --sub xxx.st -p 3000 # https://xxx.st.lbtvip.pro

Short way (with global install)

st --sub xxx.st -p 3000 # https://xxx.st.lbtvip.pro

Full script (with normal install)

npx st --server https://st.lbtvip.pro --subdomain xxx.st --hostname 127.0.0.1 --port 3000 # https://xxx.st.lbtvip.pro

Full script (with global install)

st --server https://st.lbtvip.pro --subdomain xxx.st --hostname 127.0.0.1 --port 3000 # https://xxx.st.lbtvip.pro

socket-tunnel

Tunnel HTTP connections via socket.io streams. Inspired by localtunnel.

Blog Post

Read all about it

Server Usage

1. Clone this repo and cd into it
2. docker build -t socket-tunnel .
3. docker run -d -p 80:3000 --restart=always --name st-server socket-tunnel
4. Get a domain name (i.e. YOURDOMAIN.com)
5. Point your domain name's root A record at your server's IP
6. Point a wildcard (*) A record at your server's IP

Client CLI Usage

1. Start your http server that you'd like to expose to the public web (in this example we'll assume it's listening on 127.0.0.1:8000)
2. Clone this repo and cd into it
3. npm i
4. node bin/client --server http://YOURDOMAIN.com --subdomain YOURSUBDOMAIN --hostname 127.0.0.1 --port 8000
5. Browse to http://YOURSUBDOMAIN.YOURDOMAIN.com to see your local service available on the public internet

Client API Usage

Assuming a web server running on 127.0.0.1:8000

1. Clone this repo into your project
2. npm i
3. In your project file, require the socket-tunnel api and call connect():

const socketTunnel = require('./socket-tunnel/lib/api');

socketTunnel.connect('http://YOURDOMAIN.com', 'YOURSUBDOMAIN', '8000')
  .then(console.log)
  .catch(console.log);

4. Browse to http://YOURSUBDOMAIN.YOURDOMAIN.com to see your local service available on the public internet

Client API Parameters

socketTunnel.connect(remoteServer, desiredSubdomain, localPort, localHostname) returns a promise which resolves to the requested URL/subdomain.

Property	Default	Description
remoteServer	n/a	IP address or hostname of the socket-tunnel server
desiredSubdomain	n/a	Subdomain to request for this client
localPort	n/a	Local port to tunnel to
localHostname	'127.0.0.1'	Local host to tunnel to

Credits

Created by Eric Barch. Additional code provided by these generous contributors.

License

This project is licensed under the MIT License - see the LICENSE file for details