sclient.js/README.md

84 lines
1.4 KiB
Markdown
Raw Normal View History

2018-08-06 18:27:33 +00:00
sclient.js
==========
Secure Client for exposing TLS (aka SSL) secured services as plain-text connections locally.
Also ideal for multiplexing a single port with multiple protocols using SNI.
Unwrap a TLS connection:
2018-08-06 18:27:33 +00:00
```bash
$ sclient whatever.com:443 localhost:3000
> [listening] whatever.com:443 <= localhost:3000
2018-08-06 18:27:33 +00:00
```
Connect via Telnet
```bash
$ telnet localhost 3000
```
Connect via netcat (nc)
```bash
2018-08-06 22:50:15 +00:00
$ nc localhost 3000
2018-08-06 18:27:33 +00:00
```
cURL
```bash
$ curl http://localhost:3000 -H 'Host: whatever.com'
```
A poor man's (or Windows user's) makeshift replacement for `openssl s_client`, `stunnel`, or `socat`.
2018-08-06 18:27:33 +00:00
Install
=======
### macOS, Linux, Windows
First download and install the *current* version of [node.js](https://nodejs.org)
```bash
npm install -g sclient
```
```bash
npx sclient example.com:443 localhost:3000
```
Usage
=====
```bash
sclient <remote> <local> [-k | --insecure]
```
* remote
* must have servername (i.e. example.com)
* port is optional (default is 443)
* local
* address is optional (default is localhost)
* must have port (i.e. 3000)
Examples
========
2018-08-06 18:30:29 +00:00
Bridge between `telebit.cloud` and local port `3000`.
2018-08-06 18:27:33 +00:00
```bash
sclient telebit.cloud 3000
```
2018-08-06 18:30:29 +00:00
Same as above, but more explicit
2018-08-06 18:27:33 +00:00
```bash
sclient telebit.cloud:443 localhost:3000
```
2018-08-06 18:30:29 +00:00
Ignore a bad TLS/SSL/HTTPS certificate and connect anyway.
2018-08-06 18:27:33 +00:00
```bash
sclient badtls.telebit.cloud:443 localhost:3000 -k
```