xref: /aosp_15_r20/external/libwebsockets/minimal-examples/raw/minimal-raw-proxy/README.md (revision 1c60b9aca93fdbc9b5f19b2d2194c91294b22281)
1*1c60b9acSAndroid Build Coastguard Worker# lws minimal ws server raw proxy
2*1c60b9acSAndroid Build Coastguard Worker
3*1c60b9acSAndroid Build Coastguard WorkerThis demonstrates how a vhost can be bound to a specific role and protocol,
4*1c60b9acSAndroid Build Coastguard Workerwith the example using a lws plugin that performs raw packet proxying.
5*1c60b9acSAndroid Build Coastguard Worker
6*1c60b9acSAndroid Build Coastguard WorkerBy default the example will proxy 127.0.0.1:22, usually your ssh server
7*1c60b9acSAndroid Build Coastguard Workerlisten port, on 127.0.0.1:7681.  You should be able to ssh into port 7681
8*1c60b9acSAndroid Build Coastguard Workerthe same as you can port 22.  But your ssh server is only listening on port 22...
9*1c60b9acSAndroid Build Coastguard Worker
10*1c60b9acSAndroid Build Coastguard Worker## build
11*1c60b9acSAndroid Build Coastguard Worker
12*1c60b9acSAndroid Build Coastguard WorkerTo build this standalone, you must tell cmake where the lws source tree
13*1c60b9acSAndroid Build Coastguard Worker./plugins directory can be found, since it relies on including the source
14*1c60b9acSAndroid Build Coastguard Workerof the raw-proxy plugin.
15*1c60b9acSAndroid Build Coastguard Worker
16*1c60b9acSAndroid Build Coastguard Worker```
17*1c60b9acSAndroid Build Coastguard Worker $ cmake . -DLWS_PLUGINS_DIR=~/libwebsockets/plugins && make
18*1c60b9acSAndroid Build Coastguard Worker```
19*1c60b9acSAndroid Build Coastguard Worker
20*1c60b9acSAndroid Build Coastguard Worker## usage
21*1c60b9acSAndroid Build Coastguard Worker
22*1c60b9acSAndroid Build Coastguard WorkerCommandline option|Meaning
23*1c60b9acSAndroid Build Coastguard Worker---|---
24*1c60b9acSAndroid Build Coastguard Worker-d <loglevel>|Debug verbosity in decimal, eg, -d15
25*1c60b9acSAndroid Build Coastguard Worker-r ipv4:address:port|Configure the remote IP and port that will be proxied, by default ipv4:127.0.0.1:22
26*1c60b9acSAndroid Build Coastguard Worker
27*1c60b9acSAndroid Build Coastguard Worker```
28*1c60b9acSAndroid Build Coastguard Worker $ ./lws-minimal-raw-proxy
29*1c60b9acSAndroid Build Coastguard Worker[2018/11/30 19:22:35:7290] USER: LWS minimal raw proxy | nc localhost 7681
30*1c60b9acSAndroid Build Coastguard Worker[2018/11/30 19:22:35:7291] NOTICE: Creating Vhost 'default' port 7681, 1 protocols, IPv6 off
31*1c60b9acSAndroid Build Coastguard Worker[2018/11/30 19:22:35:7336] NOTICE: callback_raw_proxy: onward ipv4 127.0.0.1:22
32*1c60b9acSAndroid Build Coastguard Worker...
33*1c60b9acSAndroid Build Coastguard Worker```
34*1c60b9acSAndroid Build Coastguard Worker
35*1c60b9acSAndroid Build Coastguard Worker```
36*1c60b9acSAndroid Build Coastguard Worker $ ssh -p7681 [email protected]
37*1c60b9acSAndroid Build Coastguard WorkerLast login: Fri Nov 30 19:29:23 2018 from 127.0.0.1
38*1c60b9acSAndroid Build Coastguard Worker[me@learn ~]$
39*1c60b9acSAndroid Build Coastguard Worker```
40*1c60b9acSAndroid Build Coastguard Worker
41*1c60b9acSAndroid Build Coastguard Worker
42