Skip to content

Commit deedac4

Browse files
committed
docs(readme): init readme
1 parent 9722870 commit deedac4

File tree

1 file changed

+82
-0
lines changed

1 file changed

+82
-0
lines changed

README.md

Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
## vex
2+
3+
Vex is a reverse HTTP proxy tunnel via secure SSH connections. It is compatible with `ssh` client.
4+
5+
### Establish tunnel via running vex server on bleenco.space
6+
7+
Let's say you are running HTTP server locally on port 6500, then command would be:
8+
9+
```sh
10+
ssh -R 10100:localhost:6500 bleenco.space -p 2200
11+
```
12+
13+
where 10100 is randomly picked port to bind SSH listener on server to establish tunnels. You should pick that random and don't use 10100 if not free.
14+
15+
2200 is port where vex daemon (server) is running and localhost:6500 is local HTTP server.
16+
17+
Example output:
18+
19+
```sh
20+
$ ssh -R 10500:localhost:6500 bleenco.space -p 2200
21+
[vexd] Generated URL: http://23c41c01.bleenco.space
22+
```
23+
24+
Then open generated URL in the browser to check if works, then share the URL if needed.
25+
26+
### Run cross-compilation build
27+
28+
```sh
29+
make clean && make build
30+
```
31+
32+
### Running server
33+
34+
```sh
35+
./build/vex-server-linux_amd64 --help
36+
```
37+
38+
```
39+
Usage: vexd [options]
40+
41+
Options:
42+
43+
-d, Domain name that HTTP server is hosted on. It is
44+
used for generating subdomain IDs (defaults to the
45+
environment variable VEX_DOMAIN and falls back to local.net)
46+
47+
-k, Path to file of a ECDSA private key. All SSH communication
48+
will be secured using this key (defaults to the VEX_KEY environment
49+
variable falls back to id_rsa)
50+
51+
-s, SSH server listen address (defaults to VEX_SSH_SERVER and
52+
falls back to 0.0.0.0:2200)
53+
54+
-http, HTTP server listen address (defaults to VEX_HTTP_SERVER and
55+
falls back to 0.0.0.0:2000)
56+
```
57+
58+
### Licence
59+
60+
```
61+
The MIT License
62+
63+
Copyright (c) 2018 Bleenco GmbH https://bleenco.com
64+
65+
Permission is hereby granted, free of charge, to any person obtaining a copy
66+
of this software and associated documentation files (the "Software"), to deal
67+
in the Software without restriction, including without limitation the rights
68+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
69+
copies of the Software, and to permit persons to whom the Software is
70+
furnished to do so, subject to the following conditions:
71+
72+
The above copyright notice and this permission notice shall be included in
73+
all copies or substantial portions of the Software.
74+
75+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
76+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
77+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
78+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
79+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
80+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
81+
THE SOFTWARE.
82+
```

0 commit comments

Comments
 (0)